feature-spec について
ソフトウェアエンジニア、プロダクトマネージャー、テクニカルリード向けの、仕様策定と機能範囲管理のガイドです。影響度順のルールで、要件、受け入れ基準、関係者調整、技術仕様、変更管理を扱います。
主な機能
- 01スコープ境界と MVP の定義
- 02測定可能で追跡可能な要件
- 03MoSCoW と RICE による優先順位付け
- 04テスト可能な受け入れ基準
- 05関係者調整と変更管理
活用シーン
- 01PRD や機能仕様書の作成
- 02機能やバックログ項目の優先順位付け
- 03変更依頼と影響の評価
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ pproenca/ dot-skills --skill feature-specインストール後、Claude Code で/feature-specを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
AGENTS.mdmetadata.jsonREADME.mdassets/templates/_template.mdreferences/_sections.mdaccept-avoid-over-specification.mdaccept-definition-of-done.mdaccept-edge-cases.mdaccept-given-when-then.mdaccept-testable-criteria.mdchange-defer-log.mdchange-formal-process.mdchange-impact-assessment.mdchange-scope-freeze.mdchange-version-tracking.mddoc-accessible-format.mddoc-consistent-templates.mddoc-decision-records.mddoc-glossary-terms.mddoc-single-source.mdprio-dependencies-first.mdprio-kano-model.mdprio-moscow-method.mdprio-rice-scoring.mdprio-value-vs-effort.mdreq-avoid-solution-language.mdreq-consistent-terminology.mdreq-functional-nonfunctional.mdreq-specific-measurable.mdreq-traceability.md詳細
ソフトウェアエンジニアリングの機能仕様と計画に関するベストプラクティス
ソフトウェアエンジニア、プロダクトマネージャー、テクニカルリード向けの包括的な機能仕様・計画ガイドです。影響度に応じて優先順位付けされた8カテゴリ、42のルールを収録し、スコープの肥大化を防いでプロジェクトの成功を確実にします。
適用するタイミング
以下の場面で、このガイドラインを参照してください。
- PRDや機能仕様書を作成するとき
- 要件やユーザーストーリーを定義するとき
- スコープを管理し、スコープの肥大化を防ぐとき
- 機能やバックログ項目に優先順位を付けるとき
- 変更リクエストに対応するとき
- プロジェクトの目標についてステークホルダー間の認識を合わせるとき
優先度別のルールカテゴリ
| 優先度 | カテゴリ | 影響度 | 接頭辞 |
|---|---|---|---|
| 1 | スコープの定義 | CRITICAL | scope- |
| 2 | 要件の明確化 | CRITICAL | req- |
| 3 | 優先順位付けのフレームワーク | HIGH | prio- |
| 4 | 受け入れ基準 | HIGH | accept- |
| 5 | ステークホルダー間の認識合わせ | MEDIUM-HIGH | stake- |
| 6 | 技術仕様 | MEDIUM | tech- |
| 7 | 変更管理 | MEDIUM | change- |
| 8 | ドキュメント基準 | LOW | doc- |
クイックリファレンス
1. スコープの定義(CRITICAL)
scope-define-boundaries- スコープの境界を明確に定義するscope-document-assumptions- すべての前提条件を明示的に文書化するscope-work-breakdown- スコープを測定可能な作業項目に分割するscope-define-mvp- 機能セット全体を定義する前にMVPを定義するscope-stakeholder-signoff- スコープについてステークホルダーの承認を得る
2. 要件の明確化(CRITICAL)
req-specific-measurable- 具体的で測定可能な要件を記述するreq-user-stories- 要件をユーザーストーリーとして構成するreq-avoid-solution-language- 特定のソリューションに依存する表現を避けるreq-functional-nonfunctional- 機能要件と非機能要件を分けるreq-consistent-terminology- 用語を一貫して使用するreq-traceability- 要件のトレーサビリティを維持する
3. 優先順位付けのフレームワーク(HIGH)
prio-moscow-method- MoSCoW優先順位付け手法を使用するprio-rice-scoring- 客観性を高めるためにRICEスコアリングを適用するprio-value-vs-effort- 価値と労力の関係を明確に整理するprio-dependencies-first- 依存関係を特定し、順序付けるprio-kano-model- 機能の分類にKanoモデルを適用する
4. 受け入れ基準(HIGH)
accept-given-when-then- Given-When-Then形式を使用するaccept-testable-criteria- テスト可能な受け入れ基準を記述するaccept-edge-cases- 受け入れ基準にエッジケースを含めるaccept-definition-of-done- 明確な完了の定義を定めるaccept-avoid-over-specification- 過剰な仕様化を避ける
5. ステークホルダー間の認識合わせ(MEDIUM-HIGH)
stake-identify-stakeholders- 早い段階ですべてのステークホルダーを特定するstake-early-feedback- 早い段階から頻繁にフィードバックを集めるstake-conflict-resolution- 対立を明示的に解決するstake-communication-plan- 定期的なコミュニケーションの頻度を定めるstake-success-metrics- 成功指標について認識を合わせる
6. 技術仕様(MEDIUM)
tech-system-context- システムのコンテキストと依存関係を文書化するtech-api-contracts- 実装前にAPIコントラクトを定義するtech-data-model- データモデルとスキーマの変更を仕様化するtech-error-handling- エラー処理と復旧の計画を立てるtech-performance-requirements- パフォーマンス要件を仕様化するtech-security-considerations- セキュリティに関する考慮事項を文書化する
7. 変更管理(MEDIUM)
change-formal-process- 正式な変更リクエストプロセスを使用するchange-impact-assessment- 承認前に影響全体を評価するchange-version-tracking- すべての仕様書のバージョンを管理するchange-scope-freeze- スコープを凍結する期間を設けるchange-defer-log- 保留項目のログを維持する
8. ドキュメント標準(低)
doc-single-source- 信頼できる唯一の情報源を維持しますdoc-consistent-templates- 一貫性のあるドキュメントテンプレートを使用しますdoc-decision-records- 重要な決定を背景情報とともに記録しますdoc-accessible-format- ドキュメントを利用しやすい形式にしますdoc-glossary-terms- プロジェクト用語を定義します
コメント
Markdown 対応