SuperAPI AI 工具集

opencode-config

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:该技能用于编辑 OpenCode 的配置文件与规则文件,适用于提供方设置、权限变更、模型配置、格式化规则和环境相关调整。

文件位置:全局配置为 ~/.config/opencode/opencode.json,项目配置为 ./opencode.json;全局规则为 ~/.config/opencode/AGENTS.md,项目规则为 ./AGENTS.md。优先级为项目高于全局,配置为合并而非替换。

主要能力:在 opencode.json 中设置 model、small_model、theme、autoupdate、share 等选项;通过 permission 字段控制 edit、bash、webfetch、skill 等操作的 allow/ask/deny,bash 支持模式匹配;通过 instructions 引入额外说明文件。AGENTS.md 用于编写项目级指令,可用 /init 自动生成。

使用方式:先明确用户要配置配置项还是规则;编辑后必须自行运行 opencode run "test" 校验,而非仅建议用户执行。OpenCode 支持 JSONC,可注释而非删除未用配置。

限制与注意:遇到旧字段(如 tools、maxSteps)应改为 permission 与 steps;常见错误包括缺少逗号、尾随逗号、括号未闭合;配置未加载需检查 JSON 语法与路径,权限异常需检查全局与项目优先级。完整 schema 见 references/config-schema.md。