magi

# MAGI System Orchestrator Skill

## 重要: 必ず専用エージェントを使用すること

**MAGIを使う場合は、現在のコンテキストで直接実行しないでください。**

必ず `Task` ツールで `magi-system-orchestrator` エージェントを起動してください：

```
Task(subagent_type="magi-system-orchestrator", prompt="<依頼内容>")
```

理由:
- 現在のコンテキストで実行すると、大量のCLI出力でトークンが爆発する
- 専用エージェントなら、完了後に要約だけをメインへ返せる
- 並列CLI実行のセッション管理が安定する

## ClaudeCodeサブエージェント方針
- ステータス: 必須（ClaudeCodeサブエージェントで起動）
- 理由: Codex/Gemini/Claudeの多視点協調を行う際に大量のCLIとログを並列で扱うため、専用サブエージェントでセッションを固定しないと手順崩壊につながる。
- メモ: サブエージェント内で可用性チェック→ペルソナ投入→統合→ログ整理までをワンセットとして扱い、完了後に要約だけをメインへ返す。

## エージェント起動時の必須事項

**magi-system-orchestratorエージェントとして起動された場合、このスキルの内容に従って実行すること。**

スキルを読まずに実行すると、CLIパターンやトークン削減手法が適用されず、非効率な実行になる。

MAGIは複雑な意思決定や多視点レビューのための標準オペレーションです。このSkillを参照し、長文のエージェント定義の代わりにここで定義された手順とテンプレートを読み込んでください。

## 使うべきケース

- 大規模アーキテクチャ選定・投資判断・複数案比較のように、単独エージェントでは偏りが出るタスク。
- ユーザーから「MAGI」「多視点レビュー」「Codex/Geminiも巻き込んで」などの明示的な依頼があるとき。
- 実装フェーズでも根本方針を伴う場合（単純なbugfixなら通常Claudeで十分）。

## 実行フロー概要

1. **ゴール把握**: 予算/制約/成功指標を聞き出し、揃わなければ Stop-if-Unclear を発動。
2. **可用性チェック**: Codex/GPT-5とGeminiのCLIを同時に立ち上げられるか疎通（`docs/PLAYBOOK.md`参照）。必ず `script -q /dev/null` で疑似TTYを確保して実行する（TTY無しは失敗する）。
3. **フェーズ1**: 3ペルソナを並列実行し、互いに参照させずに初期アウトプットを取得。
4. **フェーズ2**: Geminiが統合プランをまとめ、共通点・トレードオフ・リスク・フォローアップを整理。
5. **セルフチェック**: `docs/CHECKLIST.md`に沿って検証し、満たせない場合は理由を報告。

詳細手順・CLIルールは `docs/PLAYBOOK.md` を参照。

## CLIチートシート

| Persona | コマンド例 |
| --- | --- |
| Codex/GPT-5 | `outfile=$(mktemp -t codex); script -q /dev/null codex --sandbox workspace-write --config sandbox_workspace_write.network_access=true --dangerously-bypass-approvals-and-sandbox exec --skip-git-repo-check -o "$outfile" "<prompt>" >/dev/null 2>&1; cat "$outfile"` |
| Codex/GPT-5 (書込み有) | `outfile=$(mktemp -t codex); script -q /dev/null codex --sandbox workspace-write --config sandbox_workspace_write.network_access=true --dangerously-bypass-approvals-and-sandbox exec --skip-git-repo-check --full-auto -o "$outfile" "<prompt>" >/dev/null 2>&1; cat "$outfile"` |
| Gemini | `script -q /dev/null