prd

用途

prd 是一个产品需求编排器，用于编排产品需求处理流程，自动路由到 brainstorm 或 PRD 解析，产出结构化需求包供 keel 消费。其核心价值是弥补 keel 对模糊想法和大型 PRD 的处理不足，提供从需求探索到结构化输出的完整路径。

一句话概括：处理模糊想法或大型 PRD 文档，产出结构化 FR-XX/NFR-XX 需求。

主要能力

• 自动检测输入类型并路由：输入少于 200 字且无结构化标记时进入 brainstorm 完整模式；输入超过 2000 字或引用大文件时进入 prd-parser 加逐块 brainstorm；用户明确指定模式时直接路由；模糊区间（200~2000 字）时通过 AskUserQuestion 确认。
• 支持中英文提问，统一中文回复。
• 单需求脚手架原则：docs/prd/ 为当前需求的一次性脚手架，扁平结构，任一时刻只服务一个在飞需求，不维护跨需求的全局索引、编号注册表、归档或迭代链。
• 新建需求门禁：进入新建路径前检测 docs/prd/requirements/index.md 是否已存在，已存在时必须三选一确认（继续当前需求 / clear 清理后新建 / 显式 discard 后新建），未确认前禁止直接覆盖新建。
• 上下文感知：启动时自动检测是否存在已有系统，委托 codebase-insight 读取 docs/codebase-insight.md，检测 docs/devdocs/01-requirements.md 提取已有 F/US 列表，并按 references/design-context.md 探测设计资产。
• --revise 模式：允许对单个 FR 重新进入 brainstorm 澄清，保持原 id 和编号不变，原地覆盖并更新 index.md，若已有 keel 映射则将 mapping_status 置为 outdated。
• 跨块合成：PRD 场景中所有块澄清完成后，执行全局术语表、共享假设与约束、横切 NFR、冲突与重复解决的合成，写入 requirements/index.md。
• 成熟度标记：轻量三级标记 idea / draft / ready，建议性不硬阻塞。
• 假设挑战：ready 评估前对全局需求进行假设有效性审查，结论记入 index.md 的「假设挑战」节。
• ready 门槛检查：检查主要用户角色、范围边界、验收意图、块状态、假设挑战等，未满足时标注缺失项，用户可选择仍然进入 keel。
• keel 桥接：整体 maturity=ready 时主动推荐运行 /requirements --from-prd docs/prd/requirements/index.md。
• 清理脚手架：/prd clear 在需求 close 后清理 docs/prd/，默认 --dry-run，--apply 才物理删除，孤儿/未同步项默认不删。

使用方式

运行模式：

• /prd：自动检测输入类型（默认感知已有系统）
• /prd brainstorm：强制头脑风暴模式
• /prd prd：强制 PRD 解析模式
• /prd --revise FR-03：单个 FR 重新 brainstorm
• /prd clear [--dry-run|--apply]：清理当前需求脚手架（close 收尾用）

编排流程：

• 头脑风暴（idea → requirements）：Task: prd-brainstorm（完整模式），按 5W1H → 用户旅程 → MoSCoW 收敛，生成 requirements/ 小文档加 index.md。
• PRD 解析（大文档 → chunks → requirements）：先 Task: prd-parser 转换拆分，再逐块 Task: prd-brainstorm --chunk，然后跨块合成，生成/更新 index.md，最后成熟度评估。
• PRD 更新（增量处理）：prd-parser 重新拆分并计算新 document_fingerprint，通过 chunk_key 匹配新旧块对比 source_fingerprint，仅对 outdated/pending 块调用 prd-brainstorm，更新 index.md。

文件产出路径：

docs/prd/ +-- chunks/ <- PRD 原文完整文本化副本（仅 prd-parse 路径产生） | +-- FR-XX-<topic>.md | +-- NFR-XX-<topic>.md +-- requirements/ <- brainstorm 澄清后的结构化需求 | +-- index.md <- 本需求总纲（含跨块合成结果 + keel 映射表） | +-- FR-XX-<topic>.md | +-- NFR-XX-<topic>.md +-- source/ <- 原始文件来源记录（.gitignore 排除） +-- manifest.md +-- original-prd.md

适用场景

• 产品想法尚模糊，需要从一句话或简短想法出发进行头脑风暴并收敛为结构化需求。
• 已有大型 PRD 文档，需要拆分、逐块澄清并合成结构化需求包。
• PRD 文档发生更新，需要增量处理，仅对变化块重新澄清。
• 需要对单个 FR 进行修订而不重新提交整个需求。
• 需求 close 上线后，需要清理一次性脚手架。

限制

• 需求已明确时不适合使用本技能，应改用 /requirements。
• 不维护跨需求的全局索引、编号注册表、归档或迭代链，多需求并行经实践证伪已移除。
• FR-XX/NFR-XX 为 product 阶段唯一 ID，不分配 F/US/AC 编号，编号权属于 keel。
• 需求文件存放于 docs/prd/，不写入 docs/devdocs/。
• 成熟度标记为建议性，不硬阻塞流程；maturity=idea 时不主动推荐 keel 衔接。
• 阶段间只传递 YAML 摘要、文件路径、新增编号列表，编排 Agent 不读取子技能完整输出文档内容做编排决策。
• 子 Agent 返回 status: failed + blockers 时，展示阻塞项并询问用户修复/跳过/终止，不自行读取文档排障。
• 详细文档引用：PRD 修订边界见 references/governance/prd-revision-policy.md，PRD ↔ keel Mapping 见 references/governance/prd-devdocs-mapping.md，共享约束 SSOT 见 ../shared/constraints.md。