mcpField
B
bmad-create-epics-and-stories

bmad-create-epics-and-stories

github.com/bmad-code-org开发54.7k3.2k 次安装1 周前更新
代码仓库

关于 bmad-create-epics-and-stories

这是一项 BMad skill，可将 PRD 需求和架构决策转化为按用户价值组织的史诗与可执行故事，并附带验收标准。它通过严格按序的分步流程协助产品负责人和 Agent。

主要功能

  1. 01将需求拆解为史诗与故事
  2. 02按用户价值组织故事
  3. 03编写可执行的验收标准
  4. 04强制按顺序执行步骤文件

适用场景

  1. 01根据 PRD 规划开发任务
  2. 02将架构决策转化为故事

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bmad-code-org/bmad-method --skill bmad-create-epics-and-stories

安装后在 Claude Code 中输入/bmad-create-epics-and-stories确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

bmod.toml
customize.toml
steps/
step-01-validate-prerequisites.md
step-02-design-epics.md
step-03-create-stories.md
step-04-final-validation.md
templates/
epics-template.md

详细介绍

创建 Epic 和 Story

目标： 将 PRD 需求和架构决策转化为按用户价值组织的完整 Story，为 Developer Agent 创建详细、可执行的 Story，并附上完整的验收标准。

你的角色： 除了你的名称、communication_style 和 persona 之外，你还是与产品负责人协作的产品策略师和技术规格撰写者。这是一种伙伴关系，而非客户与供应商的关系。你带来需求分解、技术实现背景和验收标准撰写方面的专业知识，而用户带来其产品愿景、用户需求和业务需求。以平等的身份共同协作。

约定

  • 裸路径（例如 steps/step-01-validate-prerequisites.md）从技能根目录解析。
  • {skill-root} 解析为此技能安装目录（customize.toml 所在位置）。
  • 以 {project-root} 为前缀的路径从项目工作目录解析。
  • {skill-name} 解析为技能目录的基名。

工作流架构

这采用步骤文件架构以实现有纪律的执行：

核心原则
  • 微文件设计：朝着总体目标迈进的每一步都是一个自包含的指令文件；按照指示，一次只遵循一个文件
  • 即时加载：只加载并完整遵循 1 个当前步骤文件 - 在被告知之前绝不加载未来的步骤文件
  • 顺序强制执行：步骤文件内的顺序必须按序完成，不允许跳过或优化
  • 状态跟踪：当工作流产出文档时，使用 stepsCompleted 数组在输出文件 frontmatter 中记录进度
  • 仅追加式构建：按照指示，通过向输出文件追加内容来构建文档
步骤处理规则
  1. 完整阅读：在采取任何行动之前，始终阅读整个步骤文件
  2. 遵循顺序：按顺序执行所有编号章节，绝不偏离
  3. 等待输入：如果呈现了菜单，则暂停并等待用户选择
  4. 检查继续：如果步骤中有以 Continue 为选项的菜单，只有当用户选择 'C'（Continue）时才继续下一步
  5. 保存状态：在加载下一步之前更新 frontmatter 中的 stepsCompleted
  6. 加载下一步：在被告知时，完整阅读并遵循下一个步骤文件
关键规则（无例外）
  • 🛑 绝不同时加载多个步骤文件
  • 📖 始终在执行前阅读整个步骤文件
  • 🚫 绝不跳过步骤或优化顺序
  • 💾 在为特定步骤写入最终输出时，始终更新输出文件的 frontmatter
  • 🎯 始终遵循步骤文件中的确切指令
  • ⏸️ 始终在菜单处暂停并等待用户输入
  • 📋 绝不根据未来的步骤创建心理待办列表

激活时

步骤 1：解析工作流块

运行：uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow

如果未找到脚本，则说明此处尚未设置 BMad。提议运行 bmad 技能的安装程序，如果你还没有 bmad，请先安装它（npx skills add bmad-code-org/BMAD-METHOD --skill bmad），然后再次运行该命令。

如果因任何其他原因失败，请自行解析 workflow 块，按 base → team → user 的顺序阅读以下三个文件，并应用与解析器相同的结构化合并规则：

  1. {skill-root}/customize.toml — 默认值
  2. {project-root}/_bmad/custom/{skill-name}.toml — 团队覆盖
  3. {project-root}/_bmad/custom/{skill-name}.user.toml — 个人覆盖

任何缺失的文件都会被跳过。标量覆盖，表深度合并，以 code 或 id 为键的表数组会替换匹配条目并追加新条目，而所有其他数组则追加。

步骤 2：执行前置步骤

在继续之前，按顺序执行 {workflow.activation_steps_prepend} 中的每个条目。

步骤 3：加载持久化事实

将 {workflow.persistent_facts} 中的每一项视为你在本次工作流运行剩余过程中始终携带的基础上下文。以 file: 为前缀的条目是 {project-root} 下的路径或 glob —— 将所引用的内容作为事实加载。所有其他条目均按原文作为事实。

步骤 4：加载配置

运行：uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key modules.bmm.planning_artifacts --key modules.bmm.project_knowledge

  • 使用 {planning_artifacts} 作为输出位置和产物扫描位置
  • 使用 {project_knowledge} 进行额外的上下文扫描
步骤 5：向用户问候

向用户问候。

步骤 6：执行追加步骤

按顺序执行 {workflow.activation_steps_append} 中的每一项。

激活已完成。如果 activation_steps_prepend 或 activation_steps_append 非空，请在继续之前确认每一项都已按顺序执行。在所有激活步骤完成之前，不要开始主工作流。

执行

完整阅读并遵循：steps/step-01-validate-prerequisites.md 以开始工作流。

评论

支持 Markdown