Skip to content

自动合并材料收集 #801

Closed
Closed

Description

@ranxianglei

现在我要让一些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

  1. ranxianglei commented on Sep 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    收到,开始收集。我的做法:

    1. 拉全量历史:三个仓库(billion-context / billion-context-pi / acp-kernel)所有 issue + PR(含已关闭)+ 每条评论,重点抓 AI 自动开发的 PR(带 ework-agent-pr 标记 / bot 身份)以及人工在上面的反馈、驳回、纠正。
    2. 挖 devlog/:billion-context 里每个迭代都有 REQ/WORKLOG/REVIEW,WORKLOG 的 lessons learned 和 REVIEW 的 review findings 直接记录了人工把关时揪出的问题。
    3. 对照现有 AGENTS.md:看哪些规则已经固化、哪些是反复踩坑但还没写进去的。

    产出会是一份结构化总结:①人工实际定下的规则(已固化 vs 隐性);②AI 把握不到、必须由人把关的点;③给 agents.md 的补充建议 + 审核员 checklist。目标支撑「90% bugfix 自动合并」。

    正在跑数据收集,稍后回帖完整分析。

  2. ranxianglei commented on Sep 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    三仓库 AI 自动开发全量复盘(#801)

    数据来源:拉取三个仓库全部 issue+PR+评论(billion-context 801 项 / -pi 447 / acp-kernel 295,共 1543 项、1072 个 PR、3645 条评论),叠加本仓 devlog/ 31 条迭代记录、AGENTS.md 完整 git 演进史、commit 类型分布。按你要的四件事总结如下。

    一、基线事实

    二、人工确立的规则

    A. 已成文(继续守住):git 安全四禁、branch 命名、version 仅 release 分支、发布流程+no-op 校验、acp-kernel 先发、issue 先行+问题必报、代码质量(no as any / hex escape / loggerLog)、改管线前跑 e2e、两种压缩模式都要想。

    B. 反复出现但还没成文(隐性规则,建议补进 AGENTS.md)——均有真实出处:

    1. 先查重再动手:用bili omp 启动omp之后, /acp命令不能正确执行. #268、pi feat: anonymous prefix-affinity session resolution (#309) #311/release v0.1.62 #314(同标题重复 PR)。
    2. rebase 到最新 master 再验证再提:Fix Codex Responses session continuity #249/偶尔模型在acp工具处停止执行 #221/fix: resolve issues #150 #151 #152 #154 (24h issue batch) #155/fix: bound session storage growth — single-copy leaf blocks, boot GC, one-pass startup (#478) #479 反复要求基于当前 master 重跑全量。fix: bound session storage growth — single-copy leaf blocks, boot GC, one-pass startup (#478) #479 最典型:AI 漏了 rebase 顺序依赖——某测试写死 savedAt=9000/5000/8000,因另一 PR(fix: restart restores savedAt as lastSeen instead of fabricating boot-time activity (#404) #487)先落 master 而失效,人工独立复审才抓到。
    3. 收敛范围,一 issue 一主题:bili 模式切换模型会报错上下文满 #247「先收敛,你只负责本 issue…额外问题找其他 agent」;feat: 新增 codebuddy 客户端支持(bili codebuddy) #640 兄弟 issue 批一个 PR、关掉被取代的。
    4. 交 PR,不是光推分支:bili出现连续压缩情况 #282「提交 pr 而不是分支」。
    5. 绝不静默丢/覆盖用户配置:fix: resolve issues #150 #151 #152 #154 (24h issue batch) #155 白名单漏 prompts 键,web 保存会静默抹掉自定义压缩提示词→改为 malformed 直接 400;devlog 同类:读失败还往 {} 合并=静默丢数据,应拒写(PUT 409)。
    6. 兜底值要合理:bili出现连续压缩情况 #282「识别失败默认回 20w、最低 10w,别用 64k」;静态表不得压过活注册表(freshness 层级)。
    7. 优先用客户端原生稳定标识:Codex 长会话在 macOS 休眠唤醒后 Bili 未触发压缩,导致上下文窗口超限 #280「session-id 才是唯一不变、绑定当前会话的;能拿到原生 id 的都要用它,拿不到的报告」。别用 hash(provider|key|…) 这类随切换漂移的派生值。
    8. 分清症状与机制:bili出现连续压缩情况 #282「连续压缩」实为上游 429 限流+客户端重试刷出的日志假象,非压缩机制失控——先看上游日志再归因。
    9. 输出要诚实:fix: resolve issues #150 #151 #152 #154 (24h issue batch) #155 export 对 0-block 会话打出"下面是原始对话"的撒谎文案,要求改诚实提示。
    10. 完成=证据:fix: preflight SSE extraction rejects truncated and failure streams (#780) #784「review 了吗」;bili 模式切换模型会报错上下文满 #247「本地双 review + 实际测切换,观察是否符合预期」,不是"应该可以"。
    11. 日志:凭证必脱敏 + 分级:bili 模式切换模型会报错上下文满 #247 bug 收敛期默认开 debug、trace/debug/info 分级、hdrLog 脱敏。
    12. 文档中英同步 + 位置可见:pi dev首页优化 #698 QQ 群号三项目中英文都加、且别放最后没人看见。
    13. 跨仓顺序:专用:发布新版本pr #772「先发内核版本,再发这个」——acp-kernel 未合并发不了下游。

    三、AI 把握不到的点(审核员重点盯,按频率)

    1. 交叉/交互效应(最高危):rebase 顺序、并发 PR 相互影响、切模型/切 provider 后状态漂移。AI 偏局部推理,漏全局交互。
    2. 静默数据丢失路径:read-modify-write、配置覆盖、持久化版本迁移。
    3. 协议/线上保真:严格上游不变量(tool_call 的 id/顺序、SSE 结构、compaction_trigger 必须是最后一个 input item—fix: keep Codex compaction_trigger final when injecting the compress nudge #283),别改上游线格式。
    4. 标识与会话稳定性:派生 id vs 原生 id、sticky 会话、中途切换。
    5. 默认值/兜底判断:不合理 fallback、真值来源优先级——属产品判断,AI 易拍脑袋。
    6. 症状≠根因:日志假象、错误归因。
    7. 流程卫生:范围蔓延、重复劳动、只推分支不开 PR、跨仓顺序。
    8. 面向用户的判断:文档措辞/语言/位置、诚实性、UX 默认值。

    四、自动合并门槛(目标 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 清单?

  3. ranxianglei commented on Sep 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    已把完整材料整理成文档并开了 PR:#803 AUTO-MERGE-GUARDRAILS.md(docs-only,不动代码、不动 version)。

    PR 里那份文档包含:

    1. 基线事实——fix 占 ~54% commit;三仓 closed-unmerged 全为 0(人工只合并或挂起,从不否决);AGENTS.md 每条硬规则都能追溯到一次事故。
    2. 人工规则——分成「已成文」(现有 AGENTS.md)和「反复出现但没成文」的 13 条隐性规则,每条带 issue 出处,且在 billion-context-pi 里做了跨仓验证(rebase-to-master / 查重 / 配置 / 兜底 / 日志 / 收敛 都复现)。
    3. AI 把握不到的点——按频率排的 8 类(交叉效应 > 静默数据丢失 > 协议保真 > 标识稳定 > 默认值判断 > 症状≠根因 > 流程卫生 > 面向用户判断)。
    4. 自动合并门槛——可自动合并 vs 必须人工的精确判据。
    5. 审核员 checklist——逐条可勾选。
    6. 建议并入 AGENTS.md 的具体段落——可直接粘贴的紧凑文本(新增一节 "Review & Auto-Merge Discipline"),没有擅自改 AGENTS.md 本身,等你拍板。

    两个待你定的点(决定我下一步怎么做):

    1. 方向和颗粒度对不对?§6 那段要不要按此并入 AGENTS.md?
    2. 「可自动合并」这套要做成 CI 硬门禁(gate),还是先只作 reviewer 清单?
  4. ranxianglei commented on Sep 15, 2026

    @ranxianglei
    OwnerAuthor

    你把上面的经验都合并到AGENTS.md,另外虽然有一些没有被明确否决的,但是有很多issue和pr有二次评论才过的,这些是重灾区。需要注意一下。
    还有一条落下了,需要判断优先沉淀到内核还是在本仓库。
    另外本次只限制本仓库改动,跨仓库的暂时先人工。

  5. ranxianglei commented on Sep 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    三件事都做完了,全部落在 PR #803(现 2 个 commit,mergeable 无冲突;CI:version-guard / build-artifact 已过,OS 矩阵测试跑ing)。

    ① 经验并入 AGENTS.md —— 新增 §7 Review & Auto-Merge Discipline(+118 行),含:

    • §7.1 开工前:先查重 / 一 issue 一主题 / 交 PR 不推裸分支
    • §7.2 review 纪律:rebase 到当前 master 再验证、热文件踩踏预警、单线性提交干净 diff、完成=证据(实测 A/B)、测试必须确定性
    • §7.3 正确性护栏:绝不静默丢配置 / 兜底值要合理 / 优先原生稳定标识 / wire 保真(host 侧) / 症状≠机制 / 输出诚实 / 日志脱敏分级 / 文档中英同步+位置
    • §7.4 自动合并门槛(仅限本仓库):可自动合并的 8 条硬判据 + 必须人工的情形
    • §7.5 reviewer 重点(重灾区)

    ② 重灾区分析 —— 统计 455 个已合并 PR 的人工评论次数:229 个 0 次、71 个 1 次、26 个 ≥2 次(~7% 需第二轮才过)。逐条读了 bugfix 类返工的二次评论(#571/#467/#517/#425/#219/#428/#360/#254/#657),归纳出两个主导成因(正是自动合并最危险处,已写进 §7.5):

    1. stale-base / 并发文件踩踏——长命分支偏离快速演进的 master,或抢同一热文件(server.ts/preflight/persist.ts)。信号:分支新鲜度 + 是否与其它 open PR 改同一文件。
    2. 首遍不完整——只治了报出来的症状,漏相邻路径/边界、或承诺没做完、或方案要重来。信号:修复是否覆盖该 bug 的所有路径,而不只是 repro。

    ③ 内核 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 已写明)。

    一句话中文摘要:把三仓复盘出的隐性规则与自动合并门槛并入了 AGENTS.md §7(限本仓库)、用真实数据标出了"二次返工重灾区"的两个主导成因供审核员重点盯、并判明 wire/内核产物保真这条应归 acp-kernel 而非本仓库,跨仓暂留人工。

    待你过目 PR #803。要不要我把「可自动合并」那套再推进成 CI 硬门禁(gate)?那是另一件事(涉及 CI 改动),你点头我再单独开。

  6. ranxianglei commented on Sep 15, 2026

    @ranxianglei
    OwnerAuthor

    你向其他两个项目也提交类似的pr

  7. ranxianglei commented on Sep 15, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    已按你的要求给另外两个仓库也提了同类 PR(均为 docs-only:只加 AUTO-MERGE-GUARDRAILS.md + AGENTS.md §7,不改代码、不 bump version;合并仍留给你手动)。

    1. billion-context-pi → ranxianglei/billion-context-pi#457

    2. acp-kernel → ranxianglei/acp-kernel#303

    三个仓现在各有 §7 + guardrails 文档,通用流程规则一致,但按各仓性质做了适配。跨仓联动仍按你说的保持人工。

  8. ranxianglei commented on Sep 16, 2026

    @ranxianglei
    OwnerAuthor

    我看你写了比较多,可能有重复的内容,建议总体梳理一遍,保持精简单能力不丢

  9. ranxianglei commented on Sep 16, 2026

    @ranxianglei
    OwnerAuthor

    我看你写了比较多,可能有重复的内容,建议总体梳理一遍,保持精简单能力不丢

  10. ranxianglei commented on Sep 16, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    已按你说的总体梳理一遍,去掉了重复。

    问题定位:规则 / 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 号不变):

    • billion-context #803 → head 853a6d2
    • billion-context-pi #457 → head d5e1bb3
    • acp-kernel #303 → head ebaea36

    一句话:把三份文档收敛成「§7 管操作、文档管证据」的单一来源结构,精简但不丢任何规则或引用,三个 PR 都已更新,等你手动合并。

  11. added a commit that references this issue on Sep 16, 2026
  12. added a commit that references this issue on Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions