Skip to content

精简多 Agent 审核与调度规则 0723#17

Draft
wlvh wants to merge 1 commit into
mainfrom
agent/simplify-multi-agent-review
Draft

精简多 Agent 审核与调度规则 0723#17
wlvh wants to merge 1 commit into
mainfrom
agent/simplify-multi-agent-review

Conversation

@wlvh

@wlvh wlvh commented Jul 23, 2026

Copy link
Copy Markdown
Owner

1. 背景与目标

多 Agent 模式会显著增加 token、墙钟时间和人工裁决负担,但这些运行时复杂度不应继续膨胀阶段 prompt。本 PR 现在只聚焦两件事:把稳定的多 Agent 治理边界集中到中文 AGENTS.md,以及精简、去漂移并补齐 PR review prompt 的证据与严重度标准。

按用户 R3 范围调整,zh/docs/development_workflow/README.md 的全部修改已整体撤销;该文件当前与 main 完全一致。

本轮按用户要求只维护中文路径;英文对应内容暂不修改,并显式记录 en-pending


2. 实现方案

  • zh/AGENTS.md 增加三条通用多 Agent 治理:主会话最终负责、Agent 一致不等于证据、调查与审查默认只读;同时吸收原 review prompt 中独有的“最小语义结构”和松耦合规则,并同步文件自描述。
  • zh/prompts/pr_review_system.md 删除具体模型与 connector/app 权限假设,以 Issue、权威文档和实际读取材料为审核输入;删除与 AGENTS.md 重复的质量标准,将剩余表达约束合并到最终报告章节,并新增 P0 / P1 / P2 的唯一严重度定义与“定级即承诺”规则。
  • 不修改 zh/docs/development_workflow/README.md;此前关于双审路由、Finding 验证调度、稳定步骤 ID 和运行时调度原则的修改均已从本 PR 撤销。

3. 变更范围

文件 / 目录 变更类型 说明
zh/AGENTS.md 修改 集中多 Agent 治理,吸收 review prompt 的独有代码质量规则
zh/prompts/pr_review_system.md 修改 解耦产品能力、删除重复规范、统一主审证据门槛与严重度定义

4. 文档影响

受影响文档:

  • zh/AGENTS.md
  • zh/prompts/pr_review_system.md

说明:

  • zh/docs/development_workflow/README.md 已恢复为 main 版本,不属于当前 patch。
  • 本 PR 不改变 capability_contract.json 中的能力边界,不改变 interact.md 中的用户可观察行为,也不改变业务人员使用方式,因此无需更新用户能力文档。
  • 按用户要求,本轮不修改英文路径。en/AGENTS.md 的对应语义和尚未发布的英文 prompt 路径标记为 en-pending,后续单独完成双语语义等价审核。

5. 用户与架构影响

用户可见变化:

  • No
  • 说明:仅调整 agent 治理与审核 prompt,不改变目标项目运行时行为。

架构变化:

  • No
  • 说明:未修改代码模块、运行时调用链、数据流、状态模型或外部依赖。

6. Review / 修复记录

轮次 来源 问题摘要 判断 处理结果 证据
R0 初始提交 N/A N/A 初始实现 单 commit;当前实际 diff 仅包含两份中文文件
R1-F1 Claude Code 独立初审 单审 / 双审的验证通道不明确,Codex 新对话隔离被切断 confirmed Reverted by scope change 相关 README 修改已整体撤销;文件与 main 一致
R1-F2 Claude Code 独立初审 P0/P1 复核门槛在 README 与 review prompt 双写并分叉 confirmed Fixed README 恢复为 main,唯一完整定级规则保留在 pr_review_system.md
R1-F3 Claude Code 独立初审 README 残留过期模型名和“粘贴给 GPT”措辞 confirmed Out of current scope 用户要求 README 完全不动;该文件已恢复为 main
R1-F4 Claude Code 独立初审 AGENTS.md 文件简介未覆盖新增多 Agent 协作边界 confirmed Fixed zh/AGENTS.md 自描述已同步
R1-F5 Claude Code 独立初审 最终审核覆盖面丢失“测试覆盖”维度 confirmed Fixed pr_review_system.md 3.4 使用“测试覆盖与可信度”
R1-F6 Claude Code 独立初审 高风险双审路由在同一 README 重复声明 confirmed Reverted by scope change 相关 README 修改已整体撤销
R1-F7 Claude Code 独立初审 删除“没有调查就没有发言权”可能削弱审核证据要求 rejected N/A pr_review_system.md 使用更精确的 P0/P1 主审复核门槛
R2-F1 Claude Code 复审 第 9 步规则定义前置且使用集合论术语,执行顺序不够直白 confirmed Reverted by scope change 第 9 步修改已随 README 整体撤销
R2-F2 Claude Code 复审 全仓引用 P0/P1 作为门禁,但没有严重度定义 confirmed Fixed pr_review_system.md 3.5 新增 P0/P1/P2 SSOT;未证实高风险项保持待验证
R2-F3 Claude Code 复审 主流程缺少 3、6、10,但没有说明是稳定 ID 还是编号错误 confirmed Out of current scope 用户要求 README 完全不动;稳定 ID 声明已撤销
R3 用户范围调整 整体撤销 zh/docs/development_workflow/README.md 的全部修改 confirmed Reverted main...agent/simplify-multi-agent-review 只剩 zh/AGENTS.mdzh/prompts/pr_review_system.md

7. 已知限制与回滚

已知限制:

  • 英文对应路径尚未同步,已记录 en-pending
  • 本轮不再包含 development workflow README 的双审、调度、验证流程和稳定步骤 ID 修改。
  • 本轮保留乔布斯 / Linus 等审核视角;是否继续去脚手架化,应通过历史 PR 回放验证后再决定。

回滚方式:

  • 回滚本 PR 的单个 commit,即可恢复原中文治理与审核 prompt。

8. 最终自检

  • 当前分支不是主干
  • 已按 main...agent/simplify-multi-agent-review 核对实际 diff
  • PR 仍保持单 commit
  • zh/docs/development_workflow/README.md 已从 PR diff 中消失
  • “变更范围”与实际 diff 一致,仅包含两份中文文件
  • PR body 不包含当前 patch 未落地的实现声明
  • 已按 TESTING.md 判断:本 PR 为文档 / prompt 变更,无行为性代码改动,不新增测试
  • 最新 GitHub Actions test / pytest 已通过
  • 用户可见变化已对照 interact.md
  • 架构变化已对照 architecture.md
  • R1、R2 与 R3 均保留来源 ID 和当前处理状态,无 finding 静默消失

@wlvh
wlvh force-pushed the agent/simplify-multi-agent-review branch 3 times, most recently from 2b1ccbc to 15ff487 Compare July 23, 2026 12:53
@wlvh
wlvh force-pushed the agent/simplify-multi-agent-review branch from 15ff487 to f8da5a6 Compare July 23, 2026 13:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant