mcpField
B
bmad-testarch-nfr

bmad-testarch-nfr

github.com/bmad-code-orgテスト・品質112197 回インストール1 日前に更新
リポジトリ

bmad-testarch-nfr について

bmad-testarch-nfrは、リリース前に非機能要件の証拠を監査するテストアーキテクト向けワークフローです。性能、セキュリティ、信頼性、保守性を確認し、作成・再開・検証・編集に対応します。

主な機能

  1. 01性能・セキュリティ・信頼性・保守性の証拠監査
  2. 02監査の作成・再開・検証・編集
  3. 03システム・エピック・ストーリー別の監査
  4. 04監査レポートとブラウザー画面の保存

活用シーン

  1. 01リリース前の非機能要件の証拠評価
  2. 02中断した監査ワークフローの再開
  3. 03既存の監査結果の検証や編集

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise --skill bmad-testarch-nfr

インストール後、Claude Code で/bmad-testarch-nfrを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

bmod.toml
checklist.md
customize.toml
instructions.md
nfr-report-template.md
workflow.yaml
resources/
nfr-assessment.example.md
steps-c/
nfr-status-definitions.md
step-01-load-context.md
step-01b-resume.md
step-02-define-thresholds.md
step-03-gather-evidence.md
step-04-evaluate-and-score.md
step-04a-subagent-security.md
step-04b-subagent-performance.md
step-04c-subagent-reliability.md
step-04d-subagent-maintainability.md
step-04e-aggregate-nfr.md
step-05-generate-report.md
steps-e/
step-01-assess.md
step-02-apply-edit.md
steps-v/
step-01-validate.md

詳細

NFR エビデンス監査

目標: リリース前に、実装された非機能要件のエビデンス(パフォーマンス、セキュリティ、信頼性、保守性)を、エビデンスに基づいて検証し、監査します。

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

与えられた名前、アイデンティティ、コミュニケーションスタイルを維持しつつ、この役割の説明にある詳細を統合して作業を続けてください。

規約

  • 裸のパス(例: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} を起点に解決します。

有効化時

ステップ 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:先頭追加ステップを実行する

続行する前に、{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:末尾追加ステップを実行する

{workflow.activation_steps_append} の各エントリーを順に実行します。

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

ワークフローの構成

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

  • 作成モード(steps-c/):新規実行と再開時の続行に使用する主要な実行フロー
  • 検証モード(steps-v/):チェックリストに照らした検証
  • 編集モード(steps-e/):既存の出力を改訂

初期化シーケンス

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 を読み込みます

各実行では、監査記録を {test_artifacts}/nfr/nfr-assessment-{run_key}.md に書き込みます。run_key は system、epic-{epic_num}、または story-{story_key} です。最初の保存前にステップ 1 でこれを解決するため、あるスコープの監査記録が別のスコープの監査記録を上書きしたり、統合されたりすることはありません。ブラウザーの証拠となるスクリーンショットも {test_artifacts}/nfr/ の下に保存されます。

再開モードでは、再開する実行に一致する出力ドキュメントを選択します。複数のドキュメントがあり、スコープが指定されていない場合は確認を求めます。また、ドキュメントの runKey が別の実行に属している場合は、続行を拒否します。

コメント