prd

用途

prd 技能用于创建、更新或列出 PRD（产品需求文档）。每个 PRD 是一个自包含的功能规格，带有状态和优先级。它处理项目初始化（第一个 PRD）以及持续的 PRD 管理，适用于功能（feat）、修复（fix）和杂项事务（chore）。

主要能力

创建、更新单个 PRD，或列出处于活跃（非归档）状态的 PRD 摘要。
管理项目级上下文：当这是首个 PRD 或项目范围变化时更新 tasks/context.md，捕获持久决策或约束。
分配和维护全局唯一的特性 ID（f-## 格式），在 tasks/ 与 tasks/archive/ 中取最大值加一，更新时保留原 ID。
在需要时以编号选项方式提问澄清问题，支持类似 1A、2C 的低击键回复。
按优先级（P0 优先）再按特性 ID 排序展示 PRD 列表，并推荐最高优先级的 ready 状态 PRD 作为下一步实现候选。

使用方式

创建 / 更新（默认模式）

判断意图：新项目（无 tasks/context.md 或为空）时先问项目定义问题、初始化 tasks/context.md 写入项目概要，再写第一个 PRD；项目已存在时直接创建新 PRD；更新已有 PRD 时定位文件并就地编辑。
读取上下文：如果存在 tasks/context.md，浏览项目概要、关键决策、笔记/注意事项，避免与先前决策冲突。
分配特性 ID：扫描 tasks/ 和 tasks/archive/ 中的 PRD 文件取最大 f-## 编号，新 PRD 使用最大值加一，更新时保留现有 ID。
仅在需要时提出澄清问题（编号 A/B/C/D 选项，最多约 7 个）。
确定 PRD 文件路径：在 tasks/ 中查找匹配特性 ID 的活跃 PRD（tasks/f-##-*.md），若存在则使用（就地更新），否则使用 tasks/f-##-<feature-slug>.md。
使用 references/prd-template.md 写入或更新 PRD，在 Summary 部分设置 Status: 和 Priority:；新 PRD 默认 Status: draft；Priority 使用 P0（关键）、P1（高）、P2（中）、P3（低）；确保通过清单项可追踪实现进度；对 UI/UX 密集型功能，包含预期设计输入并说明设计是否应先于实现。
更新上下文：若是首个 PRD 或项目范围变化，更新 tasks/context.md 中的项目概要，捕获持久决策或约束。
回复更新后的文件路径和简短变更摘要。

列表模式

扫描 tasks/ 中匹配 f-##-*.md 的文件（排除 tasks/archive/）。
从每个文件的 Summary 部分提取：特性 ID、名称、Type、Status、Priority。
按优先级（P0 优先）再按特性 ID 排序展示。
推荐最高优先级的 Status: ready PRD 作为下一步实现候选。
列表模式不修改任何文件。

澄清问题（仅在需要时）

最多提约 7 个高价值问题，可用 1A、2C、3B 方式回答。聚焦以下方面的歧义：目标用户与主要用例、问题与期望结果、约束（平台、时间线、集成）、成功指标/如何判断有效、范围边界（明确包含与排除）、类型是 feat/fix/chore、优先级（P0/P1/P2/P3）、特性间依赖（按 ID）。

示例问题格式：

What are we building? A. A brand new feature B. A fix for existing behaviour C. A maintenance/chore item D. Other: [describe]

适用场景

适用于功能开发、缺陷修复和杂项事务的需求文档管理，尤其适合需要让初级开发者或其他 AI 在无需额外上下文的情况下实现 PRD 的团队。也适合需要按优先级梳理和推荐下一步实现目标的场景。

限制与约束

不实现代码。
保持功能“PRD 大小”：一个功能 = 一个 PRD。若功能跨越超过 2 个子系统、超过 1 个 UI 层加后端，或约超过 1 天工作量，则应拆分。
不使用 Markdown 表格（使用清单加项目符号）。
特性名称优先使用动词短语（如 "Invite teammates"、"Export CSV"）。
fix 项应清晰命名并设置 Type: fix，包含最小缺陷信息：当前行为、期望行为、复现步骤（如已知）。
chore 应简洁且面向结果（如 "Chore: remove dead code"）并设置 Type: chore。
避免实现任务（"refactor"、"set up DB"），除非它们确实是面向用户的需求。
更新规则：就地更新，不创建重复 PRD（除非用户要求），不重置现有清单项，除非用户明确要求否则保留现有 Status: 和 Priority:，特性 ID 稳定且全局唯一，新特性使用最大值加一，不复用旧 ID。
若已有 PRD，就地更新，不创建重复。

质量检查清单

保存前需确认：PRD Summary 包含 Feature ID、Type、Status、Priority；Feature ID 唯一且稳定（对照 tasks/ 和 tasks/archive/ 中现有 PRD 检查）；更新现有 PRD 时保留原有 story/task 复选框（未重置）；若 PRD 已存在则就地更新（无重复）；每个功能有用户可见结果和明确范围边界（目标加非目标）；依赖引用有效特性 ID；验收标准具体且可验证；PRD 与 tasks/context.md 一致（或本次运行已更新 tasks/context.md）。

输出

创建或复用 tasks/；保存/更新选定路径的 PRD；当持久决策或项目范围变化需要时更新 tasks/context.md；对 UI/UX 密集型 PRD 建议在实现前先做设计（可选）；建议下一步操作：若 Status: draft 建议细化为 ready，若 Status: ready 建议实现；最后以简短状态块结束，包含 Files changed（创建/更新的文件列表）、Key decisions（所做的假设或选择，如有）、Next step（推荐的下一步技能或操作）。