oh-my-claudecode
"Don't learn Claude Code. Just use OMC."
Claude Code 向けマルチエージェント・オーケストレーション。ゼロ設定・ゼロ学習コスト。
npm パッケージ名は oh-my-claude-sisyphus、Claude Marketplace では oh-my-claudecode。
- ゼロ設定 — インストール後すぐ使えるインテリジェントなデフォルト設定
- チームファースト —
/team N:executor "..."が正規のマルチエージェント実行面。plan → prd → exec → verify → fixの 5 ステージパイプライン - 自然言語インターフェース — コマンドを覚えなくてよい。やりたいことを書くだけ
- 自動並列化 — 複雑なタスクを専門エージェントへ自動分散。Haiku / Sonnet / Opus を目的で使い分け
- 永続実行 — ralph モードは
verifierが完了を確認するまで絶対に停止しない - スキル学習 — セッションから問題解決パターンを抽出し、次回セッションで自動インジェクション
- リアルタイム可視化 — HUD ステータスバーでオーケストレーション状況を常時確認
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
npm i -g oh-my-claude-sisyphus@latest
/setup
/omc-setup
/omc-doctor
autopilot: build a REST API for managing tasks
/deep-interview "アイデア"
omc team(tmux CLI ワーカー)・レート制限自動再開などは tmux が必要。
macOS → brew install tmux、Windows → winget install psmux(WSL 不要のネイティブ実装)。
| モード | 呼び出し例 | 内容 | 最適用途 |
|---|---|---|---|
| Team | /team 3:executor "..." |
5 ステージパイプライン plan→prd→exec→verify→fix |
複数 Claude エージェントが共有タスクリストで協調する場合(推奨) |
| omc team | omc team 2:codex "..." |
tmux CLI ワーカー claude/codex/gemini を実プロセスで起動 |
Codex・Gemini CLI タスク。完了後に自動終了してリソース消費なし |
| autopilot | autopilot: ... |
5 フェーズ自律パイプライン expand→plan→exec→qa→validate |
アイデアから動くコードまで自動生成。エンド・ツー・エンド |
| ralph | ralph: ... |
完了まで絶対停止しないループ verifier が確認するまで継続 |
サイレントな部分完了を許せないタスク。ultrawork を自動包含 |
| ultrawork | ulw ... |
最大並列実行(非 Team) | Team 不要なバースト並列修正・リファクタリング |
| ccg | /ccg ... |
3 モデル統合 /ask codex + /ask gemini → Claude が統合 |
バックエンド(Codex) + UI(Gemini) を同時レビューして Claude が統合 |
| ralplan | ralplan ... |
Planner・Architect・Critic の合意ループ | 計画の反復的コンセンサス形成 |
| pipeline | 明示指定 | 順次・段階的処理 | 厳密な順序が必要な多段変換 |
OMC は Hooks・Skills・Agents・State の 4 システムが連鎖して動作する。 フックがライフサイクルイベントを検出し、スキルが動作を注入し、エージェントがタスクを実行し、ステートが進捗を永続化する。
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#dbeafe', 'primaryTextColor': '#1e3a5f', 'primaryBorderColor': '#93c5fd', 'lineColor': '#3b82f6', 'edgeLabelBackground': '#f0f7ff', 'fontSize': '15px'}}}%%
flowchart LR
A["User\nInput"] --> B["Hooks\n(event detection)"]
B --> C["Skills\n(behavior injection)"]
C --> D["Agents\n(task execution)"]
D --> E["State\n(.omc/)"]
E -. "notepad / memory" .-> C
Claude Code の 11 ライフサイクルイベントにフックを登録。<system-reminder> タグで追加コンテキストをインジェクション。
| フック名 | イベント | 役割 |
|---|---|---|
keyword-detector | UserPromptSubmit | マジックキーワード検出 → [MAGIC KEYWORD: ...] でスキルを有効化 |
persistent-mode | Stop | ralph/ultrawork がアクティブな間は停止をブロック。"The boulder never stops" |
pre-compact | PreCompact | コンパクション前に重要情報を notepad.md へ保存し、コンテキストリセット後も継続 |
subagent-tracker | SubagentStart/Stop | 実行中エージェントを追跡し、停止時に出力を検証 |
context-guard-stop | Stop | コンテキスト使用量を監視し、上限接近を警告 |
code-simplifier | Stop | (任意)停止時に変更ファイルを自動簡素化。デフォルト無効 |
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#fef9c3', 'primaryTextColor': '#78350f', 'primaryBorderColor': '#fbbf24', 'lineColor': '#d97706', 'fontSize': '14px'}}}%%
flowchart TD
G["Guarantee Layer\nralph — 完了まで停止しない"] --> E["Enhancement Layer\nultrawork, git-master, frontend-ui-ux …"]
E --> X["Execution Layer\ndefault, orchestrate, planner"]
ultrawork: refactor API with proper commits→
ultrawork + default + git-master の 3 スキルが同時活性化式:
[Execution Skill] + [0-N Enhancements] + [Optional Guarantee]
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#dbeafe', 'primaryTextColor': '#1e3a5f', 'primaryBorderColor': '#93c5fd', 'lineColor': '#3b82f6', 'fontSize': '14px'}}}%%
flowchart LR
P["team-plan"] --> R["team-prd"] --> EX["team-exec"] --> V["team-verify"] --> F["team-fix"]
F -. "issues remain" .-> EX
Claude Code native teams を有効化するには ~/.claude/settings.json に
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" を設定。
無効の場合は OMC が警告し非チーム実行にフォールバック。
探索から検証まで開発ライフサイクル全体をカバーする 8 エージェント。
| エージェント | モデル | 役割 |
|---|---|---|
explore | haiku | コードベース探索・ファイル/シンボルマッピング |
analyst | opus | 要件分析・隠れた制約の発見 |
planner | opus | タスクシーケンス作成・実行計画立案 |
architect | opus | システム設計・インターフェース定義・トレードオフ分析 |
debugger | sonnet | 根本原因分析・ビルドエラー解消 |
executor | sonnet | コード実装・リファクタリング |
verifier | sonnet | 完了検証・テスト十分性の確認 |
tracer | sonnet | エビデンス駆動の因果追跡・競合仮説分析 |
| レーン | エージェント | モデル | 役割 |
|---|---|---|---|
| Review | security-reviewer | sonnet | 脆弱性・トラストバウンダリ・認証/認可レビュー |
code-reviewer | opus | 包括的コードレビュー・API 契約・後方互換性確認 | |
| Domain | test-engineer | sonnet | テスト戦略・カバレッジ・フレイキーテスト対策 |
designer | sonnet | UI/UX アーキテクチャ・インタラクションデザイン | |
writer | haiku | ドキュメント・マイグレーションノート作成 | |
qa-tester | sonnet | tmux 経由での CLI/サービスランタイム検証 | |
scientist | sonnet | データ分析・統計調査 | |
git-master | sonnet | Git 操作・コミット・リベース・履歴管理 | |
code-simplifier | opus | コードの明確化・単純化・保守性向上 | |
| Coord | critic | opus | 計画・設計のギャップ分析(多角的レビュー)。Gap がなくなるまでループ |
モデルルーティング — 3 ティア
| ティア | モデル | 特性 | 割り当てエージェント |
|---|---|---|---|
| LOW | haiku | 高速・低コスト | explore, writer |
| MEDIUM | sonnet | バランス | executor, debugger, test-engineer, designer … |
| HIGH | opus | 最高品質推論 | architect, planner, critic, code-reviewer, analyst |
explore → analyst → planner → critic → executor → verifier
セッションで獲得したデバッグ知識をポータブルな YAML スキルファイルに抽出。 関連するときにコンテキストへ自動インジェクションされ、手動リコールは不要。
# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Wrap handler at server.py:42 in try/except ClientDisconnectedError...
.omc/skills/
バージョン管理・チーム共有。優先度 高(ユーザースコープを上書き)
~/.omc/skills/
全プロジェクト共通。優先度 低(フォールバック)
/skill list | add | remove | edit | search自動学習:
/learner で厳格な品質ゲート付きパターン抽出
プロンプトにキーワードを含めるだけで対応スキルが自動起動。
autopilot・ralph・ccg はフックにハードコードされており config では変更不可。
| キーワード | 効果 | 使用例 |
|---|---|---|
| team | Team オーケストレーション(正規 API) | /team 3:executor "fix TypeScript errors" |
| omc team | tmux CLI ワーカー | omc team 2:codex "security review" |
| ccg | 3 モデル統合アドバイス | /ccg review this PR |
| autopilot | 完全自律実行パイプライン | autopilot: build a todo app |
| ralph | 永続モード(完了まで停止しない) | ralph: refactor auth |
| ulw | 最大並列実行(ultrawork) | ulw fix all errors |
| ralplan | 反復的計画コンセンサス | ralplan this feature |
| deep-interview | Socratic 式要件明確化 | /deep-interview "vague idea" |
| ultrathink | 深い推論モード | ultrathink about this architecture |
| tdd | テスト駆動開発ワークフロー | tdd: implement payment flow |
| stopomc | アクティブモードを即時停止 | stopomc |
.omc/
├── state/
│ ├── autopilot-state.json # autopilot フェーズ進捗
│ ├── ralph-state.json # ralph ループ状態
│ └── sessions/{sessionId}/ # セッション別ステート
├── notepad.md # コンパクション耐性メモパッド
├── project-memory.json # プロジェクト知識ストア (セッション横断)
├── plans/ # 実行計画ファイル
├── notepads/{plan-name}/
│ ├── learnings.md # 成功パターン・規約
│ ├── decisions.md # 設計判断と根拠
│ ├── issues.md # 問題・ブロッカー
│ └── problems.md # 技術的負債・注意点
├── autopilot/spec.md # autopilot 仕様書
├── artifacts/ask/ # omc ask の出力 Markdown
└── logs/ # 実行ログ
PreCompact フックが重要情報を notepad.md に保存。
コンパクション後も再インジェクションされ文脈が継続。
<remember priority>... タグで永続メモを作成可能。
ワークツリー削除後も状態を保持するには export OMC_STATE_DIR="$HOME/.claude/omc" を設定。
プロジェクト識別子は Git リモート URL のハッシュなので同リポジトリで共有される。
| コマンド | 説明 |
|---|---|
omc ask claude "..." | ローカル Claude CLI を呼び出し結果を .omc/artifacts/ask/ に Markdown 保存 |
omc ask codex|gemini "..." | Codex / Gemini CLI へのプロキシ + 結果保存 |
omc wait --start | レート制限リセット時の自動再開デーモン(tmux 必須) |
omc hud | HUD ライブレンダリング。オーケストレーション状況をステータスバーに表示 |
omc team status <name> | 実行中チームタスクの状態確認 |
omc team shutdown <name> | 指定チームを停止 |
/omc-doctor | インストール診断・プラグインキャッシュクリア |
/learner | セッションから再利用可能スキルを品質ゲート付きで抽出 |
/deepinit | プロジェクトの階層的 AGENTS.md を自動生成 |
セッション完了サマリーを Telegram・Discord・Slack へ自動送信。
omc config-stop-callback telegram --enable --token <tok> --chat <id> --tag-list "@alice" で設定。
OpenClaw Gateway: Claude Code セッションイベント(session-start, stop, keyword-detector など 6 種)を
外部エージェントへフォワード。/oh-my-claudecode:configure-notifications でウィザード起動。