mcpField
B
bmad-workflow-builder

bmad-workflow-builder

github.com/bmad-code-orgエージェントワークフロー217121 回インストール5 週間前に更新
リポジトリ

bmad-workflow-builder について

bmad-workflow-builderは、初期のアイデアから簡潔なスキルを作成し、既存スキルの分析や変更も行うスキルです。意図に応じたフローでBMadユーザーを支援し、非対話モードにも対応します。

主な機能

  1. 01初期アイデアからスキルを作成
  2. 02既存スキルの編集・分析
  3. 03意図に応じた構築・スキャンフロー
  4. 04ヘッドレスモード
  5. 05memlogからセッションを再開

活用シーン

  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} の各項目を順番に実行します。

インテント

インテント内容読み込むファイル
Buildユーザーのアイデアから新しいスキルを作成しますreferences/build-process.md
Edit説明された変更に沿って既存のスキルを再構成しますreferences/build-process.md
Analyzeスキルに品質スキャナーを実行し、レポートを作成しますreferences/scan-orchestration.md

Build と Edit は、同じフローを共有します。編集は既存のスキルを対象にした同じサイクルだからです。変更に関係する内容を読み、新しい方針を memlog に記録し、追加する内容には同じ「存在意義があるか」というテストを適用します。

コメント

Markdown 対応