Executing AI Development Workflow Skill

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: インストール済み & 認証済み

プロジェクト準備

# _docs ディレクトリの作成
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": "high"
}

テンプレート

templates/plan.md: 実装計画テンプレート
templates/review.md: レビュー結果テンプレート

重要な考え方

このSkillは、AI駆動開発において**「妥当性」**を重視します。

✅ AIレビューの指摘はすべてが正しいわけではない
✅ Critical/Highでも誤検知や過剰な提案がある
✅ 人間の判断が最も重要
✅ プロジェクトの文脈を理解した上で適切に取捨選択

AIはツールです。最終的な判断は常に人間が行います。

Agent Skills: Executing AI Development Workflow

Skill Files