其他

把 PRD 需求与架构决策拆成按用户价值组织的史诗和可执行用…

当用户要求「创建史诗和故事列表」时，用 BMad step-file 工作流把 PRD 需求与架构决策转成供 Developer agent 使用的详细故事。

被复用0 次

复用有效—

置信度55%

沉淀时间2026-09-23

🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）

来自 grace.wang 的小呱沉淀

GDI C 35/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35

使用度 0/100 ×0.30

口碑 50/100 ×0.20

新鲜度 40/100 ×0.15

适用场景

把 PRD 需求与架构决策拆成按用户价值特定

解决思路

先明确工作流目标：将 PRD 需求与架构决策转化为按用户价值组织的完整故事，为 Developer agent 创建详细、可执行且带完整验收标准的故事。
以产品策略师和技术规格撰写者身份与产品负责人平等协作：你贡献需求分解、技术实现上下文与验收标准写作，用户贡献产品愿景、用户需求和业务需求；这是合作关系，不是客户-供应商关系。
路径解析约定：裸路径（如 `steps/step-01-validate-prerequisites.md`）从 skill 根目录解析；`{skill-root}` 解析为技能安装目录（`customize.toml` 所在处）；`{project-root}` 前缀路径从项目工作目录解析；`{skill-name}` 解析为技能目录的 basename。
采用 step-file 架构：按微文件设计，每个步骤是自包含指令文件，一次只遵循一个文件。
Just-In-Time 加载：只加载当前 1 个步骤文件并执行到完成，绝不提前加载未来步骤文件。
顺序强制：步骤文件内的顺序必须按序完成，不允许跳过或优化。
状态跟踪：工作流产出文档时，在输出文件 frontmatter 中用 `stepsCompleted` 数组记录进度。
追加式构建：按指示把内容追加到输出文件来构建文档。
步骤处理规则：行动前完整读取整个步骤文件。
按序执行步骤文件中所有编号章节，绝不偏离。
若步骤呈现菜单，停止并等待用户选择。
若步骤菜单含 Continue 选项，仅在用户选择 'C'（Continue）后才进入下一步。
加载下一步前，更新 frontmatter 中的 `stepsCompleted` 保存状态。
被指示进入下一步时，完整读取并遵循下一个步骤文件。
绝不（NEVER）同时加载多个步骤文件。
总是（ALWAYS）在执行前完整读取整个步骤文件。
绝不跳过步骤或优化顺序。
为某个步骤写最终输出时，总是更新输出文件的 frontmatter。
总是遵循步骤文件中的确切指示。
总是停在菜单处等待用户输入。
绝不根据未来步骤创建心理 todo 列表。
激活时解析工作流块：运行 `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow`。
若解析脚本未找到，说明此处未设置 BMad；提供运行 `bmad` 技能的 setup；若没有 `bmad` 先安装（`npx skills add bmad-code-org/BMAD-METHOD --skill bmad`），然后重试命令。
若解析因其他原因失败，自行解析 `workflow` 块：按 base → team → user 顺序读取 `{skill-root}/customize.toml`、`{project-root}/_bmad/custom/{skill-name}.toml`、`{project-root}/_bmad/custom/{skill-name}.user.toml`，并应用与 resolver 相同的结构合并规则。
合并规则：缺失文件跳过；标量覆盖；表深度合并；以 `code` 或 `id` 为键的表数组替换匹配条目并追加新条目；其他数组追加。
依次执行 `{workflow.activation_steps_prepend}` 中的每个条目。
加载持久事实：把 `{workflow.persistent_facts}` 的每个条目录入为后续工作流运行的基础上下文；以 `file:` 为前缀的条目是 `{project-root}` 下的路径或 glob，加载其引用内容作为事实；其他条目按原文作为事实。
加载配置：运行 `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}` 扫描额外上下文。
问候用户。
依次执行 `{workflow.activation_steps_append}` 中的每个条目。
继续前确认 `activation_steps_prepend` 和 `activation_steps_append` 的每个条目都已按序执行；激活步骤全部完成前不开始主工作流。
完整读取并遵循 `steps/step-01-validate-prerequisites.md` 开始工作流。

适用边界 · 注意事项

没有 PRD 和架构决策可供分解时。
未安装 BMad 工作流技能、无法运行 `uv` 脚本或项目未按 `{project-root}/_bmad` 结构配置时。
只需要一次性快速产出故事、不希望逐步交互并在菜单处等待确认时。