opencode-config

OpenCode 配置技能

了解并管理 JSON 或 Markdown 格式的 OpenCode 配置文件，并正确处理全局设置与项目设置之间的优先级。本技能强调基于研究的验证，因为配置详情会随时间变化。

适用场景

• 为新项目设置 OpenCode 的自定义设置
• 制定团队级配置标准
• 了解某些设置未生效的原因（优先级问题）
• 从已弃用的配置模式迁移到当前最佳实践
• 根据官方文档验证配置详情

功能

• 说明 OpenCode 配置格式（JSON/JSONC 与带 YAML frontmatter 的 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 目录（agents、commands、plugins）
  6. 内联配置（OPENCODE_CONFIG_CONTENT 环境变量）
• opencode.json 支持 JSON 和 JSONC 格式；模式、Agent、命令等支持带 YAML frontmatter 的 Markdown。
• $schema 字段可在编辑器中提供验证和自动补全。
• 在配置文件中使用 {env:VAR} 和 {file:path} 进行变量替换。
• 现在通过 agent 选项配置模式（已弃用 mode 选项）。