PRD 技能

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

什么是 PRD？

PRD（Product Requirements Document，产品需求文档）是一份结构化的规格说明，其作用包括：

1. 将功能拆分为小型、相互独立的用户故事
2. 为每个用户故事定义可验证的验收标准
3. 按依赖关系排序任务（schema → backend → UI）

快速开始

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

prd.json 格式

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

字段说明

用户故事规模控制

每个用户故事应可在单次上下文窗口内完成。

✅ 规模适中：

• 添加数据库列及对应迁移脚本
• 向现有页面添加一个 UI 组件
• 用新逻辑更新服务端 Action
• 向列表中添加筛选下拉框

❌ 规模过大（需拆分）：

• “构建整个仪表盘” → 拆分为：schema、查询逻辑、UI、筛选器等子项
• “添加身份认证” → 拆分为：schema、中间件、登录 UI、会话管理等子项

用户故事执行顺序

用户故事按 priority 字段升序执行。前置故事不得依赖后续故事。

正确的执行顺序为：

1. Schema / 数据库变更（迁移脚本）
2. 服务端 Action / 后端逻辑
3. 依赖后端的 UI 组件
4. 仪表盘 / 汇总视图

验收标准

必须是可验证的，不可模糊。

✅ 良好示例：

• “在 tasks 表中添加 status 列，默认值为 'pending'”
• “筛选下拉框包含选项：All、Active、Completed”
• “Typecheck 通过”

❌ 不良示例：

• “功能正常工作”
• “用户可以轻松完成 X 操作”

务必包含："Typecheck passes"

进度跟踪

当某个用户故事完成时，将其 passes 字段更新为 true；使用 notes 字段记录运行时观察结果：

"notes": "迁移脚本中使用了 IF NOT EXISTS"

速查表

参考资料

详见 references/ 目录下的详细文档：

• agent-usage.md — AI 代理如何执行 PRD（Claude Code、OpenCode 等）
• workflows.md — 串行工作流模式
• output-patterns.md — 模板与示例