SuperAPI AI 工具集

change-traceability-review

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:审查一次变更背后的可追溯性,而非代码风格。追溯链路为 Story 或 issue → Spec → 计划/任务 → commit/分支/PR → diff → 测试 → 风险。默认使用中文,报告保持紧凑、面向决策。以规格作为审查的事实来源;当代码清晰服务于规格时,代码可被接受。

三种模式:

  1. 规格准备(Spec Preparation):在实现或提交之前,创建或收紧与 Story 关联的规格,定义验收场景、计划/任务、测试与风险证据,供后续提交引用。需加载 Spec Contract。
  2. 审查就绪检查(Review Readiness Check):在审查或合并前检查当前 diff、暂存 diff、PR 文本、分支或选定提交。需加载 Mode Rules 与 Reporting。
  3. 审查回顾(Review Retrospective):检查近期历史,通常为最近 30 个提交,识别提交信息习惯、薄弱可追溯性、缺失的 Spec/测试/风险证据、过大或范围混杂的提交、规格文档模式与返工信号。需加载 Mode Rules 与 Reporting。

入口与路由:从用户请求或当前审查面识别模式;先读取仓库说明,如最近的 AGENTS.md、插件清单以及目标规格或 diff;使用 Evidence Commands 收集有边界的本地证据;应用相应契约(规格准备用 Spec Contract,提交用 Commit Contract,任何审查用 Mode Rules);最后用 Reporting 生成报告。生成的辅助工具与本地实验应放在 SKILL.md 之外,除非它们是该技能必须使用的持久资源。

限制:资料未提供具体命令、安装方式、收费与平台信息。