mcpField
L
ln-311-agent-reviewer

ln-311-agent-reviewer

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

关于 ln-311-agent-reviewer

ln-311-agent-reviewer 是 ln-310 验证流程中的技能，可并行运行 Codex 和 Gemini 对 Story 及其 Tasks 进行审查。它会核实并去重建议，提供编辑性改进，但不改变父技能的判定。

主要功能

  1. 01并行运行 Codex 和 Gemini 审查
  2. 02批判性核实并与 Agent 讨论
  3. 03去重 Story 和 Tasks 的建议
  4. 04保存审查摘要与讨论记录

适用场景

  1. 01审批前审查已验证的 Story
  2. 02查找 Story 与 Tasks 的编辑改进

安装

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

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

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

详细介绍

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

Agent 审查（Story）

并行运行外部 Agent，对已验证的 Story 和任务进行审查，严格核验建议，并返回编辑性改进意见。

目的与范围

  • ln-310 验证流水线中的工作单元（在第 5 阶段调用）
  • 将 codex-review 和 gemini-review 作为后台任务并行运行
  • 结果到达后立即处理（先完成的 Agent 先处理）
  • 严格核验每条建议；如果 Claude 不同意，则与 Agent 讨论
  • 返回经过筛选、去重和核验的 Story/任务改进建议
  • 在单次调用中完成健康检查和提示词执行

适用场景

  • 由 ln-310-story-validator 在第 5 阶段（Agent 审查）调用
  • 第 4 阶段的自动修复已应用，Penalty Points = 0
  • Story 和任务在批准前已定稿

参数

参数值
review_typestoryreview
skill_group311
prompt_templateshared/agents/prompt_templates/story_review.md
verdict_acceptableSTORY_ACCEPTABLE

输入

输入必需来源说明
storyId是args、git 分支、看板、用户要处理的 Story

**解析：**遵循 shared/references/input_resolution_pattern.md — Story 解析链。 **状态筛选：**Backlog

工作流

**必须阅读：**加载 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 阶段：解析输入和工具配置

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

    • 如果提供了 args → 使用 args
    • 否则，如果 git 分支匹配 feature/{id}-* → 提取 id
    • 否则，如果看板中恰好有 1 个处于 [Backlog] 的 Story → 提示该 Story
    • 否则 → AskUserQuestion：显示看板中筛选为 [Backlog] 的 Stories

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

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

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

  2. 获取引用：

    • 如果 task_provider = linear：调用 get_issue(storyId) → 提取 URL 和标识符。调用 list_issues(filter: {parent: {id: storyId}}) → 提取子任务的 URL/标识符。
    • 如果 task_provider = file：读取 story.md → 提取路径。调用 Glob("docs/tasks/epics/*/stories/*/tasks/*.md") → 提取子任务文件路径。

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

  4. **构建提示词：**读取模板 shared/agents/prompt_templates/story_review.md。

    • 将 {story_ref} 替换为 - Linear: {url} 或 - File: {path}
    • 将 {task_refs} 替换为项目符号列表：每个任务一行，格式为 - {identifier}: {url_or_path}
    • 保存到 .agent-review/{identifier}_storyreview_prompt.md（单个共享文件——两个 Agent 读取相同的提示词）
共享工作流步骤

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

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

输出格式

verdict: STORY_ACCEPTABLE | SUGGESTIONS | SKIPPED
suggestions:
  - area: "security | performance | architecture | feasibility | best_practices | risk_analysis"
    issue: "What is wrong or could be improved"
    suggestion: "Specific change to Story or Tasks"
    confidence: 95
    impact_percent: 15
    source: "codex-review"
    resolution: "accepted | accepted_after_debate | accepted_after_followup | rejected"

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

后备规则

遵循共享工作流，另加：

条件操作
父级技能（ln-310）回退到自我审查（原生 Claude）

判定升级

  • **不升级。**建议仅涉及编辑——它们只修改 Story/任务文本。
  • 父级技能（ln-310）的 Gate 判定不受 Agent 建议影响。

关键规则（补充）

  • 必须调用： 父级技能必须调用此技能。如果 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/story_review.md
  • 质疑模式： shared/agents/schemas/challenge_review_schema.json

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

评论

支持 Markdown