v3.0 新機能：Categories と Skills システム完全解説

バージョン概要

oh-my-opencode v3.0 は重要なマイルストーンリリースであり、全く新しい Categories と Skills システム を導入し、AI エージェントのオーケストレーション方法を根本から変えました。このバージョンは、AI エージェントをより専門化、柔軟化、構成可能にすることを目指しています。

主な改善点：

🎯 Categories システム：7 つの組み込みタスク分類、最適なモデルの自動選択
🛠️ Skills システム：3 つの組み込みプロフェッショナルスキルパッケージ、ドメイン知識の注入
🔄 動的構成：delegate_task を通じて Category と Skill を自由に組み合わせ
🚀 Sisyphus-Junior：新しい委任タスク実行エージェント、無限ループの防止
📝 柔軟な設定：カスタム Categories と Skills のサポート

コア新機能 1：Categories システム

Category とは？

Category は特定のドメイン向けに最適化されたエージェント設定プリセットです。重要な質問に答えます：「これはどのような種類の作業か？」

各 Category は以下を定義します：

使用するモデル（model）
温度パラメータ（temperature）
プロンプトマインドセット（prompt mindset）
推論能力（reasoning effort）
ツール権限（tools）

7 つの組み込み Categories

Category	デフォルトモデル	Temperature	適用シナリオ
`visual-engineering`	`google/gemini-3-pro`	0.7	フロントエンド、UI/UX、デザイン、スタイル、アニメーション
`ultrabrain`	`openai/gpt-5.2-codex` (xhigh)	0.1	深い論理推論、大量の分析を必要とする複雑なアーキテクチャ決定
`artistry`	`google/gemini-3-pro` (max)	0.7	高い創造性/芸術的タスク、新しいアイデア
`quick`	`anthropic/claude-haiku-4-5`	0.1	簡単なタスク - 単一ファイルの修正、タイプミス修正、簡単な変更
`unspecified-low`	`anthropic/claude-sonnet-4-5`	0.1	他のカテゴリに適合しないタスク、低いワークロード
`unspecified-high`	`anthropic/claude-opus-4-5` (max)	0.1	他のカテゴリに適合しないタスク、高いワークロード
`writing`	`google/gemini-3-flash`	0.1	ドキュメント、エッセイ、技術執筆

出典：docs/category-skill-guide.md:22-30

Categories の使い方？

delegate_task ツールを呼び出すとき、category パラメータを指定します：

typescript

// フロントエンドタスクを visual-engineering category に委任
delegate_task(
  category="visual-engineering",
  prompt="ダッシュボードページにレスポンシブチャートコンポーネントを追加"
)

システムは自動的に：

visual-engineering Category を選択
google/gemini-3-pro モデルを使用
temperature: 0.7（高い創造性）を適用
その Category のプロンプトマインドセットをロード

Sisyphus-Junior：委任タスク実行エージェント

Category を使用すると、Sisyphus-Junior という特殊なエージェントがタスクを実行します。

主な機能：

❌ 他のエージェントにタスクを再委任できない
🎯 割り当てられたタスクに集中
🔄 無限委任ループの防止

設計目的：エージェントが現在のタスクに集中し、タスクの階層的委任による複雑さを回避します。

コア新機能 2：Skills システム

Skill とは？

Skill は専門知識（Context）とツール（MCP）をエージェントに注入する仕組みです。別の重要な質問に答えます：「どのようなツールと知識が必要か？」

3 つの組み込み Skills

1. `git-master`

能力：

Git 専門家
コミットスタイルの検出
原子的コミットの分割
rebase 戦略の策定

MCP：なし（Git コマンドを使用）

適用シナリオ：コミット、履歴検索、ブランチ管理

2. `playwright`

能力：

ブラウザ自動化
ウェブテスト
スクリーンショット
データスクレイピング

MCP：@playwright/mcp（自動実行）

適用シナリオ：実装後の UI 検証、E2E テスト作成

3. `frontend-ui-ux`

能力：

デザイナーマインドセットの注入
色、タイポグラフィ、モーションガイドライン

適用シナリオ：単純な実装を超えた美しい UI 作業

出典：docs/category-skill-guide.md:57-70

Skills の使い方？

delegate_task に load_skills 配列を追加します：

typescript

// クイックタスクを委任し、git-master スキルをロード
delegate_task(
  category="quick",
  load_skills=["git-master"],
  prompt="現在の変更をコミットしてください。コミットメッセージスタイルに従ってください。"
)

システムは自動的に：

quick Category を選択（Claude Haiku、低コスト）
git-master Skill をロード（Git 専門知識を注入）
Sisyphus-Junior を起動してタスクを実行

カスタム Skills

プロジェクトルートの .opencode/skills/ またはユーザーディレクトリの ~/.claude/skills/ にカスタム Skills を直接追加できます。

例：.opencode/skills/my-skill/SKILL.md

markdown

---
name: my-skill
description: 私のプロフェッショナルカスタムスキル
mcp:
  my-mcp:
    command: npx
    args: ["-y", "my-mcp-server"]
---

# 私のスキルプロンプト

この内容はエージェントのシステムプロンプトに注入されます。
...

出典：docs/category-skill-guide.md:87-103

コア新機能 3：動的構成能力

構成戦略：専門化エージェントの作成

異なる Categories と Skills を組み合わせることで、強力な専門化エージェントを作成できます。

🎨 デザイナー（UI 実装）

Category: visual-engineering
load_skills: ["frontend-ui-ux", "playwright"]
効果：美しい UI を実装し、ブラウザで直接レンダリング結果を検証

🏗️ アーキテクト（デザインレビュー）

Category: ultrabrain
load_skills: []（純粋推論）
効果：GPT-5.2 の論理推論能力を活用して、深いシステムアーキテクチャ分析を実行

⚡ メンテナー（クイックフィックス）

Category: quick
load_skills: ["git-master"]
効果：コスト効率の良いモデルを使用してコードを迅速に修正し、クリーンなコミットを生成

出典：docs/category-skill-guide.md:111-124

delegate_task プロンプトガイド

タスクを委任するとき、明確で具体的なプロンプトが重要です。以下の 7 つの要素を含めます：

TASK：何をする必要があるか？（単一の目標）
EXPECTED OUTCOME：成果物は何か？
REQUIRED SKILLS：load_skills を通じてどのスキルをロードすべきか？
REQUIRED TOOLS：どのツールを使用しなければならないか？（ホワイトリスト）
MUST DO：何をしなければならないか（制約）
MUST NOT DO：何を絶対にしてはならないか
CONTEXT：ファイルパス、既存のパターン、参考資料

❌ 悪い例：

"これを修正"

✅ 良い例：

TASK：LoginButton.tsx のモバイルレイアウト破損問題を修正 CONTEXT：src/components/LoginButton.tsx、Tailwind CSS を使用 MUST DO：md: ブレークポイントで flex-direction を変更 MUST NOT DO：既存のデスクトップレイアウトを変更 EXPECTED：ボタンがモバイルで垂直に整列

出典：docs/category-skill-guide.md:130-148

設定ガイド

Category 設定スキーマ

oh-my-opencode.json で Categories を微調整できます。

フィールド	型	説明
`description`	string	Category 目的の可読説明。delegate_task プロンプトに表示されます。
`model`	string	使用する AI モデル ID（例：`anthropic/claude-opus-4-5`）
`variant`	string	モデルバリアント（例：`max`、`xhigh`）
`temperature`	number	創造性レベル（0.0 ~ 2.0）。低いほど決定論的。
`top_p`	number	核サンプリングパラメータ（0.0 ~ 1.0）
`prompt_append`	string	この Category が選択されたときにシステムプロンプトに追加される内容
`thinking`	object	Thinking モデル設定（`{ type: "enabled", budgetTokens: 16000 }`）
`reasoningEffort`	string	推論努力レベル（`low`、`medium`、`high`）
`textVerbosity`	string	テキスト詳細度（`low`、`medium`、`high`）
`tools`	object	ツール使用制御（`{ "tool_name": false }` で無効化）
`maxTokens`	number	最大応答トークン数
`is_unstable_agent`	boolean	エージェントを不安定としてマーク - 監視のためにバックグラウンドモードを強制

出典：docs/category-skill-guide.md:159-172

設定例

jsonc

{
  "categories": {
    // 1. 新しいカスタム category を定義
    "korean-writer": {
      "model": "google/gemini-3-flash",
      "temperature": 0.5,
      "prompt_append": "You are a Korean technical writer. Maintain a friendly and clear tone."
    },

    // 2. 既存の category を上書き（モデルを変更）
    "visual-engineering": {
      "model": "openai/gpt-5.2",
      "temperature": 0.8
    },

    // 3. thinking モデルを設定し、ツールを制限
    "deep-reasoning": {
      "model": "anthropic/claude-opus-4-5",
      "thinking": {
        "type": "enabled",
        "budgetTokens": 32000
      },
      "tools": {
        "websearch_web_search_exa": false // ウェブ検索を無効化
      }
    }
  },

  // skills を無効化
  "disabled_skills": ["playwright"]
}

出典：docs/category-skill-guide.md:175-206

その他の重要な改善

Categories と Skills システムに加えて、v3.0 には以下の重要な改善が含まれています：

安定性の向上

✅ バージョンを安定としてマーク（3.0.1）
✅ エージェント委任メカニズムを最適化
✅ エラー回復能力を改善

パフォーマンスの最適化

✅ 不要なコンテキスト注入を削減
✅ バックグラウンドタスクポーリングメカニズムを最適化
✅ マルチモデルオーケストレーション効率を向上

Claude Code 互換性

✅ Claude Code 設定形式に完全互換
✅ Claude Code の Skills、Commands、MCPs のロードをサポート
✅ 自動検出と設定

出典：README.md:18-20, README.md:292-304

次のステップ

v3.0 の Categories と Skills システムは、oh-my-opencode の柔軟な拡張の基盤を築きました。これらの新機能を深く理解したい場合は、以下のセクションを参照してください：

Categories と Skills：動的エージェント構成 - 詳細な使用ガイド
組み込み Skills：ブラウザ自動化と Git 専門家 - Skills 深度解説
設定深いカスタマイズ：エージェントと権限管理 - カスタム設定ガイド

これらの新機能を探索し始め、AI エージェントをより専門化し、効率化しましょう！

5 分で始める

AI アカウントを接続

設定移行マスター

変更履歴

v3.0 新機能：Categories と Skills システム完全解説

バージョン概要

コア新機能 1：Categories システム

Category とは？

7 つの組み込み Categories

Categories の使い方？

Sisyphus-Junior：委任タスク実行エージェント

コア新機能 2：Skills システム

Skill とは？

3 つの組み込み Skills

1. `git-master`

2. `playwright`

3. `frontend-ui-ux`

Skills の使い方？

カスタム Skills

コア新機能 3：動的構成能力

構成戦略：専門化エージェントの作成

🎨 デザイナー（UI 実装）

🏗️ アーキテクト（デザインレビュー）

⚡ メンテナー（クイックフィックス）

delegate_task プロンプトガイド

設定ガイド

Category 設定スキーマ

設定例

その他の重要な改善

安定性の向上

パフォーマンスの最適化

Claude Code 互換性

次のステップ

v3.0 新機能：Categories と Skills システム完全解説 ​

バージョン概要 ​

コア新機能 1：Categories システム ​

Category とは？ ​

7 つの組み込み Categories ​

Categories の使い方？ ​

Sisyphus-Junior：委任タスク実行エージェント ​

コア新機能 2：Skills システム ​

Skill とは？ ​

3 つの組み込み Skills ​

1. git-master ​

2. playwright ​

3. frontend-ui-ux ​

Skills の使い方？ ​

カスタム Skills ​

コア新機能 3：動的構成能力 ​

構成戦略：専門化エージェントの作成 ​

🎨 デザイナー（UI 実装） ​

🏗️ アーキテクト（デザインレビュー） ​

⚡ メンテナー（クイックフィックス） ​

delegate_task プロンプトガイド ​

設定ガイド ​

Category 設定スキーマ ​

設定例 ​

その他の重要な改善 ​

安定性の向上 ​

パフォーマンスの最適化 ​

Claude Code 互換性 ​

次のステップ ​

v3.0 新機能：Categories と Skills システム完全解説

バージョン概要

コア新機能 1：Categories システム

Category とは？

7 つの組み込み Categories

Categories の使い方？

Sisyphus-Junior：委任タスク実行エージェント

コア新機能 2：Skills システム

Skill とは？

3 つの組み込み Skills

1. `git-master`

2. `playwright`

3. `frontend-ui-ux`

Skills の使い方？

カスタム Skills

コア新機能 3：動的構成能力

構成戦略：専門化エージェントの作成

🎨 デザイナー（UI 実装）

🏗️ アーキテクト（デザインレビュー）

⚡ メンテナー（クイックフィックス）

delegate_task プロンプトガイド

設定ガイド

Category 設定スキーマ

設定例

その他の重要な改善

安定性の向上

パフォーマンスの最適化

Claude Code 互換性

次のステップ