用途:作为 ln-510 质量协调流水线中的 worker,由 ln-511-code-quality-checker 第 7 步调用,对代码实现运行并行的外部智能体评审,返回经过验证的改进建议。
主要能力:并行以后台任务方式运行 codex-review 与 gemini-review;按到达顺序处理结果,先完成的先处理;对每条建议由 Claude 独立评估,同意则采纳,不同意或不确定则按辩论协议发起挑战与跟进轮次;汇总去重后返回带置信度的建议。
使用方式:先执行健康检查 python shared/agents/agent_runner.py --health-check,按 skill_groups 含 "512" 过滤;无可用智能体则返回 SKIPPED。通过 Linear MCP 获取 Story 与 Done 实现任务引用(本地存储则用文件路径)。创建 .agent-review/{agent}/ 目录及 .gitignore(内容 * 与 !.gitignore)。从 shared/agents/prompt_templates/code_review.md 构建提示词,替换 {story_ref}、{task_refs},保存到 .agent-review/{agent}/{identifier}_codereview_prompt.md。以 run_in_background=true 启动两个智能体,命令形如 python shared/agents/agent_runner.py --agent codex-review --prompt-file ... --output-file ... --cwd {cwd}。解析结果文件中 <!-- AGENT_REVIEW_RESULT --> 与 <!-- END_AGENT_REVIEW_RESULT --> 之间的 JSON。
输出:verdict(CODE_ACCEPTABLE | SUGGESTIONS | SKIPPED)、suggestions(area、issue、suggestion、confidence、impact_percent、source、resolution)、agent_stats、debate_log。过滤条件为 confidence >= 90 且 impact_percent > 2。
限制:只读评审,智能体不得修改项目文件;所有智能体使用相同提示词;不得盲目信任建议,必须独立验证;不得杀死运行中的后台任务,仅硬崩溃视为失败;挑战与跟进产物需持久化,不清理删除;area 为 security 或 correctness 的发现可由父技能升级判定。