用途:作为 ln-500 质量门流水线中的工作器(Worker),由 ln-501-code-quality-checker 第7步(Agent Review)调用,对代码实现执行并行的外部智能体评审,并返回过滤后的建议。适用于 Story 状态下所有实现任务已完成、且 ln-501 的代码质量分析(第1-6步)已完成之后。
主要能力:并行运行 codex-review 与 gemini-review;对代码变更返回去重、带置信度评分的建议;单次调用内完成健康检查与提示词执行,缩短可用性检查与实际 API 调用之间的时间差;输出 verdict 为 CODE_ACCEPTABLE、SUGGESTIONS 或 SKIPPED;返回 agent_stats(名称、耗时、建议数、状态)。按 (area, issue) 去重,保留更高置信度;过滤条件为 confidence >= 90 且 impact_percent > 2。
必要用法: 健康检查:python shared/agents/agent_runner.py --health-check 并行运行: python shared/agents/agent_runner.py --agent codex-review --prompt-file {temp} --cwd {cwd} python shared/agents/agent_runner.py --agent gemini-review --prompt-file {temp} --cwd {cwd} 流程:健康检查并按 skill_groups 含 "502" 过滤;无可用智能体则返回 SKIPPED;通过 MCP Linear 加载 Story 与 Done 任务(排除 "tests" 标签);在项目 CWD 创建 .agent-review/,写入 story-{identifier}.md 与 tasks-{identifier}.md,并确保其在 .gitignore 中;读取 shared/agents/prompt_templates/code_review.md 模板,替换 {story_url}、{story_file}、{tasks_file} 后保存到临时文件(Windows 用 %TEMP%,Unix 用 /tmp);两个 Bash 调用同时运行;汇总与过滤;最后删除 .agent-review/ 并返回 JSON。
限制与回退:只读评审,智能体不得修改文件;所有智能体使用同一提示词以保证公平比较;要求智能体通过 --json / --output-format json 返回 JSON;需记录所有尝试。一个智能体失败则用成功者建议并记录失败;两者均失败则返回 SKIPPED,父技能回退到 Self-Review。area=security 或 correctness 的发现可由父技能将 PASS 升级为 CONCERNS,升级决策由 ln-501 做出。版本 1.0.0,最后更新 2026-02-08。