SuperAPI AI 工具集

doc-tasks-fixer

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

doc-tasks-fixer 属于 TASKS 质量改进层(Layer 11),用于在评审后自动修复 TASKS 实现任务文档。其上游为 SPEC、TSPEC、TASKS 文档及审计/评审报告(首选 TASKS-NN.A_audit_report_vNNN.md,兼容 TASKS-NN.R_review_report_vNNN.md),下游产出修复后的 TASKS 与 Fix Report(TASKS-NN.F_fix_report_vNNN.md)。

适用场景:评审后修复、评审→修复→评审迭代、CI/CD 质量门禁、批量修复、实现契约结构问题。不适用于:无评审报告(应先运行 doc-tasks-reviewer)、新建 TASKS(用 doc-tasks 或 doc-tasks-autopilot)、仅需校验(用 doc-tasks-validator)。

修复阶段:Phase 0 修复结构违规(TASKS 必须置于嵌套文件夹,如 docs/11_TASKS/TASKS-NN_{slug}/TASKS-NN_{slug}.md),并更新相对链接;Phase 1 创建缺失文件(contracts、dependencies、IPLAN 等模板);Phase 2 修复断链,含 SPEC/TSPEC 引用与 Python 导入路径;Phase 3 修复元素 ID(合法类型码为 18 实现任务、30 契约定义);Phase 4 修复内容问题(占位符、模板日期、空章节、契约结构补全),[TODO]/[TBD] 无法自动修复需人工;Phase 5 更新引用与可追溯性标签;Phase 6 处理上游漂移,按变更比例分层自动合并:<5% 打补丁,5–15% 次要版本并记录变更日志,>15% 归档并触发重新生成;哈希修复含 FIX-H001 至 FIX-H003。

使用方式依托其工作流与依赖技能(doc-tasks-reviewer、doc-naming、doc-tasks、doc-spec、doc-tspec),资料未提供具体安装命令或调用指令;收费、平台与效果等事实暂未提供。