Repository navigation
docs: auto-merge guardrails (material for #801) - #803
Conversation
Distills the full-history review of AI auto-dev across billion-context / billion-context-pi / acp-kernel into: baseline facts, codified vs implicit human rules (each with issue citations), AI blind-spot categories, an auto-merge gate, a reviewer checklist, and proposed AGENTS.md additions.
📦 Built Package ArtifactBranch: Option A — Install from npm PR tag (recommended)npm install -g billion-context@pr-803Each push to this PR publishes a new version under the Option B — Download artifact
tar xzf billion-context-pr803.tgz
npm install -g packageInstall instructions are refreshed on each push. |
[bot] 🏷 Review 完成(PR #803,head 1. Diff 与 CI(干净)
2. 内容与引用核对(准确)
3.
|
…kernel split Per #801 owner direction: - Add AGENTS.md §7 'Review & Auto-Merge Discipline': pre-work and review discipline, correctness guardrails, a this-repo-only auto-merge gate, and reviewer focus on the second-round ('重灾区') zones (stale-base/concurrent-file churn + incomplete first pass). - Scope limited to this repo; cross-repo changes stay manual (notes in §7.3/§7.4). - Document the wire/kernel-artifact fidelity split: format contract + id-never- reused guarantee belong to acp-kernel (deferred, manual); host keeps its faithful-consumption duty. - Update AUTO-MERGE-GUARDRAILS.md: rules now codified in §7; add 重灾区 per-PR data (26/326 = ~7% need a 2nd+ review round), owner decisions, and the kernel-vs-host ownership judgment.
|
有一个ci失败,看需要提交新issue吗 |
[bot] 🏷 查清了,需要 issue——已开 #815(带来源标记,含完整证据链和修复建议)。 结论:不是 flaky,是 e2e 套件的一个隐性耦合被这个 PR 踩中了失败 job: 根因(本地已复现验证,codex-cli 0.147.0 + 仓库自带 fake-upstream 抓请求原文):
A/B 数据:请求原文长度 master AGENTS.md = 69,424 chars vs PR 版 = 76,171 chars,Δ=6,747 与文件差值精确一致;CI 日志里的 12,748 > 12,000 也吻合。 为什么只有这个 PR 炸:同时段其他 4 个并行 PR 该 job 全绿——它们带的还是旧 AGENTS.md。这是确定性行为:未来任何让 AGENTS.md 净增超过 ~1k tokens 的 PR 都会以同样方式炸 CI,包括 CI 不 pin 的 对 #803 本身的处置建议材料内容本身没问题,但它的 AGENTS.md §7 部分在 e2e 修复落地前过不了 CI。建议拆两步:
如果你希望 #803 保持原样一次合入,那就得先让 #815 的修复 PR 落地再 rebase #803——两条路都行,我倾向拆两步(材料先行不亏)。你拍板后我可以动手执行(拆分支 / 做 #815 的修复 PR)。 一句话总结:CI 失败不是偶发——e2e 测试因 codex 自动注入仓库 AGENTS.md 而与规范文件体积隐性耦合,本 PR 给 AGENTS.md 加 6.6KB 顶穿了 12k 测试窗口的 ~1k 余量;已开 #815 记录根因与已验证修复方案,建议 #803 拆成「材料文档先合、AGENTS.md 部分等 e2e 修复后再合」。 |
…t live in AGENTS.md §7 Remove the gate/checklist/verbatim-§7 blocks that duplicated AGENTS.md §7; keep baseline data, per-rule issue citations, blind-spot analysis, and owner decisions. Rules now stated once, in §7.
What
Material-collection deliverable for #801 自动合并材料收集. Adds
AUTO-MERGE-GUARDRAILS.md— a single reference distilled from a full-history review of AI auto-dev across all three repos (billion-context / billion-context-pi / acp-kernel): 1543 issues+PRs, 3645 comments, plusdevlog/(31 iterations),AGENTS.mdgit history, and commit-type distribution.Contents
Notes