025-quality-attribute-discovery について
アーキテクチャ作業の前に、品質特性を特定して優先順位を付ける対話型スキルです。候補を根拠に結び付け、設計の選択やADRの記録には進みません。
主な機能
- 01根拠に基づく品質特性の発見
- 02ステークホルダーへの影響とリスクによる優先順位付け
- 03確認が必要な情報不足の明示
- 04アーキテクチャ決定の前に停止
活用シーン
- 01設計前の非機能要件の特定
- 02課題に関する品質特性の優先順位付け
- 03機能仕様書の該当セクションの作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/025-quality-attribute-discoveryを入力して読み込まれたか確認します。
同梱ファイルreferences/025-quality-attribute-discovery.md
詳細
品質属性の発見
アーキテクチャや設計の決定を始める前に、将来のソリューションが満たすべき品質属性を特定し、優先順位を付けるためのガイドです。これは対話型の SKILL です。
この Skill で扱う内容
- 問題に関連する品質属性の候補（パフォーマンス、セキュリティ、可用性、保守性、スケーラビリティ、ユーザビリティ、可観測性など）を特定する
- 一般的なチェックリストではなく、問題フレーム、根本原因、前提条件、コンテキストマップから得られる証拠に基づいて各候補を裏付ける
- ステークホルダーへの影響とリスクに基づいて、品質属性の候補に優先順位を付ける
- アーキテクチャ上の決定を選択または記録せず、優先順位を付けた発見リストで終了する
- ADR やアーキテクチャの方向性そのものは作成しない
制約
後続のアーキテクチャ作業へのインプットとして、品質属性の候補を発見して優先順位を付けます。ここではアーキテクチャ上の決定を下したり、記録したりしないでください。この手法が別のワークフローによって実行される場合、確認質問の順序はオーケストレーターが管理します。単独で適用する場合は、直接質問してください。
- 必須：品質属性の発見に関するガイダンスを適用する前に、
references/025-quality-attribute-discovery.mdを読む - 必須：各品質属性の候補を、問題フレーム、根本原因、前提条件、またはコンテキストマップから得られる証拠に基づいて裏付ける
- 必須：品質属性の候補を、順不同で列挙するのではなく、ステークホルダーへの影響とリスクに基づいて優先順位を付ける
- 必須：アーキテクチャ上の決定を選択または記録せず、優先順位を付けた発見リストで終了する
- 禁止：このスキルの出力の一部として、アーキテクチャ上の決定、ADR、または設計方針を記録する
- 禁止：利用可能な内容が曖昧な場合に品質属性や優先順位を作り出す。代わりに、確認質問が必要な点として明示する
このスキルを使用する場面
- この問題における品質属性を発見する
- 設計開始前に非機能要件を特定する
- この課題に関する品質属性の候補に優先順位を付ける
- アーキテクチャ上の決定を行う前に、品質属性の発見を適用する
- 機能仕様書の品質属性発見セクションの草案を作成する
ワークフロー
- リファレンスを読む
references/025-quality-attribute-discovery.md を読み、問題フレーム、根本原因の調査結果、前提条件、コンテキストマップを確認して、品質に関する圧力の証拠を探します。
- 品質属性の候補を特定する
一般的なチェックリストをそのまま使うのではなく、得られた証拠に基づいて品質属性の候補を特定します。
- 影響とリスクに基づいて優先順位を付ける
満たされなかった場合のステークホルダーへの影響とリスクに基づいて、品質属性の候補に優先順位を付けます。
- アーキテクチャ上の決定を行う前に終了する
優先順位を付けた発見リストで終了します。ここではアーキテクチャのアプローチを選択したり、ADR を記録したりしないでください。
- 発見リストを報告する
優先順位を付けた品質属性を報告し、出力はこの発見リストまでであり、アーキテクチャ上の決定は選択も記録もしないことを明示します。確認の回答を待って未確定となっている項目があれば、その旨を示します。
リファレンス
詳細なガイダンス、例、制約については、references/025-quality-attribute-discovery.md を参照してください。