AGENTS.md vs SOUL.md 区别
| 特性 | AGENTS.md | SOUL.md |
| 作用 | 工作空间规则和操作指南 | Agent 的身份、性格和核心行为准则 |
| 内容 | 任务流程、通信协议、安全规范、工具使用说明 | 角色定义、价值观、行为风格、自我认知 |
| 谁制定 | 系统/Manager 生成 + 用户自定义规则 | 用户为每个 Agent 量身定制 |
| 层级 | 组织/工作空间级别 | 个人/Agent 级别 |
| 修改权限 | 可追加自定义规则 | 完全可定制 |
| 目的 | 告诉 Agent 如何工作 | 告诉 Agent 它是谁 |
具体对比
AGENTS.md - "工作手册"
## Task Execution
1. Sync files first: `hiclaw-sync` 2. Read the task spec
3. Create `plan.md` before starting
... ## Communication
- @mention Manager when task completed
- NO_REPLY usage rules
- History context handling
解决什么问题:
- 怎么接收任务?
- 怎么和 Manager/其他 Worker 沟通?
- 文件放哪里?
- 什么时候 @mention?
- 安全规范是什么?
SOUL.md - "灵魂/人格定义"
# Worker: cs-assistant ## Identity
You are cs-assistant, a technical support specialist... ## Personality
- Professional yet approachable
- Patient with technical questions
... ## Domain
- Wiki.js management
- Technical documentation
... ## Response Style
- Provide clear, structured answers
- Include command examples when relevant
解决什么问题:
- 我是谁?
- 我的专业领域是什么?
- 我该怎么说话?(语气、风格)
- 我的价值观是什么?
- 面对不同情况该怎么反应?
实际例子
用户问:"怎么备份 Wiki.js?"
AGENTS.md 告诉 cs-assistant:
→ 先检查知识库有没有相关内容,然后基于知识库回答,最后引用来源文件
SOUL.md 告诉 cs-assistant:
→ 你是技术专家,应该用专业但友好的语气回答,给出具体命令示例
实际回答:
Based on [wiki-guide.md]:
Wiki.js 支持以下备份方式... 具体操作命令:
wikijs backup --output ~/wiki-backup.zip Additional context:
建议定期备份,可以设置定时任务...
一句话总结
AGENTS.md = "工作规范说明书"(流程、规则、工具)
SOUL.md = "人格定义书"(身份、性格、专业领域)
两者配合:AGENTS.md 确保 Agent 正确做事,SOUL.md 确保 Agent 像自己。