Harness engineering，
在窗口里完成，而不是在配置文件里
代理能做什么，取决于它的 harness：人设、工具和记忆。AgentsRoom 把它们变成三个独立的控制项，你可以按代理、按任务自由组合。
工具包把技能、MCP 服务器、已保存的连接和环境变量归到一个名字下。把它附加到一个代理、单个工单、一个团队步骤、一个项目或一个客户文件夹。只需编辑一次，所有使用它的代理都会在下次启动时获得改动，Claude Code、Codex 和其他所有代理 CLI 都是如此。
- scan-documents
- summarize
- notes (MCP)
- staging-db
- Claude Code
- Codex
- Antigravity
- Cursor
一个附加到工单的调研工具包：代理在启动时获得它的技能、MCP 服务器和连接，并且只读取项目记忆，不会写入。
Harness engineering（为编程代理设计它周围的运行环境）指的是塑造编程代理周边一切的工作：它读取哪些指令，能调用哪些工具，保留哪些知识。如今这些大多散落在文件里。这里一个 CLAUDE.md，那里一个 mcp.json，每个 CLI 一个技能文件夹，环境变量写在 shell 配置文件中，而且不手动复制的话，没有一样能带到下一个代理或下一个任务。
在 AgentsRoom 中，一个代理由三样分别设置的东西组成。人设决定它是谁。工具包决定它能用什么：技能、MCP 服务器、已保存的 SSH、数据库和开发命令连接、环境变量。记忆设置决定它是否读写共享的项目记忆。改动其中一个，另外两个保持不变。
工具包以引用方式附加，从不复制。一个由文档扫描技能、摘要技能和笔记应用连接组成的调研工具包，可以同时装备一个审查代理、单个工单和整个客户文件夹，对它的任何改进都会传达到所有这些地方。
三个控制项，而不是一份代理定义
给任务能力而不附带人设，保留人设而不带记忆，或者在不同角色下复用同一套工具。
技能、MCP 服务器和连接装进一个工具包
从技能库中挑选技能，选择已保存的 SSH、数据库和开发命令连接，粘贴你已经在用的 MCP 服务器 JSON，再加上环境变量。凭据以 {{secret:NAME}} 引用的形式留在密钥管理器中，在启动时于你的电脑上解析。
以引用方式附加
代理、工单和设置保存的是工具包本身，而不是其内容的副本。只需编辑一次工具包，所有使用它的代理都会在下次启动时获得新的技能和服务器。
覆盖你已经在用的每个层级
可以把工具包附加到一个代理、一个已保存的代理、单个待办工单、代理团队中的一个步骤、整个项目，或一个客户文件夹，其子文件夹还可以追加自己的工具包。
为单个任务提供能力
工单可以带上自己的工具包，而不改变它的代理。这些工具包会叠加在代理自己的工具包之上；当工单的技能模式为“替换”时，则替换掉全部工具包（代理、项目和文件夹）。
记忆与人设分离
按代理把项目记忆设为“关闭”“只读”或“读写”，还可以只为某个工单单独覆盖。“只读”让知识库保持可用，同时不让审查代理改写它。
所有代理 CLI，桌面与手机
技能以文本形式送达每个 CLI，在 Claude Code 和 Antigravity 上还会作为原生技能送达。MCP 服务器按每个 CLI 自己的格式写入。你可以在桌面端或移动应用中创建并附加工具包，也可以让代理通过 AgentsRoom 工具来完成。
一分钟内建好一个工具包
不用编辑文件，也不用手动重启任何东西。
- 1
打开工具包库
点击标题栏中“代理”旁边的公文包图标，或任意工具包字段旁边的“管理”，然后选择“新建工具包”。
- 2
填写内容
给它命名，挑选技能和连接，粘贴 MCP 服务器，添加环境变量。令牌请使用 {{secret:NAME}}。
- 3
附加
在“编辑代理 > 高级选项 > 工具包”、工单、团队步骤、“项目设置 > 能力与权限”或“文件夹设置 > 知识”中附加。
- 4
选择记忆
就在工具包下方，把项目记忆设为“关闭”“只读”或“读写”，或者保持继承。
- 5
启动
代理下次启动时，工具包会展开到它的 CLI 中：技能、服务器、连接和变量，你的仓库里不会写入任何东西。
为什么要把人设、工具和记忆分开
过去，一份代理定义同时承载所有东西。想在另一个角色下复用一套技能和服务器，就得重新搭一遍；而让代理远离项目记忆的唯一办法，是用最简系统提示词连人设一起去掉。
分开之后，这三个控制项能应对真实场景：一个读取记忆但从不写入的审查员，一个需要笔记服务器而它的代理恰好没有的一次性调研工单，一个所有代理都必须连到同一个预发布数据库的客户文件夹，一个只在自己那一轮使用浏览器工具包的团队步骤。
对于不想维护配置文件的人来说，这也是进入 harness engineering 的入口：每个选择都在代理窗口中一目了然，随你的账户同步到其他电脑，一眼就能核查。
须知
- 改动在代理下次启动时生效。已经在运行的会话会保持它启动时的配置。
- 工具包中的项目技能或连接只在其所属项目中生效。账户技能在所有地方生效。
- 工具包属于你的账户。在与同事共享的团队中，每个人启动时只会解析自己的工具包。
- 团队步骤有工具包，但没有记忆设置：对于不能写入任何内容的步骤，请使用该步骤的“只读步骤”开关。
- 每个代理、工单、步骤、项目或文件夹最多 20 个工具包，每个账户最多 200 个。
- 通过 SSH 在远程机器上运行的代理会获得工具包中的技能，但不会获得其中的 MCP 服务器。
常见问题
什么是 harness engineering？
它是一种塑造编程代理所处环境的做法，而不只是打磨提示词：它加载的指令，它能调用的工具和 MCP 服务器，它读写的知识。AgentsRoom 把这些要素做成三个控制项（人设、工具包、记忆），你可以按代理、按任务分别设置。
能在多个代理上复用同一套技能和 MCP 服务器吗？
可以。把它们放进一个工具包，附加到每个代理上，或者附加到项目或文件夹，让其中的所有代理都获得它。编辑工具包后，它们都会在下次启动时更新。
能让单个工单获得它的代理没有的 MCP 服务器吗？
可以。给工单附加一个工具包。这次运行会在代理自己的工具包之外额外获得它，代理已保存的配置不会改变。
如何在不丢掉人设的情况下，阻止代理写入项目记忆？
把它的项目记忆设为“只读”，或设为“关闭”以完全隐藏记忆。人设和工具保持原样。你也可以只在某一个工单上这样设置。
它支持 Codex 和其他代理 CLI 吗，还是只支持 Claude Code？
支持 AgentsRoom 启动的每一个代理 CLI。技能在所有地方以文本形式送达，在 Claude Code 和 Antigravity 上还会作为原生技能送达；MCP 服务器按每个 CLI 自己的配置格式写入；连接和变量无论用哪个 CLI 都会跟着代理走。
我的令牌存放在哪里？
从不存放在工具包里。工具包只保存指向密钥管理器的 {{secret:NAME}} 引用，真正的值在代理启动时于你的电脑上解析。
代理能替我创建工具包吗？
可以，只要你开口。AgentsRoom 工具包括 toolkits_list、toolkits_get、toolkits_save 和 toolkits_delete，而 agents_save、待办工单、团队步骤以及项目或文件夹设置都接受工具包列表。代理被明确告知，绝不能为了给自己开通权限而创建工具包。
你可能还喜欢
Multi-Agent Workflow • Handoff • Feedback Loop
AgentsRoom Agent Teams 把 AI 编码代理串联成一支真正的工程团队。可视化工作流编辑器 (n8n 风格画布) 用来连接 Dev、QA、PM、Security 和 DevOps 角色。自动交接，附带摘要、git diff、风险与测试提示。机器验证的质量门 (由你的测试套件说了算，而不是代理), 并行的 QA 与 Security 审查分支，条件连线，反馈循环，循环上限。按团队选择角色的运行方式：一个代理在角色之间变形并保留全部上下文，或者每个角色一个在线代理，实时互相发消息。这是你在 Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 13 个代理 CLI 上的代理一直缺少的多代理编排器。
MCP 服务器
MCP 服务器只需声明一次，就能交给 Claude Code、Codex 和所有代理 CLI。从官方 MCP 注册表中挑选，把密钥放在密钥管理器里，用一个“连接”按钮登录 Notion、Linear 等 OAuth 服务器。
项目记忆
为您的 AI 编码代理提供长期记忆。决策、架构和陷阱在会话之间持续存在，并与项目中的每个人共享。免费，无限制。
自定义代理
从 14 个内置代理角色中选择，添加来自 The Agency 的专业代理，或构建您自己的自定义 AI 编码代理及其系统提示。然后通过聊天与您的团队分享您的代理，并将其发布到社区，以便每个人共同提升。
密钥管理器
把 API 密钥、令牌和密码存进操作系统钥匙串，在开发命令和代理环境里用 {ref} 引用，交给 AgentsRoom 在启动时解析。代理只看得到名称，看不到值，任何内容都不会同步到服务器。
一次装备好你的代理
在 macOS、Windows 和 Linux 上免费使用，还可以用移动应用在手机上管理工具包。
配套应用：随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。