该技能用于对 System Requirements(SYS)文档做深度内容审查与质量保障,位于质量保障层(Layer 6),上游来自 SYS(doc-sys-autopilot 或 doc-sys),下游无,是生成 REQ 前的最终 QA 关口。
适用场景:SYS 生成后立即运行;手动编辑 SYS 之后;运行 doc-req-autopilot 之前;对现有 SYS 做周期性检查;系统设计评审期间。不适用于:SYS 尚不存在(先用 doc-sys 或 doc-sys-autopilot)、仅需结构或 schema 校验(用 doc-sys-validator)、生成新 SYS 内容(用 doc-sys)。与 validator 的区别在于本技能聚焦内容质量与 ADR 对齐,validator 聚焦 schema 与格式;本技能输出评审分数与问题清单,validator 输出 REQ-Ready 数值分数,且结构问题会被阻断。
主要检查项:0 结构合规(阻断性,检查 SYS 是否位于嵌套文件夹);1 功能需求完整性;2 ADR 对齐;3 质量属性覆盖;4 接口定义完整性(含 4a 系统图契约合规);5 约束校验;6 占位符检测;7 命名合规;8 上游漂移检测。每项检查配有 REV-* 错误码与严重级别。
用法:命令为 /doc-sys-reviewer SYS-01、/doc-sys-reviewer docs/06_SYS/SYS-01_f1_iam.md 或 /doc-sys-reviewer all。报告存放在被审查文档所在嵌套文件夹中,命名为 SYS-NN.R_review_report_vNNN.md,版本自动递增,可进行分数对比的增量报告。评审分数按各类别加权计算,满分 100,≥90 PASS,80–89 WARNING,<80 FAIL。
上游漂移检测依赖强制缓存文件 docs/06_SYS/.drift_cache.json,采用三阶段算法(缓存初始化、哈希比较、缓存更新),使用 SHA-256;必须实际执行 bash 计算哈希,例如 sha256sum <file_path> | cut -d' ' -f1,禁止写入占位哈希值。缓存状态包括 current、drifted、missing、new。配置默认值包括 cache_enabled=true、drift_threshold_days=7、critical_threshold_days=30、hash_algorithm=SHA-256、tracked_patterns 为 @adr:。
限制:资料未提供具体安装方式、运行环境依赖、收费或价格信息;缓存与嵌套文件夹规则为强制要求;缺失或损坏的漂移缓存会触发 REV-D006;无效占位哈希会触发 REV-D009。