ai-dev-workflow は何をしますか？
AI 開発の完全なワークフロー：仕様駆動（SDD）＋階層別テストファースト（TDD）＋収束検証により、AI が仕様から逸脱しないコードを生成します。9 つの中間生成物テンプレートとインストール可能なエージェントスキルを同梱。
概要
このスキルは、AI エージェントを用いたソフトウェア開発において、仕様の定義からテスト、実装、検証までを一貫して行うためのワークフローを提供します。以下の3つのフェーズで構成されます。
- 仕様駆動開発 (SDD): 要求仕様を明確に定義し、設計文書を作成します。
- 階層別テストファースト (TDD): ユニットテスト、結合テスト、E2Eテストを段階的に作成し、実装を導きます。
- 収束検証: 生成されたコードが仕様を満たしているか自動検証し、乖離を修正します。
提供テンプレート
以下の9つの中間生成物テンプレートが含まれています。
| # | テンプレート名 | 説明 |
|---|---|---|
| 1 | 要求仕様書 | プロジェクトの要求事項を整理 |
| 2 | 設計書 | アーキテクチャとコンポーネント設計 |
| 3 | 単体テスト仕様書 | ユニットテストのケース定義 |
| 4 | 結合テスト仕様書 | 結合テストのケース定義 |
| 5 | E2Eテスト仕様書 | エンドツーエンドテストのケース定義 |
| 6 | 実装コード | テストに基づくコード生成 |
| 7 | テスト結果レポート | テスト実行結果の集約 |
| 8 | コードレビューシート | レビュー観点と指摘事項 |
| 9 | 収束検証レポート | 仕様との一致性チェック結果 |
インストール方法
対応エージェント（Claude Code、Cursor、Codex 等）に以下の設定を追加してください。
# 例：Claude Code の場合
claude add-skill soft6096/ai-dev-workflow
または、手動で SKILL.md をプロジェクトルートに配置し、エージェントの指示ファイルに読み込みパスを指定してください。
使用方法
- エージェントに「
soft6096/ai-dev-workflowを起動」と指示します。 - プロンプトに従って、プロジェクト名、要求仕様、利用技術を入力します。
- エージェントが自動的に9つのテンプレートを順次生成・処理します。
- 各フェーズでエージェントが確認を求める場合がありますので、適宜フィードバックを行ってください。
注意事項
- テンプレートはマークダウン形式で出力されます。
- 生成されたコードは必ず人間がレビューすることを推奨します。
- 大規模プロジェクトではフェーズごとに分割実行すると効果的です。
- 対応エージェントのバージョンによって動作が異なる場合があります。