aidlc

AI Development Skills

AI-DLC (AI-Driven Development Life Cycle) と Everything Claude Code を組み合わせた開発ワークフロースキル集です。

対応ハーネス: Claude Code / Cursor

特徴

aidlc プラグイン — 構造化された開発ワークフロー

• フェーズ管理: 要件定義 → 設計 → 人レビュー → サブタスク分割 → 実装 → PR作成 の全フェーズをガイド
• PR単位のタスク管理: サブタスク = PR単位で分割。ローカルファイルまたは GitHub Issue で管理
• デプロイ粒度でPR分離: サーバー/フロント等を別PRにし、非同期デプロイに対応
• PRサイズ制御: ±150行を目安にレビューしやすいPRを維持
• スクリプト生成ファイルの分離: [scripts] プレフィックス付き別コミットで追跡性を確保
• Human Review Gate: 設計フェーズ後に人の承認を必須とするゲート
• TDDワークフロー強化: ECCのTDDワークフローを統合し、80%+カバレッジを目標化
• 検証ループ統合: PR作成前にビルド・型チェック・Lint・テスト・セキュリティスキャンを包括実行

ecc プラグイン — 実戦で鍛えられたツールキット

affaan-m/everything-claude-code (v1.8.0) から取り込んだスキル・コマンド・エージェント。Go/Python固有のものを除外し、TypeScript/言語非依存のものを収録。

• 28スキル: 開発ワークフロー、バックエンド、フロントエンド、コンテンツ作成、リサーチ、外部API連携
• 40コマンド: 開発、計画、セッション管理、継続学習、メタツール、ドキュメント
• 15エージェント: 設計・レビュー・テスト・セキュリティ等の専門エージェント（モデル別最適配置）

インストール

Claude Code

方法1: プラグインとしてインストール (推奨)

# Step 1: マーケットプレースを追加 (初回のみ)
/plugin marketplace add tatematsu-k/ai-development-skills

# Step 2: プラグインをインストール
/plugin install aidlc@aidlc-skills
/plugin install ecc@aidlc-skills

方法2: 手動コピー

# このリポジトリをクローン
git clone https://github.com/tatematsu-k/ai-development-skills.git /tmp/ai-development-skills

# aidlc プラグインをコピー
mkdir -p /path/to/your-project/.claude/skills /path/to/your-project/.claude/commands
cp -r /tmp/ai-development-skills/plugins/aidlc/skills/* /path/to/your-project/.claude/skills/
cp /tmp/ai-development-skills/plugins/aidlc/commands/* /path/to/your-project/.claude/commands/

# ecc プラグインをコピー
cp -r /tmp/ai-development-skills/plugins/ecc/skills/* /path/to/your-project/.claude/skills/
cp /tmp/ai-development-skills/plugins/ecc/commands/* /path/to/your-project/.claude/commands/
mkdir -p /path/to/your-project/.claude/agents
cp /tmp/ai-development-skills/plugins/ecc/agents/* /path/to/your-project/.claude/agents/

# CLAUDE.md のルールを対象プロジェクトに追記
cat /tmp/ai-development-skills/CLAUDE.md >> /path/to/your-project/CLAUDE.md

アンインストール (プラグイン)

/plugin uninstall aidlc
/plugin uninstall ecc

確認

/aidlc

「要件定義フェーズを開始します」と応答されれば正常にインストールされています。

Cursor

スキル・コマンド・エージェントを Cursor の .cursor/rules/ 形式 (.mdc) に変換して利用できます。

方法1: インストールスクリプト (推奨)

# このリポジトリをクローン
git clone https://github.com/tatematsu-k/ai-development-skills.git /tmp/ai-development-skills

# 対象プロジェクトにルールをインストール
bash /tmp/ai-development-skills/scripts/install-cursor-rules.sh /path/to/your-project

# 特定プラグインのみインストールする場合
bash /tmp/ai-development-skills/scripts/install-cursor-rules.sh --plugin=aidlc /path/to/your-project
bash /tmp/ai-development-skills/scripts/install-cursor-rules.sh --plugin=ecc /path/to/your-project

# シンボリックリンクで常に最新を参照する場合
bash /tmp/ai-development-skills/scripts/install-cursor-rules.sh --symlink /path/to/your-project

方法2: 手動コピー

git clone https://github.com/tatematsu-k/ai-development-skills.git /tmp/ai-development-skills
mkdir -p /path/to/your-project/.cursor/rules
cp /tmp/ai-development-skills/cursor/rules/*.mdc /path/to/your-project/.cursor/rules/

ルールのカスタマイズ

インストール後、各 .mdc ファイルのフロントマターを編集して挙動を調整できます:

---
description: "ルールの説明 (Cursorが自動判定に使用)"
globs: "**/*.ts"          # 特定ファイルパターンに限定
alwaysApply: true         # 常に適用 (デフォルト: false)
---

フィールド	説明
description	ルールの適用条件の説明。Cursor が会話の文脈に基づいて自動適用を判定する
globs	ファイルパターン指定。マッチするファイルを扱う際に自動で適用される
alwaysApply	true にすると全ての会話で常に適用される

ルールの再生成

元のスキル定義を変更した場合、.mdc ファイルを再生成できます:

bash scripts/generate-cursor-rules.sh

アンインストール

rm /path/to/your-project/.cursor/rules/aidlc--*.mdc
rm /path/to/your-project/.cursor/rules/ecc--*.mdc

Cursor での制約事項

Claude Code と Cursor では利用可能な機能に差異があります:

機能	Claude Code	Cursor
スキル (開発パターン・ガイドライン)	✅	✅
コマンド (ワークフロー指示)	✅ /command	✅ ルールとして参照
エージェント (専門レビュアー)	✅ 自動起動	✅ ルールとして参照
フック (PreToolUse/PostToolUse)	✅	❌ 非対応
セッション管理	✅	❌ 非対応
プラグインマーケットプレース	✅	❌ 非対応
モデルルーティング (opus/sonnet/haiku)	✅	❌ 非対応

使い方

aidlc: ワークフローの開始

/aidlc ユーザーのプロフィール画像アップロード機能を追加したい

これにより以下のフェーズが順に実行されます:

Phase 1: Inception (要件定義 + 設計)

1. 要件定義 — 対話を通じて要件を明確化
   成果物: aidlc-docs/requirements/YYYY-MM-DD-<feature>.md

2. システム設計 — API設計・シーケンス図・デプロイ依存関係マップ
   成果物: aidlc-docs/designs/YYYY-MM-DD-<feature>.md

3. Human Review Gate — あなたが設計書をレビューし承認

Phase 2: Construction (実装)

4. サブタスク分割 — PR単位でタスクを分割
   管理先: ローカルファイル or GitHub Issue (初回に選択)

5. 実装 — サブタスク単位でTDD実装・コミット (80%+カバレッジ)
   ↓
6. PR作成 — 検証ループ実行 → PRを作成しタスクステータスを更新
   ↓
   (5→6 をサブタスクの数だけ繰り返し)

ecc: 個別コマンドの利用

# TDD で実装
/tdd

# コードレビュー
/code-review

# 実装計画を作成
/plan

# エージェントによるオーケストレーション
/orchestrate