opencode-config

OpenCode 設定スキル

JSON または Markdown 形式の OpenCode 設定ファイルを理解し、グローバル設定とプロジェクト設定の優先順位を適切に管理します。このスキルでは、設定の詳細は時間とともに変化するため、調査に基づく検証を重視します。

どのようなときに使うか

• カスタム設定を使用して、新しいプロジェクト向けに OpenCode をセットアップするとき
• チーム全体で使用する設定標準を作成するとき
• 特定の設定が適用されない理由（優先順位の問題）を理解するとき
• 非推奨の設定パターンから現在のベストプラクティスに移行するとき
• 公式ドキュメントを照合して設定の詳細を確認するとき

できること

• OpenCode の設定形式（JSON/JSONC と YAML フロントマター付き Markdown）を説明します
• グローバル、プロジェクト、環境変数ベースの設定間の優先順位を明確にします
• 一般的な設定シナリオ（モデル、権限、ツール、モード）の例を提示します
• 付属のスクリプトを使用して設定ファイルを検証し、よくある問題を確認します
• 変更に対応できるよう、検索ツールを使った調査に基づく検証を重視します
• 適切なスキーマ参照と変数置換を含む設定ファイルを生成します
• 既存の設定ファイルを確認する検証スクリプト（scripts/validate-config.sh）を提供します

例

# Create a project-specific opencode.json with custom model
cat > opencode.json << EOF
{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-haiku-4-5",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}
EOF

# Create a global mode using Markdown
mkdir -p ~/.config/opencode/modes/
cat > ~/.config/opencode/modes/review.md << 'EOF'
---
temperature: 0.1
tools:
  write: false
  edit: false
  bash: false
---

You are in code review mode. Focus on code quality, potential bugs, and security considerations without making direct changes.
EOF

出力形式

設定を分析する場合：

config_source: ~/.config/opencode/opencode.json
config_type: global
format: json
precedence: 2/6
effective_settings:
  model: anthropic/claude-sonnet-4-5
  autoupdate: true

設定を作成する場合：

{
  "status": "created",
  "file": ".opencode/modes/debug.md",
  "format": "markdown",
  "precedence": "project"
}

注意事項

• 重要：OpenCode の設定は頻繁に変更されます。具体的な実装方法を案内する前に、必ず検索ツール（searxng_searxng_web_search、searxng_web_url_read）を使用して詳細を確認してください。
• 設定の優先順位（後の設定が前の設定を上書きします）：
  1. リモート設定（.well-known/opencode）
  2. グローバル設定（~/.config/opencode/opencode.json）
  3. カスタム設定（OPENCODE_CONFIG 環境変数）
  4. プロジェクト設定（プロジェクト内の opencode.json）
  5. .opencode ディレクトリ（エージェント、コマンド、プラグイン）
  6. インライン設定（OPENCODE_CONFIG_CONTENT 環境変数）
• opencode.json では JSON と JSONC 形式がサポートされています。モード、エージェント、コマンドなどでは、YAML フロントマター付き Markdown がサポートされています。
• $schema フィールドを使うと、エディターで検証や自動補完を利用できます。
• 設定ファイルで変数を置換するには、{env:VAR} と {file:path} を使用します。
• モードの設定には、現在 agent オプションを使用します（mode オプションは非推奨です）。