victorgpt/my_coding_agent_share/agent-roberts-rules

Agent 议事规则 · v0.6

版本纪律:本文件顶部版本号是升级口子——只增不删,规则改动必须走文末修订流程。

「改了什么/为什么」写进 git commit message,不在文件内记账(git log -- SKILL.md)。

本文件只装规则,不装事故日志/版本流水账。

何时用

两个及以上归属不同人的 agent,要在 GitHub 上对齐一份产物(方案/契约/接口/评审)。 单人单 agent 的活不用;纯代码 review 走 code-review/pr-fix。

角色判定(先分清你是哪边)

• 作者方:产物是你方出的 → 走「作者方流程」;
• 评审方:对方发 PR 请你参与 → 走「评审方流程」。

铁律(双方通用)

1. 署名:每条 agent 评论首行 🤖 <agent名> · 代表 @<人>。只代表其人的项目发言。
2. 主题铁律:每条评论第二行重申议题一句话;无前缀/无议题重申视为无效发言。
3. 读后发言:发言前读完 PR 正文、全部评审对象、此前所有评论、自己项目的相关代码。

主张必须附证据(文件/行号/链接);拿不出的标 [未验证]。

1. 阶段前缀:[议程] [报到] [意见] [回应] [综合] [定稿建议] [升级]。
2. 锚定 head SHA:一切复核表态必须写明所核的 commit(v0.4 新增·实测两次推送与复核时序交叉,

无锚定就会对着不同版本空转)。

1. 不投票。全员 [同意] 且无未解阻塞 → 定稿;[综合] ≤3 轮仍有阻塞 → [升级]

各写 ≤10 行分歧摘要(立场+代价)@双方人类仲裁。

1. 评论是过程,正文是冻结:共识写进 PR 正文冻结区/ADR 才算数;合并由人执行。
2. 24h 未响应可标 [缺席] 继续;缺席方处理由议题所有人裁定并写进定稿。
3. 落地闭环优先于共识本身(v0.5 新增 · 参考 IETF "rough consensus and running code" /

Linus "talk is cheap, show me the code")。议事目标是能落地的最小闭环,不是把责任厘清到 万无一失就停;拒绝过度设计。[综合]/[定稿建议]若没有对应的下一步可执行动作 (PR/commit/接口/脚本落地),不算闭环,继续标 [待落地],不得进冻结区。

作者方流程

1. 发 PR:评审对象须含可行级评论的 markdown(纯 HTML 没法逐条锚定);PR body =

[议程](唯一议题+成功标准)+ 参与方 + 本规则全文 + 底部预留「冻结区(定稿后由人填写)」。

1. 多评审对象必须同步(v0.4 新增·实测):若同时列了 HTML 呈现版与 md 事实源,措辞冲突会卡终审——

修订必须两边落,或明写「语义以 md 为准」。

1. 起监听(会话内 Monitor,轮询评论/行级/review 三路):

``bash # 排除自己用 GitHub 登录名,绝不用署名前缀——友方 agent 可能同署名「🤖 Claude」(v0.4·实测踩坑) gh api "repos/<R>/issues/<N>/comments?since=$last" --jq --arg me "$(gh api user --jq .login)" \ '.[] | select(.user.login != $me) | ...' ``

1. 回应姿势:逐条 [回应](接受/不接受+理由);修订必须落进 diff 才能请求最终 `[同意]`,

回应时注明修订 commit;涉及自家人拍板的先问人再回。

1. 一事一议执法:对方把实施细节(端点 spec 等)拖进架构议题时,礼貌拆分「另 PR 评审」。

评审方流程

[报到](项目·现状·并入面·遗漏,附代码位置)→ [意见](逐条:针对第 X 节第 Y 条·意见· 是否阻塞)→ 对方修订后按 head SHA 复核 → 分歧尽,给最终 [同意](注明边界:同意≠开工授权)。

收官动作

定稿合并后,发起方 agent:

1. 把冻结结论回写各决策票/ADR;
2. 这次议事若踩了值得记的坑,可以(非强制)按 postmortem-distill 蒸一条教训存进 nmem ——

不写进本 skill 文件,本文件只装规则,不装事故日志。

1. 教训若指向规则本身有缺陷 → 走下面「修订流程」升版,理由写进 commit message。

修订流程(升级口子)

1. 修订动议来自:某次议事暴露出的规则缺陷,或用户直接指示;
2. 人确认后:改正文 + 版本号 +0.1;改了什么/为什么写进 commit message,文件内不重复记。
3. 正在进行中的议事沿用其 PR body 里的版本,不追溯。