名称： prd
描述： 创建和管理产品需求文档（PRD）。适用于：(1) 创建包含用户故事的结构化任务清单，(2) 用验收标准定义功能，(3) 为AI智能体或人类开发者规划功能实现。
作者： Benjamin Jesuiter bjesuiter@gmail.com
元数据：
clawdbot:
emoji: "📋"
os: ["darwin", "linux"]

PRD 技能

为功能规划创建和管理产品需求文档（PRD）。

什么是 PRD？

PRD（产品需求文档） 是一种结构化规范，它能够：

1. 将功能拆分为小而独立的用户故事
2. 为每个故事定义可验证的验收标准
3. 按依赖关系（数据库结构 → 后端 → 用户界面）对任务进行排序

快速开始

1. 在项目中创建/编辑 agents/prd.json
2. 定义包含验收标准的用户故事
3. 通过更新 passes: false → true 来跟踪进度

prd.json 格式

{
  "project": "MyApp",
  "branchName": "ralph/功能名称",
  "description": "功能的简短描述",
  "userStories": [
    {
      "id": "US-001",
      "title": "向数据库添加优先级字段",
      "description": "作为一名开发者，我需要存储任务优先级。",
      "acceptanceCriteria": [
        "添加优先级列：'high' | 'medium' | 'low'",
        "生成并运行迁移",
        "类型检查通过"
      ],
      "priority": 1,
      "passes": false,
      "notes": ""
    }
  ]
}

字段说明

故事规模

每个故事应能在一个上下文窗口内完成。

✅ 规模适中：

• 添加数据库列并执行迁移
• 在现有页面添加一个 UI 组件
• 用新逻辑更新服务器操作
• 为列表添加筛选下拉框

❌ 规模过大（应拆分）：

• "构建整个仪表盘" → 拆分为：数据库结构、查询、UI、筛选器
• "添加身份验证" → 拆分为：数据库结构、中间件、登录UI、会话管理

故事排序

故事按优先级顺序执行。较早的故事不得依赖于较晚的故事。

正确顺序：
1. 数据库结构变更（迁移）
2. 服务器操作 / 后端逻辑
3. 使用后端的 UI 组件
4. 仪表盘/汇总视图

验收标准

必须可验证，不能模糊。

✅ 良好示例：

• "向 tasks 表添加 status 列，默认值为 'pending'"
• "筛选下拉框包含选项：全部、进行中、已完成"
• "类型检查通过"

❌ 不良示例：

• "正常工作"
• "用户可以轻松地做 X"

始终包含： "类型检查通过"

进度跟踪

当故事完成时，更新 passes: true。使用 notes 字段记录运行时观察：

"notes": "迁移使用了 IF NOT EXISTS"

快速参考

资源

查看 references/ 目录下的详细文档：
- agent-usage.md - AI 智能体如何执行 PRD（Claude Code, OpenCode 等）
- workflows.md - 顺序工作流模式
- output-patterns.md - 模板和示例