a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
12 KiB
ランタイムへの MSD Core インストール方法
MSD Core（@golem15/msd-core）を普段使いの AI コーディングランタイムにインストールします。このガイドでは、サポートされている各ランタイム向けの標準インストール手順と、Node.js がない環境向けの手動手順を説明します。
必要なもの: Node.js 18 以上と npm（または npx）。Node.js がない場合は Node.js なしでのインストール へ進んでください。
インストーラーが必要な理由
MSD Core は Claude Code のネイティブ frontmatter 形式でエージェントファイルとコマンドファイルを提供しています。サポートされている各ランタイムは、異なるスキーマ、ディレクトリ構成、コマンド呼び出し構文を要求します。インストーラーは必要な変換を実行します。たとえば OpenCode 向けのツールリストとカラー値の変換、Codex 向けの TOML エージェントエントリの書き込みなどです。
agents/ や commands/ からファイルを直接コピーしないでください。 そうするとこれらの変換がスキップされ、スキーマ検証エラーやコマンドの欠落が発生します。
標準インストール
任意のディレクトリからインストーラーを実行します。ランタイムの選択と、グローバル（全プロジェクト）またはローカル（このプロジェクトのみ）のどちらでインストールするかを確認するプロンプトが表示されます。
npx @golem15/msd-core@latest
新規インストールやランタイムの切り替え後にインストーラーを再実行する場合も、このコマンド 1 つだけで完結します。
ランタイム別のインストール手順
Claude Code
npx @golem15/msd-core@latest --claude --global
スキルは ~/.claude/ に配置されます。次回の Claude Code セッションからコマンドが /msd-* スラッシュコマンドとして表示されます。反映するには Claude Code を再起動してください。
--global と --local の両方のスコープへのインストール。 これはサポートされている構成です（プロジェクトによって異なるカスタマイズが必要になることがあるため）が、Claude Code 自身のトリガー解決ルール——個人スコープがプロジェクトスコープより優先され、スキルは同名のコマンドより優先される——はどちらも同じ方向を指します。つまり、グローバルスキルは常にローカルコマンドより /msd-<name> トリガーで勝ちます。MSD Core はこれを検出し、インストール完了直後にどちらのスコープが勝っているかを表示します（同じ事実は /msd-health の診断コード W028 としても表示されます）。これは警告であり失敗ではありません——インストール自体は成功します。グローバルスコープでは、勝者となったスキルのワークフロー仕様への参照は実行時にまず作業ディレクトリを基準に解決されるため、Claude Code が実際に呼び出すのはグローバルスキルであっても、独自の .claude/msd-core/ を持つプロジェクトは自分自身の仕様を取得できます。
インストールディレクトリの上書き:
CLAUDE_CONFIG_DIR=~/.claude-alt npx @golem15/msd-core@latest --claude --global
OpenCode
npx @golem15/msd-core@latest --opencode --global
スキルは ~/.config/opencode/（XDG）または ~/.opencode/ に配置されます。インストーラーはエージェントの frontmatter を OpenCode のスキーマに変換します（tools: フィールドの削除、カラー値の hex 変換）。変更内容の詳細は Node.js なしでのインストール — OpenCode の変換内容 を参照してください。
インストールディレクトリの上書き:
OPENCODE_CONFIG_DIR=~/.config/opencode-alt npx @golem15/msd-core@latest --opencode --global
Kilo
npx @golem15/msd-core@latest --kilo --global
スキルは ~/.config/kilo/（XDG）または ~/.kilo/ に配置されます。OpenCode と同じフラットな Markdown コマンド形式を使用します。
インストールディレクトリの上書き:
KILO_CONFIG_DIR=~/.config/kilo-alt npx @golem15/msd-core@latest --kilo --global
Codex
npx @golem15/msd-core@latest --codex --global
スキルは ~/.codex/skills/msd-*/SKILL.md に配置されます。エージェントは config.toml にエージェントごとの TOML エントリとして書き込まれます。インストール後は Codex を再起動（または codex --reload を実行）してください。
最低サポートバージョン: Codex CLI 0.130.0。それより古いバージョンにはスキルルートの追加スキャン処理があり、重複リストが生じることがあります。
GitHub Copilot
npx @golem15/msd-core@latest --copilot --global
スキルは ~/.copilot/ に配置されます。MSD はエージェント .md ファイルとリポジトリ instruction ファイルとしてインストールされます。
インストールディレクトリの上書き:
COPILOT_CONFIG_DIR=~/.copilot-alt npx @golem15/msd-core@latest --copilot --global
Cursor
npx @golem15/msd-core@latest --cursor --global
スキルは ~/.cursor/ に配置されます。MSD はスキル、エージェント、ルールの参照をインストールします。
インストールディレクトリの上書き:
CURSOR_CONFIG_DIR=~/.cursor-alt npx @golem15/msd-core@latest --cursor --global
Windsurf
npx @golem15/msd-core@latest --windsurf --global
スキルは ~/.codeium/windsurf/ に配置されます。MSD はスキル、エージェント、ワークスペースルールをインストールします。
インストールディレクトリの上書き:
WINDSURF_CONFIG_DIR=~/.codeium/windsurf-alt npx @golem15/msd-core@latest --windsurf --global
Cline
Cline はルールベースの統合方式を使用します。MSD はスラッシュコマンドではなく .clinerules としてインストールされます。
# グローバルインストール（全プロジェクト）
npx @golem15/msd-core@latest --cline --global
# ローカルインストール（このプロジェクトのみ）
npx @golem15/msd-core@latest --cline --local
グローバルインストールは ~/.cline/ に書き込みます。ローカルインストールは ./.cline/ に書き込みます。ルールは Cline によって自動的に読み込まれます。カスタムのスラッシュコマンドは登録されません。
CodeBuddy
npx @golem15/msd-core@latest --codebuddy --global
スキルは ~/.codebuddy/skills/msd-*/SKILL.md に配置されます。
Qwen Code
Qwen Code は Claude Code 2.1.88 以降と同じオープンスキル標準を使用します。
npx @golem15/msd-core@latest --qwen --global
スキルは ~/.qwen/skills/msd-*/SKILL.md に配置されます。
インストールディレクトリの上書き:
QWEN_CONFIG_DIR=~/.qwen-alt npx @golem15/msd-core@latest --qwen --global
Augment Code
npx @golem15/msd-core@latest --augment --global
スキルは ~/.augment/ に配置されます。MSD はスキルとエージェントをインストールします。フックや statusline の管理は行いません。
Antigravity
npx @golem15/msd-core@latest --antigravity --global
インストーラーは Antigravity の設定ディレクトリ（~/.gemini/antigravity、~/.gemini/antigravity-ide、または ~/.gemini/antigravity-cli）を自動検出します。Gemini 互換の設定ポリシーを使用します。
インストールディレクトリの上書き:
ANTIGRAVITY_CONFIG_DIR=~/.gemini/antigravity-alt npx @golem15/msd-core@latest --antigravity --global
Trae
npx @golem15/msd-core@latest --trae --global
スキルは ~/.trae/ に配置されます。MSD はスキル、エージェント、ルールの参照をインストールします。
ローカルインストールとグローバルインストール
上記の例はすべて --global を使用しており、ユーザーアカウント全体に MSD を一度インストールします。インストールを単一プロジェクトに限定するには、--global を --local に置き換えます。
npx @golem15/msd-core@latest --claude --local
ローカルインストールはプロジェクトルートの .claude/ ディレクトリに書き込みます。両方が存在する場合、ローカルインストールの設定がグローバルの設定より優先されます。
プレリリースエディション（Next / Nightly / Insiders / Preview）のインストール
ランタイムのプレリリースエディション（Windsurf Next、Cursor Nightly、VS Code Insiders、Codex preview チャンネルなど）は、隣接する設定ディレクトリから読み込みます。インストーラーを実行する前に対応する *_CONFIG_DIR 環境変数を設定してください。
WINDSURF_CONFIG_DIR=~/.codeium/windsurf-next npx @golem15/msd-core@latest --windsurf --global
インストーラーのプロンプトでは対応する安定版ランタイムを選択してください。MSD はプレリリースエディションを独立した名前付きランタイムとしては列挙していません。これらは環境変数によるベストエフォートの対応であり、リリース CI では個別にテストされていません。
Node.js なしでのインストール
npx が実行できない場合（例：Node.js がない Windows マシン）、2 つの選択肢があります。
選択肢 A — Node.js がある別のマシンを使用する。 WSL、Linux VM、CI ランナー、Docker コンテナなど、Node.js があるマシンであれば何でも使えます。そのマシンでインストーラーを実行し、出力ディレクトリをターゲットマシンにコピーします。OpenCode の場合:
npx @golem15/msd-core@latest --opencode --global
# その後 ~/.config/opencode/agents/ を Windows マシンにコピー
選択肢 B — ソースファイルを手動で変換する。 エージェントのソースファイルは MSD Core リポジトリの agents/ に存在し、Claude Code のネイティブ frontmatter 形式になっています。各ランタイムは異なる形式を要求します。ランタイムごとの正確なフィールド変換については、ユーザーガイドの Manual install / no-Node.js setup を参照してください。OpenCode の変換内容が詳しく説明されており、他のランタイム向けのインストーラーの convert*Frontmatter 関数も案内されています。
インストール後の作業
新しいコマンドとエージェントを反映するためにランタイムを再起動してください。その後、新規プロジェクトを開始するか既存リポジトリをオンボーディングします。
/msd-new-project # グリーンフィールドプロジェクト
/msd-onboard # 既存コードベース
再起動後もコマンドが見つからない場合は、インストールディレクトリがランタイムの期待する設定パスと一致しているか確認してください。最もよくある不一致については上記のプレリリースエディションのセクションを参照してください。