SuperAPI AI 工具集

doc-prd-fixer

通用与其它

查看项目

更新于 10-16 02:28

技能介绍

用途:读取最新审计报告(.aidoc/audit/02_PRD-audit.md)并据此修复 PRD,使审计与修复循环收敛;属于第 2 层(PRD 质量改进)。适用场景为 doc-prd-audit 返回 FAIL 之后,不适用于创建新 PRD(应使用 doc-prd 或 doc-prd-autopilot),也不应在没有审计报告时使用。

主要能力(按修复阶段 0–7):0 结构调整(嵌套目录规则,移动至 docs/02_PRD/PRD-NN_{slug}/ 并修正相对链接);1 补建被引用但缺失的文件占位;2 修复断开或绝对路径链接,改为相对路径;3 元素 ID 重派生(PRD.{doc_id}.{section_id}.{hash},移除旧式 FR-/US-/AC-/F- 前缀,已有合法 ID 不重派生);4 内容占位与缺失小节补全,标记 TODO/TBD;5 引用与可追溯性(补 @brd:/@prd: 标签,更新矩阵);6 上游元数据与漂移合并(<5% 自动合并、5–15% 合并并记 changelog、>15% 归档重生成,删除内容标 [DEPRECATED] 保留);7 风格(禁用短语、超长段落、frontmatter 不一致)。每项修复标注 auto-safe / auto-assisted / manual-required 置信度。

使用方式:团队模式下读取 verdict.json 与 per-persona 槽位,按 lens→agent 映射派发验证,把输出写入 .aidoc/review/02_PRD/<PRD-id>/<persona>.fix_<N>.json,出现新 P0/P1 则回退;再派发 synthesizer 生成 .aidoc/remediation/02_PRD-fix.md。single_pass 模式直接应用阶段 0–7,不做 lens 验证。入口命令示例:mkdir -p .aidoc/review/02_PRD/<PRD-id>/ && date +%s > .aidoc/review/02_PRD/<PRD-id>/.skill-start.fixer。会写入 saga.json(如存在),超 SOFT_DEADLINE 1500s 时以 PARTIAL_TIMEOUT 退出。报告格式为 PRD-NN.F_fix_report_vNNN.md。限制:编辑前须备份,报错时恢复;不得删除现有内容;不重新引入已关闭的可选小节;具体平台与收费信息暂未提供。