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`)

aao init                     # 対話式で初期化
aao init --dir .agent --agents claude,copilot  # フラグ指定
aao update                   # sync スクリプトを最新版に更新
aao sync                     # 全エージェントに同期
aao sync claude              # Claude Code のみ
aao sync copilot             # GitHub Copilot のみ
aao reverse                  # 逆同期（全エージェントから）
aao reverse claude           # Claude Code から逆同期
aao validate                 # 構造とコンテンツを検証
aao check-size               # プロンプトサイズチェック
aao check-quality            # プロンプト品質チェック
aao plugins                  # プラグイン同期
aao install-hooks            # Git hooks インストール
aao clean                    # 生成ファイルをクリーンアップ
aao prune rules/foo.md       # ファイルと同期先を一括削除
aao --verbose sync           # 詳細ログ表示
aao --dry-run sync           # ドライラン

直接スクリプト実行

.agents/scripts/sync/sync.sh all
.agents/scripts/sync/sync.sh claude
.agents/scripts/sync/sync.sh --verbose all
.agents/scripts/sync/sync.sh --dry-run all

トラブルシューティング

同期が動かない

# 実行権限を確認
chmod +x .agents/scripts/sync/*.sh

# 詳細ログで実行
.agents/scripts/sync/sync.sh --verbose all

変更が反映されない

Claude Code: 新しいセッションを開始
GitHub Copilot: VS Code をリロード

ライセンス

MIT License

Name	ensuring-prompt-quality
Description	Validates prompt files against best practices. Use after creating or editing rules, skills, agents, commands in .agents/ for quality review.

ensuring-prompt-quality

SKILL.md