spec-driven について
spec-drivenは、仕様策定、設計、タスク分解、実装、任意の検証、アーカイブへと機能開発を導くスキルです。変更の規模に応じて工程を調整し、機械的な修正では工程を省略できます。
主な機能
- 01段階的な機能開発ワークフロー
- 02計画前に変更規模を判定
- 03仕様書と設計成果物の作成
- 04実装タスクへの分解
- 05任意のUATと手動アーカイブ
活用シーン
- 01PRDから機能を計画
- 02設計を実装タスクに変換
- 03計画した単位でタスクを実装
- 04稼働中のアプリでUATを実施
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ adeonir/ agent-skills --skill spec-drivenインストール後、Claude Code で/spec-drivenを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdagents/openai.yamlinstructions/archive.mddesign.mdimplement.mdspecify.mdtasks.mdvalidate.mdreferences/acceptance-criteria.mdcommit-conventions.mddiscovery.mddiscriminator.mdmemory.mdordering.mdresearch-cache.mdsimplicity.mdslicing.mduntrusted-content.mdscripts/lint_artifact.pyselect_tasks.py詳細
仕様駆動開発
機能開発をフェーズに分けて進めます。デフォルトでは軽量にし、変更に見合う場合にのみ重みを加えます。
トリガー
- 仕様作成(「機能を計画する」「これを仕様化する」「PRD から」「機能を変更する」「構築方法を検討する」)→ specify.md
- 設計(「この機能を設計する」「技術設計」「構築を計画する」)→ design.md
- タスク(「タスクを作成する」「タスクに分割する」「タスクの内訳」)→ tasks.md
- 実装(「タスク T-1 を実装する」「T-1 から T-4 を実装する」「スライス S-1 を実装する」「タスクを実行する」「すべて実装する」)→ implement.md
- 検証/UAT(「UAT を実施する」「手動テスト」「フローを検証する」)→ validate.md
- アーカイブ(「機能をアーカイブする」「この仕様をアーカイブする」)→ archive.md
ワークフロー
specify → design → tasks → implement → [validate] → [archive]
└────────┴────────┴──────────┴──────────┴ a mechanical change skips all of this: one-liner → branch → implement inline
Specify のトリアージで進め方を決定します。影響を左右する判断が一切ない機械的な変更は、1 行の指示で独立したブランチ上のインライン実装に直接進みます。また、個別にリリースされる成果を含むプロンプトは、成果ごとに 1 つの機能に分けます。それ以外の場合は成果物を作成し、各フェーズを順に実行します。Verify は implement 内でタスクごとに行う、頭の中での確認であり、ユーザー向けのフェーズではありません。Validate は実行中のアプリケーションで行う任意の UAT です。Archive は、どの状態の機能に対しても手動で行う整理作業であり、自動実行も提案もされません。
コメント
Markdown 対応