用途
ln-513-agent-reviewer 是 ln-510 质量协调流水线中的工作单元（Worker），由 ln-510 第 4 阶段（Agent Review）调用。其职责是对代码实现并行运行外部智能体评审，批判性地验证建议，并返回经过过滤的改进项。
主要能力
- 以后台任务方式并行运行 codex-review 与 gemini-review。
- 按结果到达顺序处理（先完成的智能体立即处理）。
- 对每条建议进行批判性验证；当 Claude 不认同时，与对应智能体展开辩论。
- 返回经过过滤、去重、验证并带置信度评分的建议。
- 单次调用内完成健康检查与提示词执行。
使用方式
调用时机
由 ln-510-quality-coordinator 第 4 阶段（Agent Review）调用。前提条件：Story 下所有实现任务状态为 Done；代码质量（ln-511）与技术债清理（ln-512）已完成。
参数
- review_type：codereview
- skill_group：513
- prompt_template：shared/agents/prompt_templates/code_review.md
- verdict_acceptable：CODE_ACCEPTABLE
输入
- storyId（必需）：来源为 args、git 分支、看板或用户。解析遵循 shared/references/input_resolution_pattern.md 的 Story Resolution Chain；状态过滤为 In Progress、To Review。
工作流
强制读取：shared/references/input_resolution_pattern.md、shared/references/tools_config_guide.md、shared/references/storage_mode_detection.md、shared/references/agent_review_workflow.md、shared/references/agent_delegation_pattern.md。
阶段 0：解析输入与工具配置
- 解析 storyId：若提供 args 则使用 args；否则若 git 分支匹配 feature/{id}-* 则提取 id；否则若看板中恰有 1 个 Story 处于 [In Progress, To Review] 则建议；否则通过 AskUserQuestion 展示看板中过滤后的 Stories。
- 读取 docs/tools_config.md（缺失时按 tools_config_guide.md 引导初始化），提取 task_provider = Task Management → Provider（linear | file）。
独有步骤（共享工作流之前）
- 健康检查：按共享工作流，按 skill_group = 513 过滤。
- 获取引用：若 task_provider = linear，调用 get_issue(storyId) 提取 URL 与 identifier，并 list_issues(filter: {parent: {id: storyId}, status: "Done"}) 提取 Done 实现任务的 URL/identifier（排除标签 "tests"）；若 task_provider = file，读取 story.md 提取路径，Glob("docs/tasks/epics//stories//tasks/*.md") 过滤 Done 任务（检查 Status: Done），排除标签 "tests"。
- 确保 .agent-review/ 目录存在。
- 构建提示词：读取模板 shared/agents/prompt_templates/code_review.md；将 {story_ref} 替换为 - Linear: {url} 或 - File: {path}；将 {task_refs} 替换为每个任务的 - {identifier}: {url_or_path} 列表；保存到 .agent-review/{identifier}_codereview_prompt.md（单一共享文件，两个智能体读取同一提示词）。
共享工作流步骤
- 步骤 5-8：加载 Review Memory、运行智能体、批判性验证 + 辩论、聚合 + 返回，均按共享工作流执行。
- {review_type} = "Code Implementation"（用于 challenge 模板）。
- 保存 Review Summary：按共享工作流 "Step: Save Review Summary"。
输出格式
verdict: CODE_ACCEPTABLE | SUGGESTIONS | SKIPPED
suggestions 列表项字段：
- area：security | performance | architecture | correctness | best_practices
- issue：问题描述
- suggestion：具体修复建议
- confidence：置信度
- impact_percent：影响百分比
- source：来源（如 codex-review）
- resolution：accepted | accepted_after_debate | accepted_after_followup | rejected
另含智能体统计与辩论日志，按共享工作流输出 schema。
适用场景
- 作为 ln-510 质量协调流水线第 4 阶段的一部分，对已完成实现的代码变更进行外部智能体评审。
- 需要并行调用 Codex 与 Gemini 进行代码评审并汇总验证结果的场景。
限制与回退
- 回退规则：按共享工作流；此外，父技能（ln-510）会回退到 Self-Review（原生 Claude）。
- Verdict 升级：area=security 或 area=correctness 的发现，父技能可将 PASS 升级为 CONCERNS；本技能仅返回原始已验证建议，升级决策由 ln-510 做出。
- 强制调用：父技能必须调用本技能；若智能体不可用，本技能会优雅返回 SKIPPED，父技能不得预先检查并跳过。
参考文件
- 工具配置：shared/references/tools_config_guide.md
- 存储模式操作：shared/references/storage_mode_detection.md
- 共享工作流：shared/references/agent_review_workflow.md
- 智能体委派模式：shared/references/agent_delegation_pattern.md
- 提示词模板（评审）：shared/agents/prompt_templates/code_review.md
- Challenge schema：shared/agents/schemas/challenge_review_schema.json
版本：2.0.0；最后更新：2026-02-11。