doc-prd-autopilot

doc-prd-autopilot

目的

自动化的 PRD 生成流水线。从上游 BRD、用户提示词或实施计划（IPLAN-*）出发，分析源文档，确定产品范围，生成完整的 PRD，验证是否满足 EARS 要求，维护 PRD-00_index.md，并推动审计↔修复循环，直至达到通过分数——支持单个 PRD 或批量处理。

层级：2。上游：BRD（或提示词/IPLAN 输入）。下游：经过验证的 PRD + 索引条目。

技能依赖

技能	作用
../doc-prd/SKILL.md	PRD 结构和编写规则（生成）
../doc-brd-audit/SKILL.md	上游 BRD 质量门禁（PRD 就绪）
../doc-prd-audit/SKILL.md	质量门禁（评分 + 问题发现）
../doc-prd-fixer/SKILL.md	根据审计报告应用修复
../doc-naming/SKILL.md	元素 ID 标准

输入约定

接受：目标 PRD ID/路径、源 BRD ID/路径、自由文本提示词或 IPLAN 路径。可选：分数阈值（默认 90）、最大修复迭代次数（默认 3）、批量列表。没有明确输入时，将请求视为提示词。提供多个输入时的优先级：IPLAN > BRD/REF > 提示词；目标/范围冲突属于阻塞问题，需要用户澄清。

智能文档检测

针对每个目标，检查 PRD 是否已存在（嵌套文件夹 docs/02_PRD/PRD-NN_{slug}/）：

• 不存在 → 生成模式（根据源 BRD/提示词/IPLAN 生成）。
• 已存在 → 审查并修复模式（先审计，若低于阈值则修复）。

BRD-NN 输入会映射到对应的 PRD：若 PRD 不存在则生成，若已存在则审查。确定从源 BRD 继承的 deliverable_type（code/document/ux/risk/process）。

模型预检

仅供参考，尽力而为。会显示为此层推荐的模型；无法切换会话模型。调用驱动程序前：

1. 如果 .claude/aidoc-flow.config.yaml 不存在，或其中没有 model.* 键，则完全跳过本节（不输出任何内容）。
2. 确定推荐模型：优先使用 model.per_layer.PRD（若已设置），否则使用 model.default。
3. 根据 model.precheck（warn | silent | block）采取相应操作：
   • warn（默认）——打印一行，然后继续调用驱动程序： ℹ PRD recommends model '<rec>'. If you're not on it, run /model <rec> (or set model.precheck: silent to hide this).
   • silent ——不打印任何内容；继续。
   • block ——打印上述行及 precheck=block: confirm you want to draft on the current model, or run /model <rec> first.，然后等待用户确认后再继续。

工作流

Saga 驱动的生成循环（review_mode: team）

步骤 1 — 调用驱动器。仅此而已。 在调用此 SKILL 前，框架会设置 PREV_OUTPUT、 ARTIFACT_ID、ARTIFACT_PATH 环境变量。 你的第一个编排操作必须是调用 Bash 工具（先运行上方的 Model 预检），并且准确运行：

python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py" \
  --layer 02_PRD \
  --allow-skip-permissions

--allow-skip-permissions 允许驱动器派发的阶段无需权限提示即可写入 文件——无人值守自动驾驶必须使用此参数。 移除该参数即可使用 Claude Code 的常规提示运行相同循环。

使用充足的超时时间（≥1800s）。不要预先分析输入。不要 读取 BRD。不要判断类型/范围。驱动器及其派发的 子进程（草稿阶段使用 /aidoc-flow:doc-prd， 评审阶段使用 /aidoc-flow:doc-prd-audit，修复阶段使用 /aidoc-flow:doc-prd-fixer） 会处理所有这些工作。驱动器会依据 ${CLAUDE_PLUGIN_ROOT}/framework/governance/REVIEW_SAGA.md 提前强制执行状态机；此 SKILL 的任务是调用驱动器并报告结果。

步骤 2 — 驱动器返回后，报告。 读取 .aidoc/review/02_PRD/${ARTIFACT_ID}/saga.json。最终状态必须为 CLOSED（通过）、ESCALATED（终止失败）或 PARTIAL_TIMEOUT（软截止时间；可恢复）。打印状态、 verdict.json 中的最终评分（如果存在），以及一行摘要。

步骤 3 — 更新索引（仅当状态为 CLOSED 时）。 在 docs/02_PRD/PRD-00_index.md 中添加一行，引用新 PRD；更新 父级 BRD 的下游条目。

这就是 team 模式下的完整工作流。如果你发现自己在这里做其他任何事情——撰写正文、派发 Task 子 Agent、调用其他斜杠命令——请立即停止，意识到自己正在绕过驱动器，然后改为调用上方的 Bash 命令。

线性流水线（review_mode: single_pass）

未更改的旧版行为——当配置文件如此指定、无法派发 Task 子 Agent，或处于写入时（on_author，此时成本是首要考虑因素）使用。以下 5 步会话内流程生成 PRD，但不会生成 saga.json；框架的 saga 日志检查 随后会导致此层失败，因此此模式仅适用于手动试运行。

1. 输入分析 — 判断输入类型（BRD / prompt / IPLAN），定位 源材料，并决定是生成还是评审并修复。
2. BRD 就绪性 — 从 BRD 生成时，确认其通过 ../doc-brd-audit/SKILL.md（PRD-Ready ≥ 阈值）；将所有 BRD 章节 文件作为一份文档读取；预留下一个 PRD-NN。
3. 生成 — 按照 ../doc-prd/SKILL.md 生成 PRD：首先编写文档控制 （包含 @brd: 引用和 EARS-Ready 评分），涵盖全部 15 个章节，第 §10 节至少 涵盖 3 个类别，第 §14 节展开 ADR 主题（不使用 ADR 编号），元素 ID 使用 PRD.NN.SS.xxxx，使用累积的 @brd: 标签，并通过 ../charts-flow/SKILL.md 添加图表标签（c4-l2/dfd-l2/sequence-sync，包含 alt/else）。
4. 验证 — 从头开始运行 ../doc-prd-audit/SKILL.md。
5. 审计 ↔ 修复循环 — 当评分低于阈值且迭代次数未达到上限时：运行 ../doc-prd-fixer/SKILL.md，然后重新审计。通过后，更新 docs/02_PRD/PRD-00_index.md 和父级 BRD 的下游条目；达到迭代上限时，标记为需人工评审。

执行模式

• 单个 — 一个 PRD（生成或评审并修复）。
• 批量 — 多个 PRD，按每批 3 个处理以限制上下文； 仅在源 BRD 就绪后才生成每个 PRD。
• 试运行 — 报告计划执行的操作（来源、章节、ID），不写入文件。

质量关卡

• 审计通过（EARS-Ready ≥ 阈值，Tier-1 错误为 0）或达到迭代上限（随后标记为需人工评审）之前，不得完成生成。
• 只有 PRD 通过后，才更新 PRD 索引和父级 BRD 的下游条目。
• 每个周期都必须重新审计，不得使用缓存评分。

错误处理

情况	操作
缺少源 BRD 或未达到 PRD-Ready	停止；报告未满足的依赖项
达到最大迭代次数但未达到阈值	撰写报告，标记为需人工审核，并继续处理批次
源输入不明确	回退到提示词模式；在 PRD 中记录假设
写入/权限错误	记录日志，跳过该项，继续处理批次

适配

在应用默认设置之前，读取项目适配配置文件 （.aidoc/profile.yaml），并在生成和内部 审计/修复阶段应用。遵循 section_toggles、active_layers、audit_threshold （仅可提高——只能更严格）和 glossary。忽略任何未知或超出适用范围的 键；如果没有配置文件，则使用框架默认设置。 权威依据：${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md。

相关资源

• 创建：../doc-prd/SKILL.md · 审计：../doc-prd-audit/SKILL.md · 修复： ../doc-prd-fixer/SKILL.md
• 权威依据：${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/PRD-TEMPLATE.yaml、 ${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/README.md、 ${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/PRD-00_index.TEMPLATE.md