mcpField
L
ln-513-agent-reviewer

ln-513-agent-reviewer

github.com/levnikolaevich测试与质量58440 次安装2 天前更新
代码仓库

关于 ln-513-agent-reviewer

面向代码实现审查的技能，会并行运行外部 Agent 审查，并核验、去重建议后返回带置信度的结果。它用于 ln-510 质量协调流程中的代码审查阶段。

主要功能

  1. 01并行运行 codex-review 与 gemini-review
  2. 02逐条核验审查建议
  3. 03去重并筛选改进项
  4. 04为建议提供置信度
  5. 05保存审查摘要

适用场景

  1. 01审查已完成的代码实现
  2. 02汇总多个外部 Agent 的审查结果
  3. 03为质量协调流程提供经核验的建议

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-513-agent-reviewer

安装后在 Claude Code 中输入/ln-513-agent-reviewer确认已加载。

详细介绍

路径： 文件路径（shared/、references/、../ln-*）均相对于 skills 仓库根目录。如果当前工作目录（CWD）下未找到，请定位此 SKILL.md 目录，并向上一级找到仓库根目录。

Agent Reviewer（代码）

并行运行外部 Agent 代码实现审查，严格核实建议，并返回筛选后的改进意见。

目的与范围

  • ln-510 质量协调器流水线中的工作器（由 ln-510 Phase 4 调用）
  • 在后台并行运行 codex-review 和 gemini-review
  • 收到结果后立即处理（先完成的 Agent 优先处理）
  • 严格核实每条建议；如果 Claude 有异议，则与 Agent 讨论
  • 返回经过筛选、去重和核实的建议，并提供置信度评分
  • 在单次调用中完成健康检查和提示词执行

适用场景

  • 由 ln-510-quality-coordinator 的 Phase 4（Agent Review）调用
  • 所有实现任务的 Story 状态均为 Done
  • 代码质量（ln-511）和技术债务清理（ln-512）已完成

参数

参数值
review_typecodereview
skill_group513
prompt_templateshared/agents/prompt_templates/code_review.md
verdict_acceptableCODE_ACCEPTABLE

输入

输入必填来源描述
storyId是args、git branch、kanban、用户要处理的 Story

**解析：**遵循 shared/references/input_resolution_pattern.md — Story 解析链。 状态筛选： 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。

Phase 0：解析输入和工具配置

  1. 解析 storyId（遵循 input_resolution_pattern.md）：

    • 如果提供了 args → 使用 args
    • 否则，如果 git branch 与 feature/{id}-* 匹配 → 提取 id
    • 否则，如果 kanban 中 [In Progress, To Review] 状态的 Story 恰好有 1 个 → 提出建议
    • 否则 → AskUserQuestion：显示 kanban 中筛选为 [In Progress, To Review] 的 Story

  2. 读取 docs/tools_config.md（如果文件缺失，则遵循 tools_config_guide.md 进行初始化）。 提取：task_provider = Task Management → Provider（linear | file）。

特有步骤（共享工作流之前）

  1. **健康检查：**遵循共享工作流，按 skill_group = 513 筛选。

  2. 获取引用：

    • 如果 task_provider = linear：执行 get_issue(storyId) → 提取 URL 和标识符。执行 list_issues(filter: {parent: {id: storyId}, status: "Done"}) → 提取已完成的实现 Task URL/标识符（排除标签为 "tests" 的任务）。
    • 如果 task_provider = file：读取 story.md → 提取路径。执行 Glob("docs/tasks/epics/*/stories/*/tasks/*.md") → 筛选已完成的任务（检查 **Status:** Done），排除标签为 "tests" 的任务。

  3. **确保存在 .agent-review/：**遵循共享工作流。

  4. **构建提示词：**读取模板 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（仅使用一个共享文件——两个 Agent 读取同一提示词）
共享工作流步骤

5-8) **加载审查记忆、运行 Agent、严格核实与讨论、汇总并返回：**遵循共享工作流。

  • {review_type} = "Code Implementation"（用于质疑模板）
  1. **保存审查摘要：**遵循共享工作流中的“步骤：保存审查摘要”。

输出格式

verdict: CODE_ACCEPTABLE | SUGGESTIONS | SKIPPED
suggestions:
  - area: "security | performance | architecture | correctness | best_practices"
    issue: "What is wrong"
    suggestion: "Specific fix"
    confidence: 95
    impact_percent: 15
    source: "codex-review"
    resolution: "accepted | accepted_after_debate | accepted_after_followup | rejected"

Agent 统计数据和讨论日志遵循共享工作流的输出架构。

回退规则

遵循共享工作流，另加：

条件操作
父技能（ln-510）回退到自审（原生 Claude）

Verdict 升级

  • area=security 或 area=correctness 的发现 -> 父级技能可以将 PASS 升级为 CONCERNS
  • 此技能返回未经处理的已核实建议；升级决定由 ln-510 作出

关键规则（补充）

  • 必须调用： 父级技能必须调用此技能。若 Agent 不可用，则正常返回 SKIPPED。父级不得预先检查并跳过调用。

参考文件

  • 工具配置： shared/references/tools_config_guide.md
  • 存储模式操作： shared/references/storage_mode_detection.md
  • 共享工作流： shared/references/agent_review_workflow.md
  • Agent 委派模式： shared/references/agent_delegation_pattern.md
  • 提示词模板（审查）： shared/agents/prompt_templates/code_review.md
  • 质疑模式： shared/agents/schemas/challenge_review_schema.json

版本： 2.0.0 最后更新： 2026-02-11

评论

支持 Markdown