OMCセットアップ

OMCセットアップ は何をしますか？

これがあなたが覚えるべき唯一のコマンドです。これを実行した後は、他のすべてが自動的に行われます。

このスキルが呼び出されたら、以下のワークフローを直ちに実行してください。これらの指示を単に言い換えたり要約したりしてユーザーに伝えるだけではいけません。

注意: このガイド内のすべての ~/.claude/... パスは、CLAUDE_CONFIG_DIR 環境変数が設定されている場合、その値を尊重します。

最適なユースケース

ユーザーがOMC自体のインストール、更新、修復を望む場合に、このセットアップフローを選択します。

• マーケットプレイス/プラグインインストールユーザーは、/plugin install oh-my-claudecode 実行後にこのフローに移行します。
• npmユーザーは、npm i -g oh-my-claude-sisyphus@latest 実行後にこのフローに移行します。
• ローカル開発およびワーキングツリーユーザーは、チェックアウトしたリポジトリを更新し、セットアップを再実行した後にこのフローに移行します。

フラグ解析

ユーザーの呼び出しに含まれるフラグを確認します。

• --help → ヘルプテキスト（下記）を表示して停止
• --local → フェーズ1のみ実行（target=local）、その後停止
• --global → フェーズ1のみ実行（target=global）、その後停止
• --force → 事前セットアップチェックをスキップし、フルセットアップを実行（フェーズ1 → 2 → 3 → 4）
• フラグなし → 事前セットアップチェックを実行し、必要に応じてフルセットアップを実行

ヘルプテキスト

ユーザーが --help を指定して実行した場合、以下を表示して停止します。

OMC Setup - Configure oh-my-claudecode

USAGE:
  /oh-my-claudecode:omc-setup           初期セットアップウィザードを実行（すでに設定済みの場合は更新）
  /oh-my-claudecode:omc-setup --local   ローカルプロジェクトを設定（.claude/CLAUDE.md）
  /oh-my-claudecode:omc-setup --global  グローバル設定を設定（~/.claude/CLAUDE.md）
  /oh-my-claudecode:omc-setup --force   すでに設定済みの場合でも強制的にフルセットアップウィザードを実行
  /oh-my-claudecode:omc-setup --help    このヘルプを表示

MODES:
  初期セットアップ（フラグなし）
    - 初回セットアップのための対話型ウィザード
    - CLAUDE.mdを設定（ローカルまたはグローバル）
    - HUDステータスラインを設定
    - 更新を確認
    - 廃止された設定値をクリア（5.0.0でdefaultExecutionModeが削除されました）し、MCP登録をClaude Codeのネイティブ設定にポイント
    - チームモードのデフォルトを設定（エージェント数、タイプ、モデル）
    - すでに設定済みの場合は、クイック更新オプションを提供

  ローカル設定（--local）
    - `scripts/setup-claude-md.sh` を通じてプラグインローカルコーディネーターを呼び出します。シェルは、ポストインストール作業の前にコーディネーターの応答と終了ステータスを検証します。
    - コーディネーターが作成したバイト単位で同一のバックアップを、変更が必要だったファイルについてのみ報告します。
    - プロジェクト固有の設定
    - OMCアップグレード後にプロジェクト設定を更新するために使用します。

  グローバル設定（--global）
    - `scripts/setup-claude-md.sh` を通じてプラグインローカルコーディネーターを呼び出します。シェルは、ポストインストール作業の前にコーディネーターの応答と終了ステータスを検証します。
    - コーディネーターが作成したバイト単位で同一のバックアップを、変更されたグローバルファイルについてのみ報告します。
    - デフォルト: `~/.claude/CLAUDE.md` を明示的に上書きし、通常の `claude` でもOMCを使用するようにします。
    - オプションの保持モードでは、ユーザーのベース `CLAUDE.md` を維持し、`omc` 起動用に `CLAUDE-omc.md` にOMCをインストールします。
    - すべてのClaude Codeセッションに適用されます。
    - 同名のレガシーフックファイルは、その正確な履歴内容が独立して検証されない限り保持されます。
    - OMCアップグレード後にグローバル設定を更新するために使用します。

  強制フルセットアップ（--force）
    - 「すでに設定済み」のチェックをバイパスします。
    - 完全なセットアップウィザードを最初から実行します。
    - 設定を再構成したい場合に使用します。

使用例:
  /oh-my-claudecode:omc-setup           初回セットアップ（設定済みの場合はCLAUDE.mdを更新）
  /oh-my-claudecode:omc-setup --local   このプロジェクトを更新
  /oh-my-claudecode:omc-setup --global  すべてのプロジェクトを更新
  /oh-my-claudecode:omc-setup --force   フルセットアップウィザードを再実行

詳細: https://github.com/Yeachan-Heo/oh-my-claudecode

セットアップの呼び出し

このスキル内でプラグインキャッシュディレクトリを個別にスキャンしたり、プラグインルートを選択したりしないでください。実行中のプラグイン環境によって提供されるプラグインルートからセットアップスクリプトを呼び出します。

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" <local|global> [overwrite|preserve]

このスクリプトが唯一のキャッシュリゾルバです。完全なプラグインルート（正規の docs/CLAUDE.md、コーディネーターアーティファクト、wiki スキル）のみを受け付け、厳密なフルSemVerキャッシュバージョンを選択し、コンパイル済みソースのハンドシェイクを検証し、コーディネータープロトコルまたはステータスの不一致があった場合には安全側に倒して失敗します。そのコーディネーターの外部で設定をダウンロードしたり、CLAUDE.md を変更したりしないでください。

事前セットアップチェック: すでに設定済みですか？

重要: 他の何かをする前に、セットアップがすでに完了しているかどうかを確認します。これにより、ユーザーがアップデートのたびに完全なセットアップウィザードを再実行する必要がなくなります。

# セットアップがすでに完了しているかどうかを確認
CONFIG_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
case "$CONFIG_DIR" in
  "~") CONFIG_DIR="$HOME" ;;
  "~/"*) CONFIG_DIR="$HOME/${CONFIG_DIR#\.~/}" ;;
  "~\\"*) CONFIG_DIR="$HOME/${CONFIG_DIR#\.~\\}" ;;
esac
CONFIG_FILE="$CONFIG_DIR/.omc-config.json"

if [ -f "$CONFIG_FILE" ]; then
  if ! command -v jq >/dev/null 2>&1; then
    echo "エラー: 既存のOMCセットアップ状態を検査するにはjqが必要です。既存の設定は変更されませんでした。"
    exit 1
  fi
  if ! SETUP_COMPLETED=$(jq -r '.setupCompleted // empty' "$CONFIG_FILE" 2>/dev/null) \
    || ! SETUP_VERSION=$(jq -r '.setupVersion // empty' "$CONFIG_FILE" 2>/dev/null); then
    echo "エラー: 既存のOMC設定が無効なJSONです。既存の設定は変更されませんでした。"
    exit 1
  fi

  if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
    echo "OMCセットアップは $SETUP_COMPLETED にすでに完了しています。"
    [ -n "$SETUP_VERSION" ] && echo "セットアップバージョン: $SETUP_VERSION"
    ALREADY_CONFIGURED="true"
  fi
fi

すでに設定済みの場合（--forceフラグなし）

ALREADY_CONFIGURED が true で、ユーザーが --force、--local、--global フラグを渡していない場合:

AskUserQuestion を使用してプロンプトを表示:

質問:「OMCはすでに設定されています。どうしますか？」

オプション:

1. CLAUDE.mdを更新し、廃止された設定値をクリアする - アクティブなプラグインの正規のCLAUDE.mdをインストールし、フェーズ2ステップ2.4を実行します。フルセットアップは再実行しません。
2. フルセットアップを再度実行する - 完全なセットアップウィザードを実行します。
3. キャンセル - 変更を行わずに終了します。

ユーザーが「CLAUDE.mdを更新し、廃止された設定値をクリアする」を選択した場合:

• ローカル（.claude/CLAUDE.md）またはグローバル（~/.claude/CLAUDE.md）の設定ファイルが存在するかを検出します。
• ローカルが存在する場合、次を実行: bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" local
• グローバルのみが存在する場合、次を実行: bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" global
• フェーズ2ステップ2.4を実行して、廃止された defaultExecutionMode キーをクリアします。
• クリーンアップ後は他のすべてのステップをスキップします。
• 成功を報告して終了します。

ユーザーが「フルセットアップを再度実行する」を選択した場合:

• 以下の再開検出に進みます。

ユーザーが「キャンセル」を選択した場合:

• 変更を行わずに終了します。

強制フラグによるオーバーライド

ユーザーが --force フラグを渡した場合、このチェックをスキップして直接セットアップに進みます。

再開検出

任意のフェーズを開始する前に、既存の状態を確認します。

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" resume

状態が存在する場合（出力が "fresh" でない場合）、AskUserQuestion を使用してプロンプトを表示:

質問:「以前のセットアップセッションが見つかりました。再開しますか、それとも最初からやり直しますか？」

オプション:

1. ステップ $LAST_STEP から再開する - 中断したところから続行します。
2. 最初からやり直す - 最初から開始します（保存された状態をクリアします）。

ユーザーが「最初からやり直す」を選択した場合:

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" clear

フェーズの実行

--local または --global フラグの場合:

${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md ファイルを読み込み、その指示に従います。 （フェーズファイルは、フラグモードでの早期終了を処理します。）

フルセットアップ（デフォルトまたは --force）の場合:

フェーズを順次実行します。各フェーズについて、対応するファイルを読み込み、その指示に従います。

1. フェーズ1 - CLAUDE.mdのインストール: ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md を読み込み、その指示に従います。

2. フェーズ2 - 環境設定: ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/02-configure.md を読み込み、その指示に従います。フェーズ2は、HUD/statusLineのセットアップを hud スキルに委任する必要があります。ここで statusLine パスをインラインで生成またはパッチしないでください。

3. フェーズ3 - 統合セットアップ: ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/03-integrations.md を読み込み、その指示に従います。

4. フェーズ4 - 完了: ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/04-welcome.md を読み込み、その指示に従います。

グレースフルな割り込み処理

重要: このセットアッププロセスは、各フェーズ後、${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh を介して進行状況を保存します。中断された場合（Ctrl+C または接続断）、セットアップは中断したところから再開できます。

最新状態の維持

oh-my-claudecodeのアップデート（npm経由またはプラグイン更新経由）をインストールした後:

自動: /oh-my-claudecode:omc-setup を実行するだけです。すでに設定済みであることを検出し、ウィザードの残りをスキップして「CLAUDE.mdを更新し、廃止された設定値をクリアする」クイックオプションを提供します。

クイック更新パスは、アップグレードによって廃止された defaultExecutionMode 値が削除されるように、フェーズ2ステップ2.4を必ず実行する必要があります。代替の実行モード設定を書き込んではいけません。

手動オプション:

• /oh-my-claudecode:omc-setup --local プロジェクト設定のみを更新
• /oh-my-claudecode:omc-setup --global グローバル設定のみを更新
• /oh-my-claudecode:omc-setup --force フルウィザードを再実行（設定を再構成）

これにより、フルセットアップを繰り返すトークンコストをかけずに、最新の機能とエージェント設定を確実に利用できます。