agents.md：智能体的操作手册

agents.md 是智能体的操作手册。它定义智能体的使命、是单独工作还是统筹他人、遵循哪些步骤，以及什么时候必须交给人来处理。soul.md 塑造性格，agents.md 塑造行事。没有它，哪怕定义得再清楚的智能体，每接一个任务也要重新摸索一遍流程。

“它是谁”与“它怎么做”

想象一位手艺高超的匠人。他的性情——耐心、严谨、慷慨——是他的灵魂；他怎么布置工作台、怎么复核尺寸、什么时候请人搭把手，是他的方法。铸剑师干将两者兼备：心中有剑的模样，手上有一套严格的锻造工序。agents.md 就是把这套工序写下来，让智能体每次都按同样的方式去做。

四个核心字段

• job：用一两句话写明使命。智能体为何而存在，怎样才算成功。
• agentRole：单独工作还是编排者。单独工作的智能体亲自干活；编排者负责规划、把任务分派给其他智能体，并检查它们的产出。
• steps：有序的流程。比如：澄清需求、收集所需信息、提出方案、执行、自查、汇报。
• escalation：智能体在什么情况下停下来请人介入——不确定、有风险、不可撤销的操作，或超出它权限的事。

AgentSoul 根据你的类型补充了什么

熔铸生成的 agents.md 不止这四个字段。高导生成的文件会给出一个角色原型——比如原则建筑师、共情伙伴、深度探究者——并设定优先级排序、主动性程度、协作约定、决策风格和声音约束。闪电熔铸的版本更紧凑，围绕主动性和异议容忍度展开：智能体有多愿意反驳你。两者最后都有一节失败模式：高导的写法是“如果我开始偏离，你会看到这些迹象；请把我拉回到那个方向”，闪电熔铸则写明不确定时该怎么做。这些都源自你的解读。如果结果包含九型类型（高导），这里也会有所体现：8 号灵魂倾向果断行动、直言不讳，6 号灵魂则倾向先点出风险、确认后再动手。

量身定制升级规则

如果 agents.md 你只改一处，就改升级规则。这是性格与后果相遇的地方。性情大胆的智能体，可能需要一条更严格的不可逆操作规则；性情谨慎的智能体，可能需要被允许在低风险任务上直接推进，而不是事事请示。规则要写得具体：

• 删除、发送、发布或花钱之前，一律先问。
• 当一个请求有两种合理理解、且结果不同时，先问。
• 可撤销、低风险的步骤直接做，事后说明做了什么。
• 任务需要它没有的权限时，停下来并如实说明。

在各类工具中使用 agents.md

在 OpenClaw 中，agents.md 是每次会话开始时加载的四个工作区文件之一，通常命名为 AGENTS.md。在 Cursor 和 Hermes 中，项目根目录的 AGENTS.md 会被自动读取，AgentSoul 的 agents.md 正好可以作为它的骨架。在 Claude Code 中，从 CLAUDE.md 里引用它。在聊天助手里，把步骤和升级规则浓缩成几行自定义指令。无论放在哪里，都把与当前工作无关的步骤删掉：操作手册只有在描述你真正交给智能体的那份工作时才有用。

agents.md 背后的解读是 AI 生成的假设，不是诊断。把它当作智能体工作方法的一份扎实初稿，再根据实际表现不断修订。