09 · 拍板记录所有用户拍板决定的时序记录,作为规则演化的可追溯历史
每次用户拍板时,PM 在本文件追加一条,标注讨论上下文和最终决策。需要时反向追溯为什么这么定。
当前已拍板
2026-06-19 · 多 agent 架构基础规则
D-001
Reviewer 数量与模型选择
每次只派1 个 reviewer(不是 4 个并行)。reviewer 从
每次只派1 个 reviewer(不是 4 个并行)。reviewer 从
glm-5.2 / minimax-m3 / kimi-k2.7-code 三个里随机选 1 个,且不与 developer 用的 model 相同(developer 默认 deepseek-v4-pro)。
2026-06-19 00:50
D-002
迭代 / 任务分层
1 迭代 = 1 PR(用户最初提议)。迭代可拆成多个 task,每个 task 是一个或一组 commit。
1 迭代 = 1 PR(用户最初提议)。迭代可拆成多个 task,每个 task 是一个或一组 commit。
2026-06-19 00:50
D-003
Worktree 粒度
1 迭代 = 1 worktree(不是 1 task = 1 worktree)。所有 task 在同一个 worktree 里串行 commit。多个 iteration 之间 worktree 物理隔离,可以真并行。
1 迭代 = 1 worktree(不是 1 task = 1 worktree)。所有 task 在同一个 worktree 里串行 commit。多个 iteration 之间 worktree 物理隔离,可以真并行。
2026-06-19 00:50
D-004
ID 命名规范
数字 + slug 格式:
数字 + slug 格式:
iter-NNN-slug、task-NNN-slug、feat/iter-NNN-slug。例:iter-001-login。
2026-06-19 00:50
D-005
Reviewer 双输出
Reviewer 给两路输出:GitHub PR 上留 review comment(给人看)+ 给 PM 结构化 verdict JSON(程序读、做下一步决策)。verdict schema 见 04 · 通讯协议。
Reviewer 给两路输出:GitHub PR 上留 review comment(给人看)+ 给 PM 结构化 verdict JSON(程序读、做下一步决策)。verdict schema 见 04 · 通讯协议。
2026-06-19 00:50
D-006
错误由 PM 自治判断
瞬时错、编译错、测试错 → PM 自动重试。3 次失败再报用户。产品/架构/预算/需求歧义 → 直接报用户,不让 PM 决定。详细分类见 05 · 错误处理。
瞬时错、编译错、测试错 → PM 自动重试。3 次失败再报用户。产品/架构/预算/需求歧义 → 直接报用户,不让 PM 决定。详细分类见 05 · 错误处理。
2026-06-19 00:50
用户初始约束(基础)
D-base-1
代码在 GitHub
每个项目对应一个 GitHub repo,本地只是缓存。main 分支受保护,只能通过 PR 合并。
每个项目对应一个 GitHub repo,本地只是缓存。main 分支受保护,只能通过 PR 合并。
2026-06-19 00:30
D-base-2
任务管理在本地项目内
~/agent-workspace/<project>/.pm/iterations.json,不依赖外部 task 系统。
2026-06-19 00:30
D-base-3
PR 由 agent 合
Merger agent 执行 merge,但只在用户说"合"之后才动。
Merger agent 执行 merge,但只在用户说"合"之后才动。
2026-06-19 00:30
D-base-4
用户在 GitHub 上 review
看 PR、看 reviewer comment,自己拍板。PM 不替代你看 PR。
看 PR、看 reviewer comment,自己拍板。PM 不替代你看 PR。
2026-06-19 00:30
D-base-5
多 agent 职能化
不能一个 agent 干所有事。要有 developer / reviewer(必须有)/ merger 等不同角色。
不能一个 agent 干所有事。要有 developer / reviewer(必须有)/ merger 等不同角色。
2026-06-19 00:30
PM 自治决定(无需用户确认)
- OpenCode 主力 model默认 deepseek-v4-pro(走 opencode-go 通道)
- opencode serve 锁定 localhost(不暴露外网,加
--hostname 127.0.0.1) - 保活用 tmux + 10s 循环(不要 systemd)
- 不用 MCP 注入工具(用户说 context 太多,不讨论)
- Reviewer 排除 deepseek(避免和 developer 重复),只在 glm/minimax/kimi 里选
- Task 默认串行(worktree 共享,避免冲突);只有文件无依赖时并行
- 默认重试次数:网络 3 次、编译/测试 1 次
- agent 卡住判定:10 分钟无 token 增长
- PM 给 user 升级的格式:问题类型 + 描述 + PM 建议 + 选项 A/B/C
待讨论 / 待决策
- 是否装 gh CLI?用户将提供 PAT
- 第一个项目:用
~/agent-workspace/hello还是新建? - GitHub owner / repo 名(默认
netkingcode/hello?) - 每个项目预算上限(默认月 $50?用户定?)
- 工作时间内是否限制 PM 不打扰(晚上不推送 reviewer 启动通知?用户定?)