nobu007 avatar

spec-flow-auto

SpecWorkflowMcpとAI連携による仕様駆動開発(SDD)完全自動化スキル。 PRD→SPEC→実装タスク→品質検証→Miyabi連携までを1コマンドで完結。 kiroやspec-flowの

by nobu007|Open Source

Spec Flow Auto - AI強化仕様駆動開発スキル

License: MIT Python 3.8+ Claude Sonnet 4

SpecWorkflowMcpとAI連携による仕様駆動開発(SDD)を完全自動化し、PRDからSPEC生成、実装タスク分解、品質検証、Miyabi連携までを1コマンドで完結させる最先端のスキル。

🌟 特徴

  • 🧠 AI強化: Claude Sonnet 4による高品質な仕様生成とタスク分解
  • 🚀 完全自動化: PRDからMiyabi自律開発準備まで全工程を自動実行
  • 📋 標準準拠: SpecWorkflowMcp準拠のSDDプロセス
  • 🤖 Miyabi連携: 7エージェントとの完全連携で自律開発を実現
  • ⚡ 高速実行: 手動プロセス比90%時間削減（8時間→45分）

🎯 できること

✨ 基本機能

  1. PRD解析: README.mdやPRDドキュメントの知的理解
  2. SPEC生成: requirements.md, design.md, tasks.mdの自動生成
  3. タスク分解: 実装可能レベルでの詳細タスク生成
  4. 品質検証: AIによる網羅性・一貫性チェック
  5. Miyabi連携: 自律実行用タスクデータ生成

🎨 応用機能

  • 既存コードからの仕様逆生成
  • リファクタリング計画の自動生成
  • 技術検証用プロトタイプ作成
  • マイクロサービス設計の自動化

🚀 クイックスタート

Claude Codeで実行（推奨）

# 最も簡単な方法
「README.mdから仕様書と実装タスクを自動生成してください」

# 完全自動実行
「README.mdからSDD完全自動実行、Miyabi自律開発準備までお願いします」

直接スクリプト実行

# AI強化完全自動パイプライン
python .claude/skills/spec-flow-auto/scripts/enhanced_sdd_pipeline.py \
  --prd README.md \
  --spec-name your-project \
  --output .spec-workflow

# 従来のパイプライン
python .claude/skills/spec-flow-auto/scripts/run_sdd_pipeline.py \
  --prd README.md \
  --spec-name your-project \
  --output .spec-workflow

📁 プロジェクト構成

.claude/skills/spec-flow-auto/
├── SKILL.md                 # スキル定義（このファイル）
├── README.md               # このファイル
├── spec-flow-auto          # スキル実行ファイル
├── scripts/                # 実行スクリプト群
│   ├── enhanced_sdd_pipeline.py     # AI強化完全自動パイプライン
│   ├── run_sdd_pipeline.py          # 従来のパイプライン
│   ├── generate_spec_from_prd.py    # SPEC生成スクリプト
│   ├── create_tasks_from_spec.py    # タスク分解スクリプト
│   ├── validate_prd_spec_sync.py    # 整合性検証スクリプト
│   └── setup_spec_workspace.py      # ワークスペース初期化
├── references/            # 参考ドキュメント
│   ├── prd_template.md            # PRDテンプレート
│   ├── spec_workflow_guide.md     # SpecWorkflowMcpガイド
│   ├── task_breakdown_patterns.md  # タスク分解パターン
│   └── sdd_integration_rules.md   # Miyabi連携ルール
└── assets/                 # テンプレート・チェックリスト
    ├── sample_prd.md               # PRDサンプル
    └── validation_checklists/      # 品質チェックリスト
        ├── prd_validation.md
        ├── spec_validation.md
        └── 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自律移行タスク

📊 成功指標

指標従来Spec Flow Auto改善率
実行時間8時間45分90%削減
品質スコア70%85%+21%向上
網羅性60%100%67%向上
再利用性低高自律実行可能

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

SDD完了後、Miyabiフレームワークで自律開発を開始：

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

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

# 進捗監視
/miyabi-status

# 品質検証
/verify

🔗 連携フレームワーク

SpecWorkflowMcp

  • ✅ 仕様ガイドライン連携
  • ✅ 承認プロセス統合
  • ✅ 進捗管理連携

Miyabi Framework

  • ✅ CoordinatorAgent - タスク統括
  • ✅ IssueAgent - Issue管理
  • ✅ CodeGenAgent - コード生成
  • ✅ ReviewAgent - 品質検証
  • ✅ PRAgent - PR管理
  • ✅ DeploymentAgent - デプロイ
  • ✅ TestAgent - テスト実行

📋 生成物の例

requirements.md

# User Auth Requirements

## Functional Requirements
### FR-001: User Registration
- ユーザー登録機能の実装
- メール検証プロセス
- パスワード強度検証

## AI-Generated Insights
### Quality Assessment
- **Content Completeness**: ✅ Excellent
- **Technical Accuracy**: ✅ Validated

### AI Recommendations
- Consider adding non-functional requirements for scalability
- Include specific performance metrics and SLAs

design.md

# User Auth Design

## Architecture Overview
### System Architecture

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Frontend │ │ Backend │ │ Database │ │ (React) │◄──►│ (FastAPI) │◄──►│ (PostgreSQL) │ └─────────────────┘ └─────────────────┘ └─────────────────┘


## AI-Generated Design Recommendations
### Architecture Patterns
- Consider microservices architecture for better scalability
- Implement caching strategies for improved performance

🎯 依存関係

  • Python 3.8+
  • Claude Sonnet 4 (AI連携)
  • SpecWorkflowMcp (SDD標準プロセス)
  • Miyabi Framework (自律実行)

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照

🤝 貢献

バグ報告、機能要望、プルリクエストを歓迎します。

📞 サポート

  • Framework: Miyabi
  • Issues: GitHub Issues で管理

🌸 Spec Flow Auto - AI-Powered Specification Development

仕様駆動開発の未来を、今。

Download Skill