qcsd-refinement-swarm について
qcsd-refinement-swarmは、スプリントへのコミット前にユーザーストーリーを整える品質エンジニアリングスキルです。エージェントを連携させ、製品要素の評価、BDDシナリオ生成、要件検証を行い、準備状況の判定とレポートを作成します。
主な機能
- 01SFDIPOT要素によるストーリー評価
- 02BDDシナリオの生成
- 03INVESTに基づく要件検証
- 04条件に応じた専門エージェントの実行
- 05準備状況の判定とレポート作成
- 06分析結果の保存とテスト案の書き換え
活用シーン
- 01ストーリーのスプリント準備状況の確認
- 02受け入れ基準の不足の特定
- 03APIや依存関係に関するストーリーリスクの分析
- 04テスト案の生成と改善
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/qcsd-refinement-swarmを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/qcsd-refinement-swarm.yamlschemas/output.jsonscripts/validate-config.jsonsteps/01-flag-detection.md02-core-agents.md03-batch1-results.md04-conditional-agents.md05-decision-synthesis.md06-report-generation.md07-learning-persistence.md08-transformation.md09-final-output.md詳細
QCSD Refinement Swarm v1.0
スプリントリファインメントセッション向けのシフトレフト型品質エンジニアリングスウォームです。
概要
Refinement Swarm は、Ideation を通過したユーザーストーリーを対象に、SFDIPOT 製品要因、BDD シナリオ、INVEST 検証を用いて、スプリントでのコミットメントに向けた準備を行います。 READY／CONDITIONAL／NOT-READY の判定を出力します。
QCSD フェーズにおける位置付け
| フェーズ | スウォーム | 判定 | 実施時期 |
|---|---|---|---|
| Ideation | qcsd-ideation-swarm | GO / CONDITIONAL / NO-GO | PI／スプリント計画 |
| Refinement | qcsd-refinement-swarm | READY / CONDITIONAL / NOT-READY | スプリントリファインメント |
| Development | qcsd-development-swarm | SHIP / CONDITIONAL / HOLD | スプリント中 |
| Verification | qcsd-cicd-swarm | RELEASE / REMEDIATE / BLOCK | リリース前／CI-CD |
| Production | qcsd-production-swarm | HEALTHY / DEGRADED / CRITICAL | リリース後 |
パラメーター
STORY_CONTENT：受け入れ基準を含むユーザーストーリー（必須）OUTPUT_FOLDER：レポートの保存先（デフォルト：${PROJECT_ROOT}/Agentic QCSD/refinement/）
適用ルール — 最初にお読みください
| ルール | 適用内容 |
|---|---|
| E1 | Step 2 で 3 つすべてのコアエージェントを必ず起動します。 |
| E2 | 並列実行する Task 呼び出しは、すべて 1 つのメッセージにまとめる必要があります。 |
| E3 | 各バッチの後は必ず停止して待機します。 |
| E4 | フラグが TRUE の場合は、該当する条件付きエージェントを必ず起動します。 |
| E5 | READY／CONDITIONAL／NOT-READY の判定ロジックを必ず厳密に適用します。 |
| E6 | レポートの完全な構成を必ず生成します。 |
| E7 | 各エージェントは分析前に、必ず自身の参照ファイルを読み込みます。 |
| E8 | Step 8 で qe-test-idea-rewriter による変換を必ず適用します。 |
| E9 | Step 7 の学習内容の永続化を必ず実行します。 |
Step 実行プロトコル
各 Step ファイルを Read ツールで読み込み、順番に実行します。
Steps
- フラグ検出 --
steps/01-flag-detection.md-- ストーリーの内容を分析し、7 つすべてのフラグを評価します - コアエージェント --
steps/02-core-agents.md-- qe-product-factors-assessor、qe-bdd-generator、qe-requirements-validator を起動します - バッチ 1 の結果 --
steps/03-batch1-results.md-- 待機して指標を抽出します - 条件付きエージェント --
steps/04-conditional-agents.md-- フラグに該当するエージェントを起動します - 判定の統合 --
steps/05-decision-synthesis.md-- READY／CONDITIONAL／NOT-READY の判定ロジックを適用します - レポート生成 --
steps/06-report-generation.md-- リファインメントレポートを生成します - 学習内容の永続化 --
steps/07-learning-persistence.md-- 結果をメモリに保存します - 変換 --
steps/08-transformation.md-- すべてのテストアイデアにテストアイデア書き換えツールを実行します - 最終出力 --
steps/09-final-output.md-- 完了サマリーを表示します
実行手順
- Read ツールを使用して、現在の Step ファイルを読み込みます
- Step の指示をすべて実行します
- すべての成功基準が満たされていることを確認します
- 出力を次の Step のコンテキストとして渡します
- Step が失敗した場合は、処理を停止して報告します
再開のサポート
特定の Step から再開するには、--from-step N を指定します。
エージェント一覧
| エージェント | 種類 | ドメイン | バッチ |
|---|---|---|---|
| qe-product-factors-assessor | コア | requirements-validation | 1 |
| qe-bdd-generator | コア | requirements-validation | 1 |
| qe-requirements-validator | コア | requirements-validation | 1 |
| qe-contract-validator | 条件付き（HAS_API） | contract-testing | 2 |
| qe-impact-analyzer | 条件付き（HAS_REFACTORING） | code-intelligence | 2 |
| qe-dependency-mapper | 条件付き（HAS_DEPENDENCIES） | code-intelligence | 2 |
| qe-middleware-validator | 条件付き（HAS_MIDDLEWARE） | enterprise-integration | 2 |
| qe-odata-contract-tester | 条件付き（HAS_SAP_INTEGRATION） | enterprise-integration | 2 |
| qe-sod-analyzer | 条件付き（HAS_AUTHORIZATION） | enterprise-integration | 2 |
| qe-test-idea-rewriter | 変換（常時） | test-generation | 3 |
合計：10 エージェント（コア 3 + 条件付き 6 + 変換 1）
重要な原則
スプリントの成功は、リファインメントの品質によって決まります。このスウォームにより、ストーリーがテスト可能で、完全であり、開発に着手できる状態であることを保証します。
コメント
Markdown 対応