| name | executing-ai-development-workflow |
| description | Execute a comprehensive AI-driven development workflow with planning, implementation, multi-layer review (Sub-agents + /review + CodeRabbit CLI), automated fixes, and PR creation. Use when implementing new features, performing large refactorings, developing security-critical features, or when the user mentions "AI開発ワークフロー", "AI development workflow", or "計画的に実装". |
Executing AI Development Workflow
概要
AI開発のベストプラクティスを体系化した10ステップの自動化ワークフローを実行します。
計画立案から実装、多層レビュー、自動修正、PR作成まで一貫して管理します。
主な特徴
- ✅ 多層レビューシステム: 4つのSub-agent + Claude Code
/review + CodeRabbit CLI
- ✅ 優先度ベースの修正: Critical/High/Medium/Lowで自動分類
- ✅ 完全なドキュメント化: プランとレビュー結果を
_docs/に保存
- ✅ 妥当性重視: AIレビューの誤検知を適切に判断
- ✅ 人間の介入ポイント: 重要な判断箇所で確認を求める
使い方
以下のようなリクエストでこのSkillが発動します：
「AI開発ワークフローで〜を実装して」
「Use the executing-ai-development-workflow skill to implement...」
「計画的に実装したい」
詳細な使用例は examples.md を参照してください。
ワークフロー概要
1. Planning (プラン作成 - Claude Codeプランモード)
↓
2. Documentation (プランを_docs/plans/にチェックボックス付きで保存)
↓
3. Implementation (Sub-agentで実装)
↓
4. Multi-layer Review
├─ 4a. 複数の評価用Sub-agent（並列実行）
├─ 4b. Claude Code /review コマンド
└─ 4c. CodeRabbit CLI
↓
5. Review Documentation (_docs/reviews/に統合保存)
↓
6. Automated Fixes (Critical/High優先度の妥当なもののみ)
↓
7. Human Confirmation (Medium優先度の妥当性判断)
↓
8. PR Creation (GitHub PR作成 + CodeRabbitとClaude Codeがレビュー)
↓
9. PR Review Response (妥当なもののみClaude Codeで修正)
↓
10. Merge (+ 人力レビューを適宜挟む)
詳細な各ステップの説明は workflow.md を参照してください。
主要な実行フロー
Step 1-3: 計画と実装
- プランニング: プランモードで実装計画を立案
- ドキュメント化:
_docs/plans/YYYY-MM-DD-[feature-name].md に保存
- 実装: 適切なSub-agentに委任
Step 4-5: 多層レビュー
4a. Sub-agent Reviews（並列実行）:
- code-reviewer
- security-auditor
- architect-review
- test-ai-tdd-expert
4b. Claude Code /review:
/review
4c. CodeRabbit CLI:
coderabbit --prompt-only --type uncommitted
結果を _docs/reviews/YYYY-MM-DD-[feature-name]-review.md に統合保存。
Step 6-7: 修正と確認
- Critical/High: 妥当なもののみ自動修正
- Medium: 人間が妥当性を判断（修正/保留/却下）
- Low: 記録のみ
Step 8-10: PR作成とマージ
- レビューサマリー付きでPR作成
- CodeRabbitとClaude Codeが追加レビュー
- 妥当な指摘のみ修正
- 人力レビューを適宜挟みながらマージ
優先度判定
config.json で定義された優先度ルール:
| 優先度 | 内容 | 対応 |
|---|
| 🔴 Critical | セキュリティ脆弱性、重大なバグ | 妥当なものを即時自動修正 |
| 🟠 High | パフォーマンス問題、設計問題 | 妥当なものを即時自動修正 |
| 🟡 Medium | コード品質、ベストプラクティス | 人間が妥当性判断 |
| 🟢 Low | スタイル、命名、軽微な改善 | 記録のみ |
人間確認ポイント
以下の3つのタイミングで必ず人間の確認を得ます：
- ✅ プラン承認時 (Step 1後)
- ✅ Medium優先度の修正判断時 (Step 7)
- ✅ PR作成前の最終確認 (Step 8前)
前提条件
必要なツール
- Git: バージョン管理
- GitHub CLI (
gh): PR作成・管理
- CodeRabbit CLI: インストール済み & 認証済み
プロジェクト準備
mkdir -p _docs/plans _docs/reviews
設定ファイル
config.json
優先度判定ルールとSub-agent設定を定義:
{
"priority_rules": {
"critical": { "keywords": [...], "patterns": [...] },
"high": { "keywords": [...] },
"medium": { "keywords": [...] },
"low": { "keywords": [...] }
},
"review_agents": [...],
"coderabbit_cli": {...},
"auto_fix_threshold":
テンプレート
templates/plan.md: 実装計画テンプレートtemplates/review.md: レビュー結果テンプレート
重要な考え方
このSkillは、AI駆動開発において**「妥当性」**を重視します。
- ✅ AIレビューの指摘はすべてが正しいわけではない
- ✅ Critical/Highでも誤検知や過剰な提案がある
- ✅ 人間の判断が最も重要
- ✅ プロジェクトの文脈を理解した上で適切に取捨選択
AIはツールです。最終的な判断は常に人間が行います。
関連ファイル
