PRD技能

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

什么是PRD？

一份产品需求文档是一种结构化规范，它：

1. 将功能分解为小而独立的用户故事
2. 为每个故事定义可验证的验收标准根据
3. 依赖关系（架构 → 后端 → 前端界面）对任务进行排序快速开始

在项目中创建/编辑

1. agents/prd.json文件定义带有验收标准的用户故事
2. 通过更新
3. passes: false为true来跟踪进度 prd.json 格式

prd.json Format

{
  "project": "MyApp",
  "branchName": "ralph/feature-name",
  "description": "Short description of the feature",
  "userStories": [
    {
      "id": "US-001",
      "title": "Add priority field to database",
      "description": "As a developer, I need to store task priority.",
      "acceptanceCriteria": [
        "Add priority column: 'high' | 'medium' | 'low'",
        "Generate and run migration",
        "Typecheck passes"
      ],
      "priority": 1,
      "passes": false,
      "notes": ""
    }
  ]
}

字段说明

用户故事规模确定

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

✅ 规模适中：

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

❌ 规模过大（应拆分这些）：

• "构建整个仪表板" → 拆分为：模式、查询、UI、筛选器
• "添加身份验证" → 拆分为：模式、中间件、登录UI、会话

故事排序

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

正确的顺序：

1. 模式/数据库变更（迁移）
2. 服务器操作 / 后端逻辑
3. 使用后端的UI组件
4. 仪表板/概览视图

验收标准

必须可验证，不能含糊。

✅ 良好示例：

• "向任务表添加状态列，默认值为'待处理'"
• "筛选下拉菜单包含选项：全部、进行中、已完成"
• "类型检查通过"

❌ 不良示例：

• "工作正常"
• "用户可以轻松完成X"

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

进度跟踪

当故事完成时，更新通过：是。使用备注字段记录运行时观察结果：

"notes": "Used IF NOT EXISTS for migrations"

快速参考

资源

见references/获取详细文档：

• agent-usage.md- AI代理如何执行产品需求文档（Claude Code、OpenCode等）
• workflows.md- 顺序工作流模式
• output-patterns.md- 模板与示例