现在我要让一些bugfix自动合并和发版本。 但是需要掌握大方向上的问题不能偏移。 基础是前面我们做了非常多的合并,90%都是一次过。 所以现在你需要收集过去所有AI自动开发的任务,判断人工做出了哪些规则,哪些是ai把握不到的,我们总结一下。 作为agents.md和审核员重点把关的地方,目标90%的bugfix都自动合并。 https://github.com/ranxianglei/billion-context https://github.com/ranxianglei/billion-context-pi https://github.com/ranxianglei/acp-kernel
Activity
ranxianglei commentedon Sep 15, 2026
收到,开始收集。我的做法:
ework-agent-pr标记 / bot 身份)以及人工在上面的反馈、驳回、纠正。产出会是一份结构化总结:①人工实际定下的规则(已固化 vs 隐性);②AI 把握不到、必须由人把关的点;③给 agents.md 的补充建议 + 审核员 checklist。目标支撑「90% bugfix 自动合并」。
正在跑数据收集,稍后回帖完整分析。
ranxianglei commentedon Sep 15, 2026
三仓库 AI 自动开发全量复盘(#801)
数据来源:拉取三个仓库全部 issue+PR+评论(billion-context 801 项 / -pi 447 / acp-kernel 295,共 1543 项、1072 个 PR、3645 条评论),叠加本仓
devlog/31 条迭代记录、AGENTS.md 完整 git 演进史、commit 类型分布。按你要的四件事总结如下。一、基线事实
fix:360 /feat:117 /docs:99 /test:41 /refactor:24,bugfix 约占 54%。二、人工确立的规则
A. 已成文(继续守住):git 安全四禁、branch 命名、version 仅 release 分支、发布流程+no-op 校验、acp-kernel 先发、issue 先行+问题必报、代码质量(no as any / hex escape / loggerLog)、改管线前跑 e2e、两种压缩模式都要想。
B. 反复出现但还没成文(隐性规则,建议补进 AGENTS.md)——均有真实出处:
savedAt=9000/5000/8000,因另一 PR(fix: restart restores savedAt as lastSeen instead of fabricating boot-time activity (#404) #487)先落 master 而失效,人工独立复审才抓到。{}合并=静默丢数据,应拒写(PUT 409)。三、AI 把握不到的点(审核员重点盯,按频率)
四、自动合并门槛(目标 90% bugfix)
可自动合并(须同时满足):单模块小修;有回归测试复现原 bug 且转绿;rebase 到最新 master 后 typecheck+全量测试+build 全绿;不改配置 schema / 持久化格式 / 线上协议 / 跨仓依赖;纯 fix 无新增能力面;diff 干净(无无关改动、无大段空格重排);带
Fixes #N。必须人工:任何线上协议/消息形状改动(两种压缩模式均受影响)、配置 schema/持久化版本、跨仓依赖(acp-kernel bump)、auto-update(
src/update.ts,需先发 no-op 校验)、身份/会话绑定逻辑、feat/refactor/架构决策、安全相关(MITM/CA/凭证)、兜底/默认值变更。五、下一步
完整证据链(逐条 issue/PR 引用 + AGENTS.md 逐字增补建议 + 审核员 checklist)我已整理好。方向确认后我开一个 PR:新增一份 guardrails 文档 + 给出 AGENTS.md 具体增补段落(不擅动最高优先级规范,等你拍板)。
两个待你定的点:① 这个方向和颗粒度对不对?② "可自动合并"这套要做成 CI 硬门禁(gate),还是先只作 reviewer 清单?
ranxianglei commentedon Sep 15, 2026
已把完整材料整理成文档并开了 PR:#803 AUTO-MERGE-GUARDRAILS.md(docs-only,不动代码、不动 version)。
PR 里那份文档包含:
两个待你定的点(决定我下一步怎么做):
ranxianglei commentedon Sep 15, 2026
你把上面的经验都合并到AGENTS.md,另外虽然有一些没有被明确否决的,但是有很多issue和pr有二次评论才过的,这些是重灾区。需要注意一下。
还有一条落下了,需要判断优先沉淀到内核还是在本仓库。
另外本次只限制本仓库改动,跨仓库的暂时先人工。
docs: merge auto-merge guardrails into AGENTS.md §7 + document 重灾区 & …
ranxianglei commentedon Sep 15, 2026
三件事都做完了,全部落在 PR #803(现 2 个 commit,mergeable 无冲突;CI:version-guard / build-artifact 已过,OS 矩阵测试跑ing)。
① 经验并入 AGENTS.md —— 新增 §7 Review & Auto-Merge Discipline(+118 行),含:
② 重灾区分析 —— 统计 455 个已合并 PR 的人工评论次数:229 个 0 次、71 个 1 次、26 个 ≥2 次(~7% 需第二轮才过)。逐条读了 bugfix 类返工的二次评论(#571/#467/#517/#425/#219/#428/#360/#254/#657),归纳出两个主导成因(正是自动合并最危险处,已写进 §7.5):
server.ts/preflight/persist.ts)。信号:分支新鲜度 + 是否与其它 open PR 改同一文件。③ 内核 vs 本仓库归属判断 —— 有真正歧义的是 wire / 内核产物保真这一条。判定:格式契约 + id 永不复用保证归 acp-kernel(它产出并拥有 ACP 标签、block ref、
acp_summary结构、ref 空间);本仓库只留 host 侧义务(忠实消费:不重生成 tool_call id/顺序、不裁剪 ref map、两种模式都要想)。已在 §7.3 标注此 split;因本次限定仅改本仓库、跨仓留人工,内核侧正式 spec 沉淀放到 acp-kernel 后续单独 PR(本轮不动 acp-kernel)。范围:本次只改本仓库;跨仓库改动一律留人工(§7.4 scope note 已写明)。
待你过目 PR #803。要不要我把「可自动合并」那套再推进成 CI 硬门禁(gate)?那是另一件事(涉及 CI 改动),你点头我再单独开。
ranxianglei commentedon Sep 15, 2026
你向其他两个项目也提交类似的pr
ranxianglei commentedon Sep 15, 2026
已按你的要求给另外两个仓库也提了同类 PR(均为 docs-only:只加
AUTO-MERGE-GUARDRAILS.md+AGENTS.md§7,不改代码、不 bump version;合并仍留给你手动)。1. billion-context-pi → ranxianglei/billion-context-pi#457
/acp影子)。2. acp-kernel → ranxianglei/acp-kernel#303
三个仓现在各有 §7 + guardrails 文档,通用流程规则一致,但按各仓性质做了适配。跨仓联动仍按你说的保持人工。
ranxianglei commentedon Sep 16, 2026
我看你写了比较多,可能有重复的内容,建议总体梳理一遍,保持精简单能力不丢
ranxianglei commentedon Sep 16, 2026
我看你写了比较多,可能有重复的内容,建议总体梳理一遍,保持精简单能力不丢
ranxianglei commentedon Sep 16, 2026
已按你说的总体梳理一遍,去掉了重复。
问题定位:规则 / Gate / Checklist 之前同时写在
AGENTS.md §7和AUTO-MERGE-GUARDRAILS.md里(本仓那份文档甚至整段复制了 §7),两处会漂移。处理原则——单一权威来源:
AGENTS.md §7= 唯一操作文本(每次会话加载,保持精简):规则 + 自动合并门槛 + must-stay-human + reviewer focus。AUTO-MERGE-GUARDRAILS.md= 纯证据附录:基线数据、逐条 issue/PR 出处、重灾区分析、owner 拍板结论。凡规则/Gate/Checklist 的操作文本一律不再复述,只指向 §7。能力不丢:每条规则仍完整保留在 §7(只在一处),文档保留全部证据与引用。行数:本仓文档 223→90,pi 104→80,kernel 108→83。
已作为后续 commit 推到同一分支(PR 号不变):
853a6d2d5e1bb3ebaea36一句话:把三份文档收敛成「§7 管操作、文档管证据」的单一来源结构,精简但不丢任何规则或引用,三个 PR 都已更新,等你手动合并。
Merge pull request #803 from ranxianglei/2026-09-15_auto-merge-guardr…
docs: add auto-merge guardrails from ranxianglei#801 retrospective