Learn-skills.dev staged-review-validator

Validate staged-changes-review findings with evidence-based verdicts and minimal-fix guidance. Use when you need to confirm whether each reported issue is valid and actionable.

install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/adonis0123/adonis-skills/staged-review-validator" ~/.claude/skills/neversight-learn-skills-dev-staged-review-validator && rm -rf "$T"
manifest: data/skills-md/adonis0123/adonis-skills/staged-review-validator/SKILL.md
source content

Staged Review Validator

用于对已有审查报告做二次验证,不负责重新发起完整扫描。

何时使用

  • 用户已经有一份
    staged-changes-review
    结果,想确认每条问题是否真实成立
  • 用户问“这个问题到底要不要改”
  • 用户希望获得“逐条裁决 + 证据 + 修改建议”

输入契约

必需输入

  • 用户提供一段
    staged-changes-review
    文本(至少包含问题描述)

推荐输入

  • 文件路径
  • 行号
  • 风险级别
  • 置信度
  • 原始建议

缺失输入处理

如果用户没有粘贴审查结果:

  1. 明确提示“请先粘贴 staged-changes-review 结果”
  2. 提供一个最小输入模板(见
    references/output-template.md
  3. 不自动改为扫描
    git diff --cached

核验流程

1. 解析问题清单

从用户提供的报告提取每条问题:

  • 标题
  • 文件与行号
  • 原风险级别
  • 原置信度
  • 原建议

2. 逐条证据核验

对每条问题进行核验:

  • 文件/行号是否存在
  • 代码上下文是否匹配问题描述
  • 该问题是否已经在当前变更中修复
  • 是否存在上下文导致“看似问题但实际合理”

可使用但不限于以下命令:

git diff --cached
rg -n "关键符号" <path>
sed -n '<start>,<end>p' <path>
git show HEAD:<path>

3. 给出裁决

每条问题只能输出以下三种之一:

  • 成立
    :证据直接支持问题描述
  • 不成立
    :证据与描述冲突,或问题已修复
  • 待确认
    :证据不足(路径/行号缺失、上下文不完整等)

4. 推导“是否需要修改”

  • 成立
    且风险为中/高:
    需要修改
  • 成立
    且风险低:
    建议修改
  • 不成立
    不需要修改
  • 待确认
    暂不修改,先补充信息

输出要求(固定)

先给总览,再给逐条裁决。

总览

  • 问题总数
  • 成立数
  • 不成立数
  • 待确认数
  • 建议修改数

逐条裁决块(每条必含)

  • 问题标题
  • 文件位置
  • 风险级别
  • 置信度
  • 裁决(成立/不成立/待确认)
  • 是否需要修改(是/否/待补充)
  • 证据(命令结果或代码定位)
  • 最小改动建议

结尾给出编号式“可执行下一步”。

与 staged-changes-review 的关系

  • staged-changes-review
    :发现候选问题
  • staged-review-validator
    :验证候选问题是否真实成立

串联时,后者不重复完整扫描逻辑,重点做证据核验与裁决。

参考文档

  • references/verification-rubric.md
    :裁决标准、证据优先级、置信度映射
  • references/output-template.md
    :固定输出模板与示例