AI Coding Agentで複数処理を一括実行する3つの方法 - 徹底比較
⚠️ 重要な注意事項
Agent SkillsはBob IDEの公式機能ではありません。本記事で紹介するAgent Skills型の実装は同僚の検証により動作確認済みですが、Bob IDEの公式サポート対象外です。
- 動作保証: なし(但し動作確認済み)
- 推奨環境: Agent Skills対応の30+製品(Cursor、VS Code、GitHub Copilot等)
- Bob IDE使用時: 十分な動作確認を実施してください
- 代替案: 公式サポートが必要な場合はカスタムモード型をご検討ください
筆者の見解: Agent SkillsはBob IDEのGA(一般提供)と共に公式サポートされる可能性が高いと考えています。そのため、筆者はカスタムモード型ではなく、Agent Skills型を採用する方針で検討を進めています。
📝 TL;DR(要約)
AI Coding Agentで複数の処理を順次実行する方法として、3つの実装方式を比較します。
3つの実装方式
| 方式 | 特徴 | 推奨度 |
|---|---|---|
| Agent Skills型 | 業界標準(30+製品対応)、マークダウンのみ | ⭐⭐⭐⭐⭐ |
| カスタムモード型 | Bob IDE専用、マークダウンのみ | ⭐⭐⭐⭐ |
| MCPサーバー型 | MCP対応製品、TypeScript実装 | ⭐⭐⭐ |
推奨事項
- 第1選択: Agent Skills型(業界標準、高い汎用性)
- 第2選択: カスタムモード型(Bob IDE専用、公式サポート)
- 第3選択: MCPサーバー型(複雑なロジック、npm配布)
この記事で分かること
- 3つの実装方式の技術的特徴
- セットアップの難易度と手順
- 機能実現可能性の比較
- 汎用性と将来性の評価
- 使い分けのポイント
1. はじめに
1.1 背景
AI Coding Agent(Bob IDE、Cursor、GitHub Copilot等)を使って、複数の処理を順次実行したいケースがあります。
例: CI/CDパイプラインの自動構築
- 実行環境の確認
- 黄金パターンの選択
- IaCコードの生成
- Gitへの登録
- IaCコードのデプロイ
これらを一つのコマンドで自動実行したい場合、どのような実装方式があるでしょうか?
1.2 3つの実装方式
本記事では、以下の3つの実装方式を比較します:
- Agent Skills型: 業界標準のスキル定義フォーマット
- カスタムモード型: Bob IDE専用のカスタムモード機能
- MCPサーバー型: Model Context Protocol準拠のサーバー実装
2. 各実装方式の概要
2.1 Agent Skills型
概要
Agent Skillsは、業界標準のスキル定義フォーマットで、30以上のCoding Agentが対応しています。
対応製品(一部)
- 主要IDE: Cursor, VS Code, Claude Code
- AI Assistant: GitHub Copilot, Gemini CLI, OpenAI Codex
- 開発ツール: OpenCode, OpenHands, Mux, Autohand Code CLI
- エンタープライズ: Databricks, Factory, Spring AI
- その他25製品以上
ディレクトリ構成
.bob/skills/autonomous-pipeline-deploy/
├── SKILL.md # メインスキル定義
└── references/
├── step5-check-environment.md
├── step6-select-pattern.md
├── step7-generate-iac.md
├── step8-commit-to-git.md
└── step9-deploy-iac.md
実装ファイル
- SKILL.md: 全体の処理順序を定義
- references/*.md: 各ステップの詳細を定義
- .bob/commands/pipeline.md: スラッシュコマンド定義
- .bob/rules/bob_skills.md: スキル登録
実行方法
/pipeline requirements.md
2.2 カスタムモード型
概要
カスタムモードは、Bob IDE専用の機能で、マークダウンファイルでモードを定義します。
対応製品
- Bob IDEのみ(公式サポート)
ディレクトリ構成
.bob/modes/
└── autonomous-pipeline-deploy.md
実装ファイル
- autonomous-pipeline-deploy.md: モード定義(全ステップを含む)
実行方法
# モード切り替え
@autonomous-pipeline-deploy
# 処理実行
requirements.mdに基づいてCI/CDパイプラインを構築してください
2.3 MCPサーバー型
概要
MCPサーバーは、Model Context Protocol準拠のサーバーで、TypeScriptで実装します。
対応製品
- Claude Desktop
- Bob IDE(MCP対応)
- その他MCP対応製品
ディレクトリ構成
autonomous-pipeline-deploy-mcp/
├── package.json
├── tsconfig.json
└── src/
└── index.ts
実装ファイル
- src/index.ts: MCPサーバー実装(TypeScript)
- package.json: npm設定
実行方法
# MCPサーバー起動(別プロセス)
npm start
# Bob IDEから使用
/pipeline requirements.md
3. 技術的特徴の比較
3.1 実装言語・技術
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 実装言語 | マークダウン | マークダウン | TypeScript |
| 追加依存 | なし | なし | Node.js, npm |
| ビルド | 不要 | 不要 | 必要 |
| 学習コスト | 低 | 低 | 高 |
3.2 セットアップ
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| ファイル数 | 8ファイル | 1ファイル | 3ファイル + 依存 |
| 設定ファイル | 3ファイル | 1ファイル | 2ファイル + MCP設定 |
| 所要時間 | 約10分 | 約5分 | 約30分 |
| 難易度 | 低 | 低 | 高 |
3.3 実装場所
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 実装場所 | プロジェクト内(.bob/skills/) |
プロジェクト内(.bob/modes/) |
外部サーバー |
| 配布方法 | Gitリポジトリ | Gitリポジトリ | npm公開 |
| 再利用性 | プロジェクト単位 | プロジェクト単位 | グローバル |
3.4 対応製品
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 対応製品数 | 30+製品 | 1製品(Bob IDE) | MCP対応製品 |
| 業界標準 | ✅ Agent Skills標準 | ❌ Bob IDE独自 | ✅ MCP標準 |
| 汎用性 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐ |
| 将来性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
4. 機能実現可能性の比較
4.1 複数処理の順次実行
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 実現方法 | SKILL.md + references/ | 単一マークダウン | TypeScriptコード |
| 処理順序定義 | ✅ 明示的 | ✅ 明示的 | ✅ プログラマティック |
| ステップ分離 | ✅ ファイル単位 | ❌ セクション単位 | ✅ 関数単位 |
| 保守性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
4.2 エラーハンドリング
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| エラー検出 | ✅ AI判断 | ✅ AI判断 | ✅ try-catch |
| リトライ | ✅ 可能 | ✅ 可能 | ✅ 可能 |
| ロールバック | 🟡 手動 | 🟡 手動 | ✅ 自動可能 |
4.3 外部ツール連携
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| CLIコマンド | ✅ execute_command | ✅ execute_command | ✅ child_process |
| ファイル操作 | ✅ read/write_file | ✅ read/write_file | ✅ fs module |
| API呼び出し | 🟡 間接的 | 🟡 間接的 | ✅ 直接可能 |
| 複雑なロジック | 🟡 制限あり | 🟡 制限あり | ✅ 自由 |
4.4 状態管理
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| ステップ間データ | 🟡 AI記憶 | 🟡 AI記憶 | ✅ 変数保持 |
| 永続化 | ❌ 不可 | ❌ 不可 | ✅ 可能 |
| セッション管理 | 🟡 AI依存 | 🟡 AI依存 | ✅ 明示的 |
5. 実装難易度とコストの比較
5.1 初期実装コスト
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 学習時間 | 1-2時間 | 30分-1時間 | 4-8時間 |
| 実装時間 | 2-4時間 | 1-2時間 | 8-16時間 |
| 必要スキル | マークダウン | マークダウン | TypeScript, Node.js |
| 総コスト | ⭐⭐ | ⭐ | ⭐⭐⭐⭐⭐ |
5.2 保守コスト
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 更新容易性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| デバッグ | 🟡 AI依存 | 🟡 AI依存 | ✅ 標準ツール |
| テスト | 🟡 手動 | 🟡 手動 | ✅ 自動化可能 |
| ドキュメント | ✅ マークダウン | ✅ マークダウン | 🟡 別途必要 |
5.3 配布・共有コスト
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 配布方法 | Git clone | Git clone | npm install |
| セットアップ | ファイルコピー | ファイルコピー | npm install + 設定 |
| バージョン管理 | Git | Git | npm + Git |
| 依存管理 | なし | なし | package.json |
6. 使い分けのポイント
6.1 推奨シーン
Agent Skills型を推奨
✅ 以下の場合に最適:
- 複数のCoding Agentで使用したい
- 業界標準に準拠したい
- 簡単に実装・保守したい
- チーム内で共有したい
- 将来性を重視したい
カスタムモード型を推奨
✅ 以下の場合に最適:
- Bob IDEのみで使用する
- 公式サポートを重視する
- 最も簡単な実装を求める
- 単一ファイルで管理したい
MCPサーバー型を推奨
✅ 以下の場合に最適:
- 複雑なロジックが必要
- 外部APIと直接連携したい
- 状態管理が重要
- npm公開して広く配布したい
- TypeScriptの知識がある
6.2 選択フローチャート
6.3 実装方式の組み合わせ
複数の方式を組み合わせることも可能です:
例: Agent Skills + MCPサーバー
- Agent Skillsでワークフローをオーケストレーション
- 複雑な処理はMCPサーバーに委譲
例: カスタムモード + Agent Skills
- カスタムモードで簡易版を実装
- Agent Skillsで他製品対応版を実装
7. 実装例の比較
7.1 Agent Skills型の実装
ディレクトリ構成:
.bob/
├── skills/autonomous-pipeline-deploy/
│ ├── SKILL.md
│ └── references/
│ ├── step5-check-environment.md
│ ├── step6-select-pattern.md
│ ├── step7-generate-iac.md
│ ├── step8-commit-to-git.md
│ └── step9-deploy-iac.md
├── commands/
│ └── pipeline.md
└── rules/
└── bob_skills.md
SKILL.md(抜粋):
# 自律型パイプラインデプロイ
## 実行フロー
以下のステップを順次実行します:
1. **環境確認** (`references/step5-check-environment.md`)
2. **パターン選択** (`references/step6-select-pattern.md`)
3. **IaC生成** (`references/step7-generate-iac.md`)
4. **Git登録** (`references/step8-commit-to-git.md`)
5. **デプロイ実行** (`references/step9-deploy-iac.md`)
実行:
/pipeline requirements.md
7.2 カスタムモード型の実装
ディレクトリ構成:
.bob/modes/
└── autonomous-pipeline-deploy.md
autonomous-pipeline-deploy.md(抜粋):
---
name: 自律型パイプラインデプロイ
slug: autonomous-pipeline-deploy
---
# 処理フロー
## ステップ5: 実行環境の確認
[詳細な手順...]
## ステップ6: 黄金パターンの選択
[詳細な手順...]
## ステップ7: IaC自動作成
[詳細な手順...]
## ステップ8: Gitへの登録
[詳細な手順...]
## ステップ9: IaCコードのデプロイ
[詳細な手順...]
実行:
@autonomous-pipeline-deploy
requirements.mdに基づいてCI/CDパイプラインを構築してください
7.3 MCPサーバー型の実装
ディレクトリ構成:
autonomous-pipeline-deploy-mcp/
├── package.json
├── tsconfig.json
└── src/
└── index.ts
src/index.ts(抜粋):
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new Server({
name: "autonomous-pipeline-deploy",
version: "1.0.0",
});
server.setRequestHandler(CallToolRequestSchema, async (request) => {
if (request.params.name === "deploy_pipeline") {
// ステップ5-9を順次実行
const step5Result = await checkEnvironment(args);
const step6Result = await selectPattern(step5Result);
const step7Result = await generateIaC(step6Result);
const step8Result = await commitToGit(step7Result);
const step9Result = await deployIaC(step8Result);
return { content: [{ type: "text", text: step9Result }] };
}
});
実行:
# MCPサーバー起動
npm start
# Bob IDEから使用
/pipeline requirements.md
8. パフォーマンスと制限事項
8.1 実行速度
| 項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 起動時間 | 即座 | 即座 | 数秒(サーバー起動) |
| 処理速度 | AI依存 | AI依存 | 高速 |
| 並列処理 | 🟡 制限あり | 🟡 制限あり | ✅ 可能 |
8.2 制限事項
Agent Skills型
- ❌ Bob IDEでは非公式(但し動作確認済)
- 🟡 複雑なロジックは実装困難
- 🟡 状態管理はAI依存
カスタムモード型
- ❌ Bob IDE専用(他製品で使用不可)
- 🟡 単一ファイルで管理(大規模化で保守困難)
- 🟡 複雑なロジックは実装困難
MCPサーバー型
- ❌ TypeScriptの知識が必要
- ❌ ビルドとデプロイの手間
- ❌ 別プロセスでサーバー起動が必要
9. まとめ
9.1 総合評価
| 評価項目 | Agent Skills型 | カスタムモード型 | MCPサーバー型 |
|---|---|---|---|
| 実装容易性 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐ |
| 保守性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
| 汎用性 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐ |
| 機能性 | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 将来性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
| 総合 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
9.2 推奨事項
第1選択: Agent Skills型
理由:
- ✅ 業界標準(30+製品対応)
- ✅ 高い汎用性と将来性
- ✅ マークダウンのみで実装可能
- ✅ 優れた保守性
推奨シーン:
- チーム内での共有
- 複数製品での使用
- 長期的な保守
第2選択: カスタムモード型
理由:
- ✅ Bob IDEの公式サポート
- ✅ 最も簡単な実装
- ✅ 単一ファイルで管理
推奨シーン:
- Bob IDE専用
- 小規模なワークフロー
- 迅速なプロトタイピング
第3選択: MCPサーバー型
理由:
- ✅ 複雑なロジックに対応
- ✅ 外部APIとの直接連携
- ✅ npm公開で広く配布
推奨シーン:
- 複雑な処理が必要
- TypeScriptの知識がある
- 広範囲での配布
9.3 今後の展望
Agent Skills
- 対応製品の増加(現在30+)
- 標準化の進展
- エコシステムの拡大
カスタムモード
- Bob IDEの機能拡張
- 他製品への影響
MCPサーバー
- MCP対応製品の増加
- プロトコルの標準化
- エコシステムの成熟
10. 参考資料
10.1 公式ドキュメント
- Agent Skills: https://github.com/agent-skills/agent-skills
- Bob IDE: https://www.ibm.com/products/watsonx-code-assistant
- MCP: https://modelcontextprotocol.io/
10.2 関連記事
10.3 実装例
- Agent Skills実装例: GitHub Repository
- カスタムモード実装例: GitHub Repository
- MCPサーバー実装例: GitHub Repository
おわりに
この記事では、AI Coding Agentで複数処理を一括実行する3つの実装方式を比較しました。
選択のポイント
- 業界標準と汎用性を重視: Agent Skills型
- Bob IDE専用で簡単実装: カスタムモード型
- 複雑なロジックと機能性: MCPサーバー型
それぞれの方式には長所と短所があります。プロジェクトの要件、チームのスキルセット、将来の展望を考慮して、最適な方式を選択してください。
ぜひ、この記事を参考に、あなたのプロジェクトに最適な実装方式を見つけてください!