opencode-primitives

目的

OpenWork の動作を OpenCode のプリミティブ（スキル、プラグイン、MCP サーバー、opencode.json の設定、ツール／権限）の上に直接実装する場合は、常にこのスキルを使用してください。公式の OpenCode ドキュメントに基づいて判断し、UI で用語を一貫させます。

ドキュメントの参照元（該当する場合は常に引用）

• スキル：https://opencode.ai/docs/skills
• プラグイン：https://opencode.ai/docs/plugins/
• MCP サーバー：https://opencode.ai/docs/mcp-servers/
• 設定（opencode.json、配置場所、優先順位）：https://opencode.ai/docs/config/

適用する重要事項

スキル

• スキルファイルは .opencode/skills/<name>/SKILL.md またはグローバルの ~/.config/opencode/skills/<name>/SKILL.md に配置します。
• スキルは git の作業ツリーまで親ディレクトリをたどり、.opencode/ または .claude/skills/ 内にある skills/*/SKILL.md のうち、条件に一致するものを読み込んで検出します。
• SKILL.md には、name と description を含む YAML フロントマターが必要です。
• 名前のルール：小文字の英数字と単一のハイフンを使用します（^[a-z0-9]+(-[a-z0-9]+)*$）。長さは 1～64 文字で、ディレクトリ名と一致している必要があります。
• 説明の長さは 1～1024 文字です。
• アクセスは opencode.json の権限（permission.skill の allow／deny／ask）によって制御されます。

プラグイン

• ローカルプラグインはプロジェクトの .opencode/plugins/ またはグローバルの ~/.config/opencode/plugins/ に配置します。
• npm プラグインは opencode.json の plugin に記載し、起動時に Bun でインストールします。
• 読み込み順：グローバル設定、プロジェクト設定、グローバルのプラグインディレクトリ、プロジェクトのプラグインディレクトリ。

MCP サーバー

• MCP サーバーは opencode.json の mcp に一意の名前で定義します。
• ローカルサーバーには type: "local" と command 配列を使用し、リモートサーバーには type: "remote" と url を使用します。
• サーバーは enabled で有効／無効にできます。
• MCP ツールは、glob パターンを含め、設定内の tools で管理します。
• リモートサーバーの OAuth は自動的に処理されます。事前登録することも、無効にすることもできます。

設定（opencode.json）

• JSON と JSONC に対応しています。
• 優先順位：リモートの .well-known/opencode -> グローバルの ~/.config/opencode/opencode.json -> カスタムパス -> プロジェクトの opencode.json -> .opencode/ ディレクトリ -> インラインの環境変数による上書き。
• .opencode のサブディレクトリ名は、デフォルトでは複数形（agents/、commands/、plugins/、skills/、tools/、themes/）です。互換性のため、単数形の名前も使用できます。

呼び出すタイミング

• スキル、プラグイン、MCP サーバー、または OpenCode の設定を参照する OpenWork のワークフローを追加または調整する場合。
• スキル／プラグインのインストール、設定の配置場所、または権限の確認を案内するオンボーディングを設計する場合。
• OpenCode のプリミティブを表示する UI（スキルタブ、プラグインマネージャー、MCP の切り替え）を実装する場合。

使用方法

OpenCode のプリミティブに対応する OpenWork の動作を実装または文書化する前に、skill({ name: "opencode-primitives" }) を呼び出してください。