plan-create-stories

创建故事：PRD → 工单待办列表

概述

将完成的 PRD 转化为一组小而规范的工单。PRD 中的每个实施阶段都会成为一组工单；每个用户故事会成为一个或多个工单，并附上明确的验收标准。

此技能在设计上与平台无关——--platform 标志决定待办列表创建在 Jira 还是 GitHub Issues 中。在该标志之前的所有步骤（阅读 PRD、拆解内容、编写验收标准）都完全相同。

参数

参数	必填	含义
<prd-path>	是	plan-create-prd 生成的 PRD 路径
--platform	是	jira 或 github——工单创建的平台
--project	仅限 jira	Jira 项目键（例如 HELP）
--epic	仅限 jira	用作工单父级的 Jira epic 键（例如 HELP-1）
--milestone	仅限 github	可选的 GitHub 里程碑，用于关联议题

如果缺少 --platform，请停止并询问——不要猜测。

工作流

1. 阅读并拆解 PRD

• 完整阅读 <prd-path>。
• 查看 Implementation Phases 部分。每个阶段对应一组工单。
• 查看 User Stories 部分。每个故事对应一个工单（如果其中包含超过约一天工作量的内容，则拆分）。
• 为每个工单拟定：
  • 标题——使用祈使句，具体明确（Add token refresh endpoint，而不是 Auth）。
  • 描述——说明做什么以及原因，并关联到 PRD 阶段。
  • 验收标准——审核者可以验证的检查清单。
  • 阶段标签——所属的 PRD 阶段。
• 保持工单精简。无法在一屏内描述清楚的工单应拆成两个。

2. 创建前确认计划

打印拟创建的工单列表（标题 + 阶段分组）和目标平台。这是确认关卡——实际创建的工单无法通过一次点击撤销。

3. 创建工单——根据 --platform 分支处理

--platform jira：

• 使用 Atlassian MCP 服务。
• 在 --project 中将每个工单创建到 --epic 下。
• 映射关系：PRD 阶段 → 标签或 epic；验收标准 → 描述。
• 记录每个已创建议题的键。

--platform github：

• 使用 gh CLI：gh issue create --title "..." --body "..." [--label phase-N] [--milestone "..."]。
• 在议题正文中以 Markdown 检查清单的形式填写验收标准。
• 为每个 PRD 阶段应用 phase-N 标签（如果标签不存在，则使用 gh label create 创建）。
• 记录每个已创建议题的编号/URL。

4. 汇报

• 使用表格列出：工单标题 → 阶段 → 创建后的键/编号/URL。
• 列出生成待办列表所依据的 PRD 路径。
• 下一步：现在可以将每个阶段作为 PIV 循环运行。

质量检查

• ✅ 每个工单都能追溯到某个 PRD 阶段或用户故事
• ✅ 每个工单都有可验证的验收标准
• ✅ 工单规模精简（≤ 约 1 天工作量）
• ✅ 使用了正确的平台，且所有创建操作均成功
• ✅ 保留阶段分组（标签/epic），确保待办列表易于浏览

备注

• Greenfield 与 brownfield 的区别会影响 PRD 的范围（MVP 与下一个 epic），而非此技能——plan-create-stories 在两种情况下的运行方式都相同。
• 未经第 2 步确认，绝不创建工单。
• 如果某个阶段过于模糊，无法拆解，请停止并指出问题——这是 PRD 存在缺漏，而不是编写工单的问题。