bmad-help

BMad ヘルプ

目的

ユーザーが自身の BMad ワークフローの中で現在どの位置にいるのか、次に何をすべきかを理解できるよう支援します。また、モジュールのドキュメントソースなどのリモートソースで補強できる幅広い質問がされた場合には、それにも回答します。

期待される成果

このスキルが完了したとき、ユーザーは次の状態になっているべきです。

1. 現在地を把握している — どのモジュールのどのフェーズにいて、何がすでに完了しているか
2. 次に何をすべきかを把握している — 次に推奨される、および／または必須のステップと、その明確な理由
3. それを呼び出す方法を把握している — スキル名、メニューコード、アクションコンテキスト、および会話をショートカットする引数
4. クイックスタートを提案される — 単一のスキルが明確な次のステップである場合、それをただ列挙するのではなく、今すぐユーザーのために実行することを提案する
5. 圧倒されず、方向づけられていると感じる — 現在の位置に関連するものだけを提示し、カタログ全体を吐き出さない
6. 一般的な質問への回答を得られる — 質問が特定のスキルに該当しない場合、モジュールの登録済みドキュメントを使用して根拠のある回答を提供する

データソース

• カタログ: {project-root}/_bmad/_config/bmad-help.csv — インストールされたすべてのモジュールスキルのマニフェスト
• 設定: uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} を実行し、マージされた JSON を使用して output-location 変数を解決し、core.communication_language と modules.bmm.project_knowledge を読み取ります。リゾルバーは _bmad/config.toml、_bmad/config.user.toml、_bmad/custom/config.toml、_bmad/custom/config.user.toml をこの順序でマージします。
• 成果物: 解決された output-location パスにある outputs パターンに一致するファイルは、どのステップが完了している可能性があるかを示します。その内容は、推奨事項の根拠となるコンテキストも提供する場合があります
• プロジェクトナレッジ: project_knowledge が既存のパスに解決される場合、根拠となるコンテキストとしてそれを読み取ります。プロジェクト固有の詳細を決してでっち上げないでください。
• モジュールドキュメント: skill 列に _meta を含む行は、output-location にそのモジュールのドキュメントを指す URL またはパスを持っています。これらを取得して使用し、そのモジュールに関する一般的な質問に回答します。

CSV の解釈

カタログはこの形式を使用します。

module,skill,display-name,menu-code,description,action,args,phase,preceded-by,followed-by,required,output-location,outputs

フェーズは高レベルのフローを決定します。

• anytime — ワークフローの状態に関係なく利用可能
• スキルはフォルダ（plan、ship。一部のモジュールは番号付きフェーズを使用）にグループ化され、順番に流れます。命名はモジュールによって異なります

順序付けは、フェーズ内およびフェーズ間での推奨される順序を決定します（これらはソフトな提案であり、ハードなゲートではありません。ゲートについては required を参照してください）。

• preceded-by — 理想的にはこのスキルの前に完了すべきスキル
• followed-by — 理想的にはこのスキルの後に実行すべきスキル
• 形式: 単一アクションのスキルには skill-name、複数アクションのスキルには skill-name:action

必須ゲート:

• required=true の項目は、ユーザーが以降のフェーズに有意義に進む前に完了する必要があります
• 必須項目のないフェーズは完全に任意です。推奨はしますが、次に実際に何が必須であるかを明確にしてください

完了の検出:

• 解決された出力パスで outputs パターンを検索し、見つかったファイルをカタログの行にあいまい一致させます
• 一致する出力は、そのスキルが開始された証拠として扱い、完了した証拠とはしません
• 一致した成果物を検査して、最終ステータスや完了マーカーなど、明示的な完了の証拠を確認します。ドラフトまたは未完了のマーカーは、そのスキルがまだ進行中であることを意味します
• ユーザーによって述べられた、または現在の会話で確立された完了を尊重します
• 完了を確実に判断できない場合は、その旨を伝えてユーザーに尋ねてください。ファイルの存在だけに基づいて先に進むことを推奨しないでください

説明にはルーティングのコンテキストが含まれています — 一部にはサイクル情報や代替パス（例:「修正が必要な場合は DS に戻る」）が含まれています。これらは単なる表示テキストではなく、ナビゲーションのヒントとして読んでください。

応答フォーマット

推奨項目ごとに、以下を提示します。

• [menu-code] 表示名 — 例:「[PR] PRD」
• バッククォートで囲んだスキル名 — 例: bmad-prd
• 複数アクションのスキルの場合: アクション呼び出しのコンテキスト — 例:「dev lets run a code review!」
• CSV に存在する場合は説明、それ以外の場合はスキルに関する既存の知識で十分です
• 利用可能な場合は引数

並び順: まずオプション項目を表示し、次に次の必須項目を表示します。どちらがどちらかを明確にしてください。

制約

• すべての出力を {communication_language} で提示する
• 各スキルは新しいコンテキストウィンドウで実行することを推奨する
• ユーザーのトーンに合わせる — カジュアルなときは会話調に、具体的な内容を求めたときは構造化して
• アクティブなモジュールが曖昧な場合は、すべてのメタ行のリモートソースを取得して関連情報を見つけ、ユーザーの質問への回答にも役立てる