用途:在 PRD 已存在、生成 EARS 之前运行统一审计——声明式结构检查加内容质量评审,一次通过产出合并报告(.aidoc/audit/02_PRD-audit.md),供 ../doc-prd-fixer/SKILL.md 消费,并可选触发修复循环。框架本身不含运行时代码,本技能即校验器,由 Claude 依据规范作为契约逐项检查。不要用它创建 PRD(那是 doc-prd 或 doc-prd-autopilot 的职责)。策略:每次从头审计,不复用旧分数或缓存,独立计算 EARS-Ready 分数;报告为单文件原地覆盖,PRD-NN.F_fix_report_v*.md 与 .drift_cache.json 保留。输入:PRD 路径与可选分数阈值(默认 90)。
主要能力:1) 必做模板一致性枚举,加载 PRD-TEMPLATE.yaml,列出所有必需章节,缺失即阻塞性发现;2) Tier 1 阻塞检查:元素 ID 格式 PRD.NN.SS.xxxx(4 位十六进制哈希,SS 为宿主章节)、结构与章节非空、@brd: 标签存在且可解析、§10 客户面向内容至少 3 类实质内容、EARS-Ready 分数达阈值;3) Tier 2 建议项:frontmatter 元数据、§8 层级分离说明、内部链接与模板/治理引用可解析、未存在的 ADR 编号不予引用、阈值跨章节与 BRD 一致、图契约标签;4) 写作风格检查,违规短语或超尺寸可升级为阻塞。
使用方式:review_mode 从 .aidoc/profile.yaml 解析,未设置则按优先级回退框架默认——闸门(pre_promotion/pre_merge)用 team 模式,写入时(on_author)用 single_pass。team 模式下按 REVIEW_CREWS.yaml 的权重(product_owner 30、architect 25、tech_lead 20、chaos_engineer 8、security_engineer 7、auditor 10)经 Task 子代理并行评审,写入 .aidoc/review/02_PRD/<PRD-id>/ 黑板槽位,再由 synthesizer 产出 verdict.json 与 report.md;单遍模式在自身上下文顺序应用全部视角,不适用法定人数。两种模式下结构闸门都在本技能内确定性执行。saga 交互:由 autopilot 触发时读写 .aidoc/review/02_PRD/<PRD-id>/saga.json,进入时记录 start epoch,扇出前后更新分支状态,合成前以 SOFT_DEADLINE 1500 秒做断链检查,超时以 PARTIAL_TIMEOUT 干净退出;独立调用或无 saga.json 时不初始化 saga,跳过所有转换。
限制:不创建 PRD;不自行重试,重调由驱动方负责;PARTIAL_TIMEOUT 视为 FAIL;法定人数未达标记低置信度交人工审查,而非静默通过;最终 stdout 需逐键镜像 verdict.json,且不得回显 PRD 自评分数。其余字段校验规则、图标签细节与部分元数据要求,资料未完整给出。