ai_agent_orchestra
Claude Code, GitHub Copilot の AI エージェント設定を単一ソースから管理
概要
このリポジトリは、複数の AI コーディングエージェント（Claude Code, GitHub Copilot）の設定を統一的に管理するためのシステムを提供します。
主な特徴
- 統一ソース管理:
.agents/ に定義した Rules, Skills, Agents を各エージェント向けに自動変換
- クロスプラットフォーム互換性:
CLAUDE.md ファイルで Claude Code と Copilot の両方に対応
- 自動同期: Git hooks による変更の自動反映
- プロジェクト再利用: ホームディレクトリにコピーして全プロジェクトで利用可能
サポート対象
| エージェント | Rules | Skills | Subagents | Commands |
|---|
| Claude Code | ✅ .claude/rules/*.md | ✅ .claude/skills/* | ✅ .claude/agents/*.md | ✅ .claude/commands/ |
| GitHub Copilot | ✅ .github/copilot-instructions.md | ✅ .github/skills/* | ✅ .github/agents/*.agents.md | ✅ .github/prompts/ |
クイックスタート
npx で導入（推奨）
# プロジェクトルートで初期化（npm publish 不要、GitHub から直接実行）
npx github:farmanlab/ai_agent_orchestra init
# 対話式プロンプトでフォルダ名とエージェントを選択
# ? Unified folder name (.agents): .agents
# ? Enable Claude Code? (Y/n): Y
# ? Enable GitHub Copilot? (Y/n): Y
# 同期実行
npx github:farmanlab/ai_agent_orchestra sync
CLI フラグでも指定可能:
npx github:farmanlab/ai_agent_orchestra init --dir .agent --agents claude,copilot
短縮コマンド aao も使えます（グローバルインストール時）:
npm install -g github:farmanlab/ai_agent_orchestra
aao init
aao sync
リポジトリをクローンして使う場合
git clone https://github.com/farmanlab/ai_agent_orchestra.git
cd ai_agent_orchestra
.agents/scripts/sync/sync.sh all
既存プロジェクトに手動で追加する場合
cp -r /path/to/ai_agent_orchestra/.agents .
.agents/scripts/sync/sync.sh all
git add .agents/ .claude/ .github/ CLAUDE.md AGENTS.md
git commit -m "Add AI agent configuration"
ホームディレクトリにコピーして全プロジェクトで使う
git clone https://github.com/farmanlab/ai_agent_orchestra.git
cd ai_agent_orchestra
./scripts/copy_to_home.sh
強制上書きする場合:
./scripts/copy_to_home.sh -f
使い方
ルールを追加する
# 新しいルールファイルを作成
cat > .agents/rules/my-rule.md << 'EOF'
---
name: my-rule
description: 私のカスタムルール
---
# My Custom Rule
- ここにルールを記述
EOF
# 同期して各エージェント向けに変換
.agents/scripts/sync/sync.sh all
スキルを追加する
# スキルフォルダを作成
mkdir -p .agents/skills/my-skill
# SKILL.md を作成
cat > .agents/skills/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: 私のカスタムスキル
triggers: [keyword1, keyword2]
---
# My Skill
スキルの内容...
EOF
# 同期
.agents/scripts/sync/sync.sh all
エージェントを追加する
# エージェントファイルを作成
cat > .agents/agents/my-agent.md << 'EOF'
---
name: my-agent
description: 私のカスタムエージェント
tools: [Read, Write, Bash]
model: sonnet
---
# My Agent
あなたは〜として...
EOF
# 同期
.agents/scripts/sync/sync.sh all
コマンドを追加する
# コマンドファイルを作成
cat > .agents/commands/my-command.md << 'EOF'
---
description: 私のカスタムコマンド
argument-hint: [引数のヒント]
---
# My Command
## 指示
コマンドの詳細な指示...
EOF
# 同期
.agents/scripts/sync/sync.sh all
# 使用方法：Claude Code で
# /my-command [引数]
ディレクトリ構造
.agents/ # 統一ソース（編集対象）
├── README.md # 詳細ドキュメント
├── config.yaml # 設定ファイル
├── rules/ # ルール定義
│ ├── _base.md # 基本ルール
│ ├── architecture.md # アーキテクチャ原則
│ └── testing.md # テスト規約
├── skills/ # スキル定義
│ └── code-review/
│ ├── SKILL.md
│ ├── patterns.md
│ └── checklist.md
├── agents/ # エージェント定義
│ ├── code-reviewer.md
│ ├── implementer.md
│ └── researcher.md
├── commands/ # コマンド定義（Slash Commands）
│ └── pr-review.md # /pr-review コマンド
└── sync/ # 同期スクリプト
├── sync.sh # メインスクリプト
├── to-claude.sh
└── to-copilot.sh
# 生成されるファイル（自動生成、編集不要）
# ※ skills/, agents/ は .agents/ へのシンボリックリンク（ファイル単位）
# 各エージェント固有のファイルを追加可能
CLAUDE.md # Claude + Copilot 共通 (-> AGENTS.md)
AGENTS.md # Copilot エージェント定義
.claude/ # Claude Code 用
├── rules/
├── skills/ # → .agents/skills/* (symlinks)
├── agents/ # → .agents/agents/* (symlinks)
└── commands/ # Slash Commands
.github/ # GitHub Copilot 用
├── copilot-instructions.md
├── instructions/
├── skills/ # → .agents/skills/* (symlinks)
├── agents/ # *.agents.md (symlinks)
└── prompts/ # GitHub Prompts
詳細ドキュメント
詳しい使い方は .agents/README.md を参照してください。
コマンドリファレンス
CLI (aao / npx github:farmanlab/ai_agent_orchestra)
