用途
doc-stest-fixer 用于对 STEST 文档中由 validator/reviewer 工作流发现的问题进行修复，采用确定性的来源报告优先级规则。它在典型工作流中位于 doc-stest-audit 之后，负责把审计结论转化为对 STEST 文档的实际修改。
输入契约
首选输入为规范命名的审计报告：STEST-NN.A_audit_report_vNNN.md。同时兼容旧式评审报告：STEST-NN.R_review_report_vNNN.md。选择优先级为：取最新时间戳或版本；若时间戳/版本并列，则优先使用 .A_audit_report_vNNN.md 而非 .R_review_report_vNNN.md。
可修复的问题类别
- 缺少必需章节（6-section contract）
- 缺少或非法的子类型标签（@ears、@bdd、@req）
- 缺少超时或 100%-gate 约束
- 缺少回滚流程要求
- 关键路径检查中使用非二元的通过/失败标准
- 可追溯性与交叉引用的一致性问题
- 为满足嵌套文件夹合规而进行的命名与路径修正
输出
- 修复后的 STEST 文档
- 修复报告：STEST-NN.F_fix_report_vNNN.md
使用方式
命令行示例：
- /doc-stest-fixer STEST-01
- /doc-stest-fixer STEST-01 --review-report STEST-01.A_audit_report_v001.md
- /doc-stest-fixer STEST-01 --review-report STEST-01.R_review_report_v001.md
集成方式
通常在 doc-stest-audit 之后调用；修复后应重新运行 doc-stest-audit 以验证问题闭合并确认修复结果。
版本历史
- 1.0 / 2026-02-27：初始版本，实现确定性的 .A_ 优先、.R_ 兼容的优先级规则，以及严格的部署门禁修复检查。
实现计划一致性（IPLAN-004）
- 将计划派生输出视为有效的来源模式，并依据实现计划的范围与目标验证意图是否得到保留。
- 验证上游 autopilot 的优先级假设：--iplan > --ref > --prompt。
- 将计划上下文与产物输出之间的目标/范围冲突标记为需要澄清的阻塞性问题。
- 不引入诸如 docs-v2.0/00_REF 之类的旧式回退路径。