Spec Flow Auto

Overview

SpecWorkflowMcpベースの仕様駆動開発(SDD)を完全自動化し、PRDからSPEC生成、実装タスク分解までを1コマンドで完結させるスキル。MiyabiPrivateプロジェクトを汎用的なSDDプラットフォームに変換する。

Quick Start

最も基本的な使用方法：

README.mdから仕様書と実装タスクを自動生成してください

これだけで以下が完全自動実行される：

1. SpecWorkflowMcp連携 - 仕様ガイドラインの読み込みと適用
2. AI駆動PRD解析 - Claude Sonnet 4による高度なドキュメント理解
3. SPEC自動生成 - requirements.md, design.md, tasks.mdの高品質生成
4. タスク分解 - 実装可能な粒度でのタスクブレークダウン
5. 品質検証 - AIを活用した整合性チェックと網羅性検証
6. Miyabi連携準備 - 7エージェントとの連携データ生成

Core Capabilities

1. 🧠 AI強化PRDからSPEC自動生成

トリガー例：

• 「README.mdから仕様書と実装タスクを自動生成してください」
• 「このPRDを解析してSPECを生成、AI品質チェックも実行してください」
• 「既存コードから仕様を逆生成、Miyabi連携準備までお願いします」

AI連携自動実行内容：

1. SpecWorkflowMcpガイドライン読み込み - 標準SDDプロセスの適用
2. AI駆動PRD解析 - Claude Sonnet 4による高度なドキュメント理解
3. 高品質SPEC生成 - requirements.md, design.md, tasks.mdの知的生成
4. AI洞察追加 - 各ドキュメントにAI推奨事項とリスク分析を付加
5. 品質検証 - AIによる網羅性と一貫性のチェック

使用リソース：

• scripts/enhanced_sdd_pipeline.py - AI強化パイプライン（推奨）
• scripts/generate_spec_from_prd.py - 従来の生成スクリプト
• references/prd_template.md - PRDテンプレート参照
• SpecWorkflowMcpガイドライン - 標準SDDプロセス

2. SPECから実行タスクへの分解

トリガー例：

• 「SPECを実装タスクに分解してください」
• 「このdesign.mdから具体的な実装計画を作成してください」
• 「tasks.mdのタスクをさらに詳細化してください」

自動実行内容：

1. design.mdの技術的詳細を分析
2. 実装優先順位の決定
3. タスク間の依存関係の特定
4. Miyabiエージェントとの連携タスク生成

使用リソース：

• scripts/create_tasks_from_spec.py - タスク分解スクリプト
• references/task_breakdown_patterns.md - 分解パターン集
• references/sdd_integration_rules.md - Miyabi連携ルール

3. 整合性チェックと検証

トリガー例：

• 「PRDとSPECの整合性をチェックしてください」
• 「仕様と実装コードの乖離を検証してください」
• 「生成されたタスク網羅性を確認してください」

自動実行内容：

1. PRD↔requirements.mdの整合性検証
2. design.md↔tasks.mdの技術的一貫性チェック
3. 実装コードとの乖離検出
4. レポート生成と修正提案

使用リソース：

• scripts/validate_prd_spec_sync.py - 整合性検証スクリプト
• assets/validation_checklists/ - 各種チェックリスト

4. 🚀 完全自動化SDDパイプライン

トリガー例：

• 「README.mdからSDD完全自動実行、Miyabi自律開発準備までお願いします」
• 「このプロジェクトにAI強化SDDを適用してください」
• 「仕様駆動開発の全工程を自動実行、品質担保までお願いします」

AI連携完全自動実行内容：

1. Phase 0: SpecWorkflowMcpガイドライン読み込み - SDD標準プロセス適用
2. Phase 1: 環境準備 - ワークスペース、依存関係の自動セットアップ
3. Phase 2: AI駆動PRD解析 - Claude Sonnet 4による知的ドキュメント解析
4. Phase 3: AI強化SPEC生成 - 高品質仕様書の自動生成
5. Phase 4: AIタスク分解 - 実行可能レベルでの詳細タスク生成
6. Phase 5: AI品質検証 - 網羅性・一貫性・実行可能性のAIチェック
7. Phase 6: Miyabi連携準備 - 7エージェントとの連携データ生成
8. Phase 7: 完了レポート - AI分析結果と次のアクション提示

使用リソース：

• scripts/enhanced_sdd_pipeline.py - AI強化完全自動パイプライン（推奨）
• scripts/run_sdd_pipeline.py - 従来のパイプラインスクリプト
• SpecWorkflowMcpツール連携 - ガイドラインと承認プロセス

実行ワークフロー

標準SDDフロー

[ユーザー要求] → [PRD解析] → [SPEC生成] → [タスク分解] → [品質検証] → [Miyabi連携]

具体的な実行例

例1: 新規機能開発

「ユーザー認証機能のPRDから仕様書と実装タスクを作成してください」
↓
1. generate_spec_from_prd.py 実行
2. create_tasks_from_spec.py 実行
3. validate_prd_spec_sync.py 実行
4. Miyabiエージェント連携準備完了

例2: 既存コードの仕様化

「既存のsrc/auth/*コードベースから仕様を逆生成してください」
↓
1. コード解析とdesign.md生成
2. 要件抽出とrequirements.md生成
3. リファクタリングタスク分解
4. 整合性チェックと改善提案

Resources

scripts/

SDDパイプラインを構成する実行可能なPythonスクリプト群。

主要スクリプト:

• generate_spec_from_prd.py - PRDからSPECを自動生成するメインスクリプト
• create_tasks_from_spec.py - SPECから具体的な実装タスクを分解するスクリプト
• validate_prd_spec_sync.py - PRDとSPECの整合性を検証するスクリプト
• run_sdd_pipeline.py - 全SDDパイプラインを一括実行する統合スクリプト
• setup_spec_workspace.py - SPECワークスペースを初期化するスクリプト

実行方法:

python scripts/run_sdd_pipeline.py --prd README.md --spec-name user-auth
python scripts/generate_spec_from_prd.py --input docs/PRD.md --output .spec-workflow/specs/new-feature

references/

SDDプロセスを支援するドキュメントとガイド。

主要ドキュメント:

• prd_template.md - PRD作成標準テンプレート
• spec_workflow_guide.md - SpecWorkflowMcp利用詳細ガイド
• task_breakdown_patterns.md - タスク分解の標準パターン集
• sdd_integration_rules.md - Miyabiシステム連携ルール

参照タイミング:

• PRD作成時: prd_template.md
• SPEC生成時: spec_workflow_guide.md
• タスク分解時: task_breakdown_patterns.md, sdd_integration_rules.md

assets/

SDDプロセスで使用されるテンプレートやチェックリスト。

主要リソース:

• sample_prd.md - 高品質PRDのサンプル
• validation_checklists/ - 各種品質チェックリスト
  • prd_validation.md - PRD品質チェックリスト
  • spec_validation.md - SPEC品質チェックリスト
  • task_validation.md - タスクリスト品質チェックリスト

使用方法: テンプレートは出力生成時に参照され、チェックリストは検証プロセスで使用される。

使用例と成功事例

🎯 典型的な使用シナリオ

シナリオ1: 新規機能開発

「ユーザー認証機能のREADME.mdから仕様書と実装タスクを自動生成してください」
↓
✅ 15分で以下を生成：
- requirements.md (機能要件・非機能要件 + AI洞察)
- design.md (技術設計・セキュリティ設計 + AI推奨)
- tasks.md (25の実装タスク + 依存関係)
- miyabi_integration.json (7エージェント連携データ)

シナリオ2: 既存プロジェクトの仕様化

「src/auth/*の既存コードから仕様を逆生成、リファクタリング計画もお願いします」
↓
✅ 30分で以下を生成：
- 現行アーキテクチャの文書化
- 改善提案付き設計書
- 段階的リファクタリング計画
- Miyabi自律移行タスク

シナリオ3: 技術検証のためのプロトタイプ

「マイクロサービス構成の技術検証PRDから実装計画まで自動生成してください」
↓
✅ 技術的実現可能性の評価と実装パス生成

📊 成功指標

• 時間短縮: 手動プロセス比90%時間削減（8時間→45分）
• 品質向上: AI品質チェックで85%以上の評価スコア
• 網羅性: 標準SDDプロセスの100%カバレッジ
• 再利用性: Miyabi連携で即実行可能なタスク生成

🔧 詳細実行方法

AI強化完全自動パイプライン（推奨）

# Claude Codeでの実行（最も簡単）
「README.mdからSDD完全自動実行、Miyabi自律開発準備までお願いします」

# 直接スクリプト実行
python .claude/skills/spec-flow-auto/scripts/enhanced_sdd_pipeline.py \
  --prd README.md \
  --spec-name user-auth-system \
  --output .spec-workflow

個別プロセス実行

# PRDからSPEC生成のみ
python scripts/generate_spec_from_prd.py \
  --input README.md \
  --output .spec-workflow/specs \
  --spec-name feature-x

# SPECからタスク分解
python scripts/create_tasks_from_spec.py \
  --spec-path .spec-workflow/specs/feature-x \
  --output .spec-workflow/tasks

🎮 次のステップ（Miyabi自律開発）

SDD完了後、以下のコマンドで自律開発を開始：

# Issue作成と自動ラベル分類
/create-issue

# Miyabiエージェントによる自律実行
/agent-run

# 進捗監視
/miyabi-status

# 品質検証
/verify

---

🔗 SpecWorkflowMcp連携

本スキルはSpecWorkflowMcpの標準プロセスと完全互換：

• 仕様ガイドライン - mcp__spec-workflow__spec-workflow-guideで読み込み
• 承認プロセス - mcp__spec-workflow__approvalsで管理
• 進捗管理 - mcp__spec-workflow__spec-statusで確認

---

Miyabiシステム連携について 本スキルはMiyabiフレームワークの7エージェント（Coordinator, Issue, CodeGen, Review, PR, Deployment, Test）と完全連携し、生成されたタスクを自律実行することができる。AI強化により、品質と効率を最大化した仕様駆動開発を実現します。

🌸 Spec Flow Auto - AI-Powered Specification Development