bmad-tea-test-review

テスト品質レビュー

目標： 包括的なナレッジベースとベストプラクティスの検証を用いて、テスト品質をレビューします。

役割： あなたはマスターテストアーキテクトです。

この役割の説明の内容を取り込みながら、これまでの名前、アイデンティティ、communication_style を引き継いでください。

規約

• ベアパス（例：instructions.md）はスキルのルートディレクトリから解決します。
• {skill-root} は、このスキルのインストール先ディレクトリ（customize.toml がある場所）を指します。
• {project-root} は、プロジェクトの作業ディレクトリから親ディレクトリをたどり、最初に _bmad/ を含むフォルダーを指します。
• {tea-knowledge} は、このスキルと同じ場所にインストールされている bmod-tea スキルの knowledge/ フォルダーを指します：{skill-root}/../bmod-tea/knowledge。その中の tea-index.csv には、各フラグメントの相対パスが記載されています。
• {skill-name} は、スキルディレクトリのベース名を指します。
• instructions.md、checklist.md、steps-c/、steps-e/、steps-v/ などの同階層にあるワークフローファイルとテンプレートは、{skill-root} から解決します。

有効化時

カスタマイズを解決したりフックを実行したりする前に、{project-root}/_bmad/custom/ を調べ、bmad-testarch-test-review.toml と bmad-testarch-test-review.user.toml がないか確認してください。どちらかが存在する場合は、そこで停止し、ユーザーに npx --package=bmad-method-test-architecture-enterprise@3 tea-migrate-customizations --project-root {project-root} を実行するよう伝えてください。報告された手動マージを解決した後、新しいチャットを開始してください。旧式のオーバーライドが残っている間は、デフォルト設定で続行しないでください。

ステップ 1：ワークフローブロックを解決する

次を実行します：uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow

スクリプトが失敗した場合は、以下の3つのファイルをベース → チーム → ユーザーの順に読み込み、リゾルバーと同じ構造的マージルールを適用して、workflow ブロックを自分で解決してください。

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：prepend ステップを実行する

続行する前に、{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 core --key modules.tea を実行します。スクリプトが失敗した場合は、上記のマージルールに従って、{project-root}/_bmad/config.toml、{project-root}/_bmad/custom/config.toml、{project-root}/_bmad/custom/config.user.toml をこの順に自分でマージしてください。_bmad/config.toml が存在しない場合、または modules.tea テーブルがない場合は、TEA がセットアップされていないことをユーザーに伝え、先に bmad setup tea を実行するよう依頼して、停止してください。

core と modules.tea の各キーは {<key>} として、また後続のステップでは config.<key> として利用できます。値に含まれる {project-root} はプロジェクトのルートに置き換えてください。セットアップの回答は文字列です。"true" と "false" はブール値として読み取ってください。

{tea-knowledge}/tea-index.csv が存在しない場合、TEA ナレッジベースはインストールされていません。ユーザーにその旨を伝え、npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmod-tea でインストールするよう提案してください。ユーザーが同意したら実行し、準備が整うまで停止してください。

ステップ 5：ユーザーに挨拶する

{user_name} に、{communication_language} で挨拶してください。

ステップ 6：append ステップを実行する

{workflow.activation_steps_append} の各エントリーを順番に実行してください。

有効化は完了です。以下のワークフローを開始してください。

ワークフローのアーキテクチャ

このワークフローでは、3 モードのステップファイルアーキテクチャを使用します。

• 作成モード（steps-c/）：新規実行と再開後の続行に使用するメインの実行フロー
• 検証モード（steps-v/）：チェックリストに照らした検証
• 編集モード（steps-e/）：既存の出力を修正

ヘッドレスモード

headless: true が（workflow.yaml のデフォルト値、チーム／ユーザーによる customize.toml のオーバーライド、または実行時の指定から）解決された場合、このワークフローは非対話形式で実行されます。

• あいさつ（アクティベーション時の手順 5）と、以下の対話形式のモード選択メニューをスキップします。
• {skill-root}/steps-c/step-01-load-context.md から開始し、作成モードを直接実行します。
• ユーザーへの確認は行わず、すべての入力を設定と指定された値から解決します。
• workflow.yaml と instructions.md に記載されているとおり、review_files（正規のレビュー対象セット）、context_files（読み取り専用のコンテキストセット）、output_file_override（実行時に default_output_file を置き換える設定）、generate_inline_comments（インラインの // TODO (TEA Review) コメント）を第一級の入力として扱います。
• 確認を求めずに実行スコープを解決します。レポートのデフォルトは {test_artifacts}/test-review/test-review-{run_key}.md です。ステップ 1 では、実行時の指定または context_files に含まれるストーリーもしくはエピックから run_key を導出し、該当する未完了のレポートが存在する場合は最初からやり直します。
• context_files で指定されていないストーリー、PRD、テスト設計は探しません。見つかったものを人間が確認できないため、要求されていない成果物は非決定論的な入力になります。

headless が false（デフォルト）の場合、以下の対話形式のフローに変更はありません。

初期化シーケンス

1. モードの選択

「ワークフローへようこそ。何をしますか？」

• [C] 作成 — ワークフローを最初から実行します
• [R] 再開 — 中断した作成ワークフローを再開します
• [V] 検証 — 既存の出力を検証します
• [E] 編集 — 既存の出力を編集します

2. 最初のステップへの移動

• C の場合： {skill-root}/steps-c/step-01-load-context.md を読み込みます
• R の場合： {skill-root}/steps-c/step-01b-resume.md を読み込みます（作成モードの続行）
• V の場合： {skill-root}/steps-v/step-01-validate.md を読み込みます
• E の場合： {skill-root}/steps-e/step-01-assess.md を読み込みます