PRD Skill 用于通过迭代式发现流程，产出可防止需求漂移的产品需求文档（PRD）。其输出为 .claude/reference/PRD.md，即项目的活需求文档。
用途 该技能面向需要创建、更新、校验或分阶段规划 PRD 的场景。它驱动交互式发现、技术架构梳理、阶段 DAG 规划、TDD 协议和依赖分析。
不适用场景
- 用户已有最终规格，只想做实施规划（应使用 /orchestrate 或 /prd --to-plan）。
- 任务是代码审查或仓库健康检查。
- 请求是轻量笔记或 issue，而非完整需求文档。
主要能力与规则
- 生成 PRD 前必须先扫描代码库，避免需求与现有架构冲突。
- 验收标准必须使用 Given/When/Then，禁止写成“should work correctly”。
- 必须进行依赖分析，否则阶段无法安全并行。
- 每轮发现最多 4 个问题，禁止一次性抛出大量问题。
- 不得假设库版本，需检查 package.json 和 npm。
- 阶段规划必须带依赖箭头，形成 DAG。
- 最终 PRD 中不得保留 [NEEDS CLARIFICATION] 标记。
模式路由
- 空参数：创建模式，从零交互式创建 PRD。
- <feature text>：创建模式，先带入上下文再迭代。
- --update：更新模式，对现有 PRD 做增量更新。
- --validate：校验模式，对现有 PRD 运行校验清单。
- --audit-deps：审计模式，仅做依赖/漂移分析。
- --to-plan：计划模式，生成可供 orchestrate 使用的任务计划。
创建模式流程
- 代码库扫描（自动，提问前）：启动 Explore agent 映射相关代码区域，阅读 roadmap/changelog 了解既往决策，检查范围内过时依赖。
- 交互式发现（2–4 轮，每轮最多 4 个问题）：
- 第 1 轮：问题、目标用户、成功标准、人物角色。
- 第 2 轮：MoSCoW 优先级、明确的范围外内容、交互。
- 第 3 轮：架构约束、数据库、认证、性能。
- 第 4 轮（如需）：阶段划分、并行化风险。 第 2 轮前不得起草；不得询问代码库扫描已能回答的问题。
- 起草：读取 template.md，写入 .claude/reference/PRD.md，标记缺口 [NEEDS CLARIFICATION: ...]，填充架构决策（AD-N 条目），构建带明确箭头的阶段 DAG。
- 校验：读取 validation.md，运行所有检查，展示通过/失败，迭代直到关键门禁通过。
- 定稿：移除所有标记，提交：docs(prd): add <feature-name> requirements。
更新模式（--update） 读取现有 PRD；询问变更内容（新需求、范围变更、依赖更新）；启动 Explore agent 检测自上次更新以来的代码库漂移；生成 diff 式更新：[ADDED]、[CHANGED]、[REMOVED]、[DRIFT DETECTED]；提交审批后应用并重新校验。
计划模式（--to-plan） 将 PRD 阶段划分转换为 /orchestrate 就绪的任务计划，输出到 docs/plans/<feature-name>-plan.md。 波次分配规则：
- 第 1 波：模式、类型、迁移、配置（基础）。
- 第 2 波：路由、服务、仓库（实现）。
- 第 3 波：接线、UI、端到端流程（集成）。
- 第 4 波：错误处理、边界情况、文档（打磨）。 Agent 分配规则：
- haiku：类型定义、配置、简单 CRUD、测试编写。
- sonnet：业务逻辑、复杂集成、安全敏感代码。 生成计划前需通过 V5（DAG）校验。
校验模式（--validate） 读取 validation.md 并运行所有门禁，打印通过/失败及行引用。
审计模式（--audit-deps） 读取 drift-prevention.md，运行依赖新鲜度与架构漂移检查。
脚本 bash scripts/check-prd-assets.sh skills/prd node scripts/list-prd-phases.js .claude/reference/PRD.md
参数 /prd — 交互式创建 /prd Workflow Designer — 带入上下文开始 /prd --update — 增量更新 /prd --validate — 仅运行校验 /prd --audit-deps — 仅做依赖审计 /prd --to-plan — 生成 orchestrate 就绪的任务计划