SuperAPI AI 工具集

doc-spec-reviewer

通用与其它

查看项目

更新于 10-16 03:03

技能介绍

用途:对技术规格(SPEC)文档做深度内容审查与质量保证,是生成 TSPEC/TASKS 前的最终 QA 关口,位于第 9 层(SPEC Quality Assurance)。上游为 SPEC,下游无。

主要能力:执行 10 项检查——结构合规(嵌套文件夹规则,阻塞性)、13 节 YAML 结构完整性、REQ 覆盖、外部/内部/类接口定义完整性、阈值注册表与上游一致性、数据模型完整性、错误处理覆盖、占位符([TODO]/[TBD]/模板值)检测、命名合规(SPEC.NN.xxxx 格式)、上游漂移检测(对比 REQ/CTR 文档哈希)。自动修复格式类内容问题,其余标记为需人工复核,并输出含评分与问题清单的报告。

使用方式:在 doc-spec-autopilot 生成 SPEC 之后、手动编辑 SPEC 之后、运行 doc-tasks-autopilot 或 doc-tspec-autopilot 之前使用。命令:/doc-spec-reviewer SPEC-03、/doc-spec-reviewer docs/09_SPEC/SPEC-03.yaml、/doc-spec-reviewer all。报告存放于 SPEC 嵌套文件夹,命名为 SPEC-NN.R_review_report_vNNN.md,版本自动递增。漂移检测使用强制缓存 docs/09_SPEC/.drift_cache.json,哈希通过 sha256sum 与 yq 计算。

评分:满分 100,PASS ≥90,WARNING 80-89,FAIL <80;结构检查未通过则阻塞后续检查。

限制:SPEC 尚不存在时应先用 doc-spec 或 doc-spec-autopilot;仅需结构/模式校验时用 doc-spec-validator;不生成新 SPEC 内容。具体安装步骤与收费信息暂未提供。