SuperAPI AI 工具集

doc-req-reviewer

编程与开发

查看项目

更新于 10-16 03:36

技能介绍

用途:doc-req-reviewer 用于对原子需求(REQ)文档做深度内容审查与质量保障,是 SPEC/CTR 生成前的最终 QA 关口。它不同于只做结构与模式校验的 doc-req-validator,重点在内容质量与实现就绪度。

主要能力:包含结构合规(11 段 MVP 嵌套目录规则,阻塞性)、需求原子性、SYS 对齐、验收标准质量(功能≥10、质量≥5,覆盖 Logic/Validation/State/Edge/Security)、实现路径完整性、单元测试类别覆盖、交叉链接完整性、占位符检测、命名合规,以及上游 SYS 漂移检测。漂移缓存文件为 docs/07_REQ/.drift_cache.json,使用 sha256sum <file_path> | cut -d' ' -f1 计算哈希,采用加载/检测/更新三阶段算法,缓存更新为强制步骤。评分按类别加权合计 100 分:PASS ≥90,WARNING 80-89,FAIL <80。

使用方式:命令如 /doc-req-reviewer REQ-03、/doc-req-reviewer REQ-03-001、/doc-req-reviewer docs/07_REQ/REQ-03_f3_observability/、/doc-req-reviewer all。报告随文档存放于嵌套目录,命名 REQ-NN.R_review_report_vNNN.md,版本自动递增并支持 Delta 报告。该技能在 doc-req-autopilot 第 5 阶段被调用。

适用场景与限制:适合 REQ 生成后、手动编辑后、运行 doc-spec-autopilot 或 doc-ctr-autopilot 前以及周期性审查。REQ 尚不存在时不可用;仅需结构校验时用 doc-req-validator;生成新内容用 doc-req。资料未提供安装命令、收费或平台信息。