SuperAPI AI 工具集

spec-review

设计与创作

查看项目

更新于 10-16 05:01

技能介绍

用途:在批准 spec、设计文档、RFC、ADR 或实施计划之前,做一次对抗式预批准审查,提前暴露通常在后期甚至生产环境才出现的缺口。适用于文档即将获批、作者想先获得批判性审查、或自动化流程需要一致的预批准审查步骤时;不适用于审查代码/差异(应用代码审查技能)、起草文档(应用内容/模板技能)或没有设计内容的非结构化文字。

主要能力:按检查清单逐类找缺口,包括引导与所有权、命名是否诚实、规模与上限、隐藏假设、与已发布代码的一致性、幂等性/失败/重跑、安全面、必要性与更简单替代方案、完整性与清晰度。关键能力是对照实际代码库验证文档声明,而非轻信文字表述。

使用方式:输入为待审查文档路径(必需),可选代码库模块指针和输出偏好(默认内联,或写入文档旁的 review.md)。先通读全文,再按检查清单找缺口;对涉及现有行为、路径或接口的发现,读取或 grep 被引用模块并引用 file:line;无法确认的缺口标注为 unverified;仅验证文档引用的模块,不扫描整个仓库。每条发现包含严重级别(blocker/important/minor)、类别、位置、缺口、具体修复建议和证据,最后给出 ready-for-approval 或 has-blockers 的单行结论。大型或高风险文档可选派发无上下文的全新审查者做独立审查,再合并去重结果。

限制:该技能只审查,绝不编辑文档,也绝不代替人类批准或拒绝,只给出建议。严禁凭猜测断言,未验证的缺口必须明确标注。全新系统缺少可验证代码不构成缺口。相关代码审查技能负责代码/差异。具体命令与安装方式资料未提供。