Agent 系统规则本目录是 PM(Hermes)与用户讨论后定下的"多 agent 协作开发系统"的规则文档。每条规则有来龙去脉、可执行细节、决策记录。
📌 怎么用这份文档
这是给 PM(我)用的速查手册,也是给"未来加入的 agent / 工具"看的 on-boarding。任何时候我对规则有疑问,先翻这里。每次拍板新决定,我会追加到
09-decisions.html 并更新相关页。
系统目标
在云端 Linux 服务器上,7×24 跑一个多 agent 协作开发系统,由 PM(Hermes)调度,各 agent 专职合作,最终产出可用的代码并通过 GitHub PR 流程。用户在关键节点拍板,其余时间后台自动跑。
核心原则
- PM 调度,agent 执行 —— 我(PM)负责理解需求、拆任务、派活、汇报,自己不写代码
- agent 专职化 —— developer / reviewer / merger 各司其职,工具/权限/模型按职责配
- 用户只在关键节点拍板 —— PR review、合/不合、需求歧义时才打扰
- 错误尽量由 PM 自治 —— 瞬时错、编译错、测试错可重试,只有产品/架构/预算问题才升级
- 一切以 GitHub 为真值 —— 代码在 GitHub 上,PR 状态即任务状态,本地只是缓存
文档导航
01 · 架构
多 agent 协作拓扑、数据流、共享层
02 · 角色职责
PM / Developer / Reviewer / Merger 的权限边界
03 · 迭代 / 任务
1 迭代 = 1 PR,迭代可拆 task,worktree 隔离
04 · 通讯协议
PM ↔ agent 的话术模板、字段约定
05 · 错误处理
哪些错 PM 自己修、哪些升级到用户
06 · 模型选择
4 个高能力模型怎么用、随机选 reviewer
09 · 拍板记录
所有用户拍板决定的时序记录
当前架构一览
👤 用户
→
PM (Hermes)
→
Developer
→
GitHub PR
→
Reviewer
→
PM
→
👤 拍板
完整拓扑见 01 · 架构。