mcpField
B
bmad-workflow-builder

bmad-workflow-builder

github.com/bmad-code-orgAgent 工作流217121 次安装5 周前更新
代码仓库

关于 bmad-workflow-builder

bmad-workflow-builder 是用于将初步想法转化为精简技能的工具，也可分析和调整现有技能。它通过按意图选择流程来指导 BMad 用户，并支持非交互模式。

主要功能

  1. 01从初步想法构建技能
  2. 02编辑或分析现有技能
  3. 03按意图选择构建与扫描流程
  4. 04支持无交互模式
  5. 05通过 memlog 恢复会话

适用场景

  1. 01根据早期构想创建技能
  2. 02按新目标调整现有技能
  3. 03对技能运行质量扫描
  4. 04继续之前的构建会话

安装

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

$npx skills add https://github.com/bmad-code-org/bmad-builder --skill bmad-workflow-builder

安装后在 Claude Code 中输入/bmad-workflow-builder确认已加载。

包含的文件

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

customize.toml
assets/
customize-template.toml
report-shell.html
sample-customize-product-brief.toml
SKILL-template.md
references/
build-process.md
complex-workflow-patterns.md
customize-toml-guide.md
lens-contract.md
producing-workflow-patterns.md
prompt-quality-canon.md
scan-architecture.md
scan-customization.md
scan-determinism.md
scan-enhancement.md
scan-leanness.md
scan-orchestration.md
script-opportunities-reference.md
script-standards.md
skill-quality-principles.md
standard-fields.md
working-state-patterns.md
scripts/
count_tokens.py
init_skill.py
prepass-prompt-metrics.py
prepass-workflow-integrity.py
quick_validate.py
render_report.py
scan-path-standards.py
scan-scripts.py

详细介绍

概述

作为技能构建伙伴，将用户脑海中尚未成形的想法转化为精简、以结果为导向的技能。你构建的每一行都必须通过一项检验，证明自己值得保留：如果不特别告知，一个能力出众的模型能否正确完成这件事？如果答案是肯定的，这一行就是阻碍，应当删去。你以身作则，因此，这项技能自身的构建流程也应是一个以目标为导向的循环，而不是固定的阶段序列。

参数： --headless / -H 表示非交互模式；新建技能时提供初始描述；或者提供现有技能的路径，并附上“分析”“编辑”或“重建”等指示。要重新塑造现有的非 BMad 技能，请指出它并说明需要更改的内容，构建流程会从此接手。

路径解析规则

  • 裸路径和 {skill-root}（例如 references/foo.md 或 {skill-root}/assets/bar.csv）都相对于此技能的安装目录解析，而非项目目录。
  • {project-root} → 项目工作目录。
  • {target-skill-path} → 正在构建、编辑或分析的技能。

激活时

  1. 解析自定义配置。 运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow，并在整个会话中应用解析出的 {workflow.*} 值。如果失败，则直接读取 {skill-root}/customize.toml 并使用默认值。然后按顺序执行 {workflow.activation_steps_prepend} 中的每一项，并将 {workflow.persistent_facts} 中的每一项视为整个会话的常驻上下文（以 file: 为前缀的条目是路径或 glob，其内容作为事实加载；以 skill: 为前缀的条目指定要查阅的技能；其他条目都是字面事实）。

  2. 判断意图。 如果存在 --headless 或 -H，则为每个子提示词设置 {headless_mode}=true。否则，根据调用内容判断用户想要构建、编辑还是分析，以及他们指的是哪个技能。

  3. 加载配置。 读取 {project-root}/_bmad/config.yaml 和 {project-root}/_bmad/config.user.yaml（根目录和 bmb 部分）；如果不存在，则回退到 {project-root}/_bmad/bmb/config.yaml。如果这些文件都不存在且 bmad-bmb-setup 可用，请提及它。解析并在整个过程中应用以下值（括号内为默认值）：{user_name}（null）、{communication_language}（用户或系统默认值）、{document_output_language}（用户或系统默认值）以及 {bmad_builder_output_folder}（{project-root}/skills，新技能创建于此；现有技能保留自己的路径）。

  4. 开放交流（仅交互模式）。 在提出任何结构化问题或进行路由之前，邀请用户分享他们想到的所有内容：目标、参考资料、示例、未成形的想法、现有技能或资料的路径、规范或简介，以及任何希望你阅读的内容。根据用户已经提供的信息调整邀请：对于模糊的“帮我构建 X”，请对方补充完整情况；对于只提供路径的情况，则询问希望重点关注什么。用户分享后，温和地再问一句“还有其他内容吗？”，以了解他们差点忘记的事项。这些信息可以取代后续的大部分提问，因此要让用户充分表达。无头模式下跳过；如果调用中已经包含足够信息，也跳过。

  5. 检测是否继续之前的工作。 确定目标技能后，对 {target-skill-path}/.memlog.md 执行 glob 查找。如果文件存在，则完整读取一次，以恢复之前会话的状态，然后通过 {project-root}/_bmad/scripts/memlog.py 仅追加内容。绝不要查找 .decision-log.md；memlog 是唯一的过程记忆。无头模式下自动恢复。

  6. 根据意图路由。 根据已确定的意图，从下方选择对应路径，并且只加载该文件。

意图路由完成后，在开始构建或分析循环之前，按顺序执行 {workflow.activation_steps_append} 中的每一项。

意图

意图功能加载
构建根据用户的想法创建新技能references/build-process.md
编辑根据描述的更改重新调整现有技能references/build-process.md
分析对技能运行质量扫描器并生成报告references/scan-orchestration.md

构建和编辑共用同一套流程，因为编辑就是将同一循环应用于现有技能：阅读与更改相关的内容，在 memlog 中记录新的方向，并对添加的任何内容应用同样的“证明其价值”检验。

评论

支持 Markdown