SuperAPI AI 工具集

staged-changes-review

编程与开发

查看项目

更新于 10-30 16:21

技能介绍

用途

staged-changes-review 用于对 Git 已暂存变更(staged changes)进行清单驱动的可复现审查,结合 grep 确定性扫描与闭式问题语义分析,输出结构化的审查报告。

主要能力

  • 暂存变更收集:通过 git diff --cached、--stat、--name-status 收集变更;无暂存变更时输出「无暂存变更,审查终止。」并停止。
  • 项目类型检测:依据 package.json 依赖与暂存文件类型判定 react-nextjs、react-app、python-generic、generic 四种配置,决定激活哪些规则类别(SEC、REACT、PERF、ASYNC、STR、LOGIC/BREAK、BIZ、REPO)。
  • 文件分级:按参考规则将每个暂存文件归入 P0–P4 优先级,P4 文件完全跳过。
  • 确定性扫描:按语言 grep 模式对每条适用规则逐条执行,命中即记录发现,采用规则表固定严重级别。
  • 影响范围分析:针对 P0/P1 文件检查新增/修改的导出符号、API 路由、Server Action("use server")与环境变量变更,并统计导出符号引用数。
  • 语义审查:对每条闭式问题必须回答 YES/NO/N/A;YES 须提供文件:行号与代码片段证据。BIZ 规则对 P1 文件对比变更前(git show HEAD:<path>)与暂存版本,说明变更前行为、变更后行为与影响场景。
  • 去重与分级:按 {ruleId}:{file}:{line} 指纹去重,按 CRITICAL → HIGH → MEDIUM → LOW 分组输出。
  • 报告生成:包含审查范围、影响范围、业务影响分析、发现总览、结论、分级发现与文件审查矩阵,供 staged-review-validator 使用。

使用方式

以技能形式调用,按固定 8 步顺序执行:0 收集变更 → 0.5 检测项目类型 → 1 文件分级 → 2 确定性扫描 → 2.5 影响范围分析 → 3 语义审查 → 4 合并去重 → 5 生成报告。执行中须遵守强制约束:不跳过规则、不做自由形式分析、每题必答、证据锁定、严重级别不可更改、结论套用模板、发现须带指纹。大数据量时有上下文预算策略与采样限制(如 P1 文件超过 10 个时 BIZ 仅分析前 5 个,REACT/ASYNC 语义验证最多取前 5 处匹配)。输出语言固定为中文,编码 UTF-8,风格专业简洁。

适用场景

适合在提交前对已暂存代码进行规范化、可复现的审查,尤其适用于需要固定规则清单、证据可追溯、结论标准化的团队流程;对 Next.js/React 项目可启用额外的 REACT 与 PERF 规则。

限制

仅审查已暂存的变更;无暂存内容时直接终止。python-generic 与 generic 配置下跳过 REACT-* 与 PERF-* 规则;REPO-007 仅适用于 react-nextjs/react-app,REPO-008 仅适用于 react-nextjs。检测失败默认 generic。大型变更受上下文预算与采样限制,部分低优先级文件可能未审查并需注明。具体规则定义、严重级别映射、报告模板与语言 grep 模式依赖 references 下的 review-rules.md、report-template.md、language-patterns.md,资料未提供其完整内容。