用途:doc-req-fixer 位于第 7 层(REQ 质量改进),用于在 doc-req-reviewer 识别问题后自动修复 REQ 需求规格文档,连接评审与修正后的 REQ,支持迭代改进循环。
上游输入:REQ 文档、评审报告(优先 REQ-NN.A_audit_report_vNNN.md,兼容 REQ-NN.R_review_report_vNNN.md,或 REQ-NN-SSS.R_review_report_vNNN.md)、SYS(用于系统设计对齐)。下游输出:已修复 REQ、修复报告(REQ-NN.F_fix_report_vNNN.md 或 REQ-NN-SSS.F_fix_report_vNNN.md)。
适用场景:评审之后运行;评审—修复—评审循环;CI/CD 质量门禁自动化流水线;基于评审报告批量修复多个 REQ 文档。不适用于:无评审报告(需先运行 doc-req-reviewer);创建新 REQ(用 doc-req 或 doc-req-autopilot);仅需校验(用 doc-req-validator)。
主要能力:按阶段修复。Phase 0 修复结构违规(REQ 必须位于嵌套文件夹,如 docs/07_REQ/REQ-NN_{slug}/REQ-NN_{slug}.md,并更新相对路径如 ../06_SYS/ 改为 ../../06_SYS/);Phase 1 创建缺失文件(REQ-00_INDEX.md、REQ-00_GLOSSARY.md、UC 占位、REF 占位);Phase 2 修复断链(更新路径或建目标文件、绝对转相对、补 SYS 追溯链接);Phase 3 修复元素 ID(将 REQ.NN.13.SS 等无效类型码转为有效码 01/05/06/27,转换旧式 FR-/NFR-/UC-/AC-);Phase 4 修复内容(替换模板日期、[Status] 默认 Draft、[Priority] 默认 P2、[Version] 默认 0.1,标记 TODO/TBD 待人工补全);Phase 5 更新引用与追溯矩阵;Phase 6 处理上游漂移,按变更百分比分级自动合并(Tier 1 <5% 补丁版本自动合并,Tier 2 5–15% 带变更日志小版本合并,Tier 3 >15% 归档重生成并需人工审查),含哈希校验修复(FIX-H001/H002/H003,命令示例 sha256sum <upstream_file_path> | cut -d' ' -f1)。
限制:部分问题无法自动修复,如 [TODO]/[TBD] 占位符需人工完成;Monolithic REQ 超 25KB 仅标记人工评审;缺失上游文件只能部分修复;无效文件命名无法自动修复。具体安装、配置与运行方式资料未提供。