Spec-Guided-Dev は何をしますか？
AI開発において重要なスキルは、コードを書くことではなく、人間とAIエージェントの両方が実行できるように意図を正確に記述することです。
このスキルは、AIエージェント（Claude Code、Cursor、Codexなど）との協働を前提とした、仕様駆動開発（Spec-Driven Development）の概念と実践方法を提供します。
概要
従来のソフトウェア開発では、開発者はコードを書くことに多くの時間を費やしてきました。しかし、AIエージェントがコード生成を担うようになった現在、重要なのは「何を作るか」を明確に定義することです。Spec-Guided-Devは、このパラダイムシフトに対応するためのガイドラインとフレームワークを提供します。
なぜ仕様駆動なのか？
- 意図の明確化: 曖昧な要件は、AIエージェントによる誤った実装を引き起こします
- 再利用性: 仕様は人間とAIの両方が理解できる共通言語です
- 検証可能性: 仕様に基づいてAIの出力を自動検証できます
- イテレーション効率: コードの修正ではなく仕様の修正で開発を進められます
対象プラットフォーム
- Claude Code
- Cursor
- Codex (GitHub Copilot)
- その他のAIコード生成ツール
使い方
- プロジェクトのルートに
specs/ディレクトリを作成します - 各機能ごとに仕様書（Markdown形式）を配置します
- AIエージェントに仕様書を読み込ませ、実装を依頼します
仕様書テンプレート例
# 機能名
## 概要
この機能の目的と範囲を簡潔に記述します。
## 入力
- 必要なデータ、パラメータ、前提条件
## 出力
- 期待される結果、副作用、戻り値
## エッジケース
- 異常系の動作、エラーハンドリング
## 実装上の注意
- パフォーマンス要件、依存関係、制約
ワークフロー
- 仕様の作成: 上記テンプレートに従い、実装したい機能の仕様を記述します
- AIへの指示: AIエージェントに仕様書を渡し、「この仕様を実装してください」と指示します
- コード生成: AIが仕様に基づいてコードを生成します
- 検証: 生成されたコードが仕様を満たしているか確認します
- 仕様の更新: 必要に応じて仕様を修正し、再実装を依頼します
ベストプラクティス
- 仕様は短く、明確に、テスト可能に保ちます
- 具体的な例を記載して意図を補強します
- 非機能要件（パフォーマンス、セキュリティ）も仕様に含めます
- バージョン管理システムで仕様とコードを一緒に管理します
まとめ
Spec-Guided-Devは、AI時代のソフトウェア開発において、人間の役割をコード記述から意図の設計へとシフトさせるための実践的なアプローチです。このスキルを習得することで、AIエージェントと効率的に協働し、高品質なソフトウェアを迅速に開発できるようになります。