本文围绕"Opencode是什么、配置怎么写、权限怎么管、Agent / Skill / MCP / Command 怎么用"展开,示例均可直接对照官方文档与项目配置理解。
一、OpenCode 是什么
图 1 OpenCode 总体结构:Harness 负责上下文、工具调用与权限检查
OpenCode 是一款开源的 AI 编程智能体(Coding Agent),提供终端界面(TUI / CLI)、桌面 App 和网页版三种使用形式。
在一次会话中,OpenCode 作为 harness(运行骨架)负责三件事:维护会话上下文、发起工具调用、做权限检查;同时它支持接入多家大模型服务商(Provider),既内置了一批 Agent,也支持通过新增 Agent、Skill、MCP 等方式扩展能力。
可以把它理解成一个"可配置、可扩展"的 AI 编程助手外壳:模型负责生成内容,外壳负责记忆上下文、调用工具和守住权限边界。
二、配置体系
OpenCode 的配置主要分两类:一类是结构化的 opencode.json(c),用来约束运行环境;另一类是 AGENTS.md 这类 Markdown 规则文件,用来给模型注入项目上下文。
2.1 opencode.json(c):约束工作环境
配置文件内容为 JSON 格式;jsonc = JSON + 注释。它决定以下几类事情:
- 默认使用哪个模型、哪个主 Agent;各工具的权限规则(read / edit / shell / skill 等);自定义斜杠命令、Agent、Skill 来源、MCP 服务器、Provider 定义;编辑器、格式化、输出截断、搜索、快照、工作目录等运行行为。
其中一部分会间接影响模型行为,比如 Agent 的 system 指令、命令模板、权限允许或拒绝了哪些工具;另一部分是纯运行设置(更新策略、图片尺寸、shell 路径等),模型本身感知不到。
常用配置字段
| 字段 | 作用 |
|---|---|
| $schema | 给编辑器(VS Code 等)的配置说明书,提供字段自动补全、校验与报错提示 |
| model | 默认模型,格式为 provider/model |
| provider | 配置模型提供商,添加其模型、请求设置及模型变体等 |
| permission | 文件访问与工具调用的权限规则,方式有 allow / deny / ask |
| skill | 增加 Skill 搜索目录(Skill 本身有固定检索目录) |
| agent | 增加或覆盖带有自身大模型、模式和权限的 Agent |
| default_agent | 默认的 primary Agent |
| mcp | 配置本地或远程的 MCP 服务器 |
| commands | 用斜杠命令定义 prompt 模板 |
| instruction | 定义额外加载的指令文件,与 AGENTS.md 一起加载 |
变量引用:环境变量与文件内容
配置文件中可以用变量引用来引用环境变量和文件内容:
环境变量:{env:VARIABLE_NAME} 替换为环境变量值;若环境变量未设置,则用空字符串替代。
文件:{file:path/to/file} 替换为文件内容;路径可以是相对路径(相对于配置文件目录)、绝对路径或以 ~
- 开头的主目录路径;若文件不存在,同样用空字符串替代。
文件替换主要用于两个场景:把 API 密钥等敏感数据保存在单独文件中;跨多个配置文件共享公共配置片段。
配置文件位置与优先级
图 2 配置文件优先级从低到高,高层覆盖低层同名字段
配置优先级从低到高合并:最远目录的配置 → 最近目录的配置 → 全局配置 → 系统配置。高层覆盖低层的同名字段,不冲突的字段予以保留。
| 层级 | 位置 | 影响范围 |
|---|---|---|
| 系统级(机器,最高) | /etc/opencode/(Linux) | 这台机器上的所有用户 |
| 全局级(用户级) | ~/.config/opencode/opencode.json(c) | 用户个人偏好,当前用户的所有项目 |
| 项目级 | <repo>/opencode.json(c)、<repo>/.opencode/opencode.json(c) | 仅当前项目团队共享,可提交 git |
| 项目内子目录嵌套 | 从启动目录逐级寻找到 git root | 仅当前项目团队共享 |
例如,OpenCode 会按以下顺序从低到高合并:~/.config/opencode/opencode.json → /projects/acme/opencode.json → /projects/acme/packages/web/opencode.json(当前工作区)→ /projects/acme/.opencode/opencode.json → /etc/opencode/opencode.json。
2.2 AGENTS.md 与 Instructions
AGENTS.md 的内容以 Markdown 编写,定义项目规范、流程等规则。OpenCode 会把 AGENTS.md 注入大模型上下文,告诉模型这个项目的规则,因此项目级通常会保留一份。需要特别注意:AGENTS.md 不是 Skill,每次 OpenCode 启动都会自动加载它。
和 opencode.json(c) 类似,AGENTS.md 也可能存在多份,但多份内容不会互相覆盖,而是全部加载、合并进模型上下文。OpenCode 只做简单合并,不处理相互冲突。
| 层级 | 位置 | 影响范围 |
|---|---|---|
| 全局 | ~/.config/opencode/AGENTS.md | 个人、跨项目通用的习惯与约定 |
| 项目级 | <repo>/AGENTS.md | 仅当前项目团队共享,可提交 git,如仓库构建命令、架构说明、代码规范 |
| 项目内子目录嵌套 | 从启动目录逐级寻找到 git root | 只适用于该模块的局部规则 |
在 opencode.json(c) 中还可以用 instruction 增加其他 md 文件作为模型输入上下文。这些文件在 AGENTS.md 之后加载,按照列出的顺序把每个 md 的内容组合起来。Instruction 支持四种路径写法:
| 写法 | 示例 | 解析规则 |
|---|---|---|
| 相对路径 / glob | CONTRIBUTING.md、docs/guidelines/*.md | 从当前工作目录向上到项目根的每一层依次搜索;匹配到的本地文件在配置加载时纳入 |
| ~/ home 目录 | ~/rules/opencode.md | 展开为当前用户 home 目录下的绝对路径 |
| 绝对路径 | /opt/company/rules/style.md | 原样使用;文件名一段也可以是 glob |
| HTTP(S) URL | https://example.com/instructions.md | 配置加载时联网抓取,超时 5 秒 |
三、权限管理
permission 控制 Agent 是否可以对资源执行操作。
3.1 三种裁决
allow:直接放行,不打扰用户;
ask:弹窗询问,可选择 once / always / reject;
deny:直接拒绝。
3.2 权限项一览
read、glob、grep 三者都能间接探测项目结构,安全场景下必须一起收紧:
| 权限项 | 控制什么 |
|---|---|
| read | 读文件(匹配文件路径) |
| edit | 所有文件修改(edit / write / patch) |
| glob | 按模式搜文件(匹配 glob 模式) |
| grep | 按内容搜(匹配正则) |
| bash / shell | 执行 shell 命令(按解析后的命令匹配) |
| external_directory | 访问工作目录外路径(默认 ask) |
| … | … |
3.3 配置语法
简单模式(统一裁决):
{
"permission": {
"*": "ask",
"bash": "allow",
"edit": "deny"
}
}
对象语法(按模式细分):
{
"permission": {
"bash": {
"*": "ask",
"git *": "allow",
"npm *": "allow",
"rm *": "deny"
},
"edit": {
"*": "deny",
"src/**/*.md": "allow"
}
}
}
规则按模式匹配,最后匹配的规则优先。通常把通配 * 放第一条,具体规则放后面。
白名单
-
- (默认拒绝,按需放行),适合安全要求高的场景:
"read": { "*": "deny", "src/*": "allow" }
黑名单
-
- (默认允许,按需拒绝),适合开放项目:
"read": { "*": "allow", "secret/*": "deny", "*.env": "deny" }
3.4 通配符规则
*:匹配零个或多个任意字符(包括 /);
?:精确匹配一个字符;其他字符按字面匹配;
~ 或 $HOME:在 read / edit / external_directory 规则里展开为用户主目录。
3.5 external_directory
当工具试图读写启动目录之外的路径时触发。例如:允许访问个人项目目录,但禁止在其中编辑:
{
"permission": {
"external_directory": {
"~/projects/personal/**": "allow"
},
"edit": {
"~/projects/personal/**": "deny"
}
}
}
四、Skills
针对特定任务的可重用指令可以做成 Skill,即 Markdown 文件。Skill 是按需加载的操作手册(SOP):Agent 启动时只能看到所有 Skill 的 name + description,判断需要时才通过 Skill 工具加载完整内容。
与 Agent 的区别:Skill 没有独立会话、没有自己的模型,继承调用方 Agent 的权限,只是被加载的一段内容。
4.1 Skill 寻找路径与优先级
Skill 有两类来源:OpenCode 自动搜寻的默认路径,以及配置文件里 skill 增加的路径。
默认路径包括:
.opencode/skills/<name>/SKILL.md
-
- (项目级,团队);
~/.config/opencode/skills/<name>/SKILL.md
-
- (全局级,个人);
.agents/skills/<name>/SKILL.md
- (兼容其他 Agent)。
配置文件里还可以显式追加目录,支持相对路径、~/ 路径、绝对路径以及 http:// / https:// URL:
"skills": [ "./team-skills", "~/shared/opencode-skills", "/opt/company-skills", "https://example.com/opencode/skills/" ]
<name> 是 Skill ID,即调用 Skill 时的名字。若两个 Skill 同名,后注册的来源覆盖先注册的。不要随意起重复名字,除非就是想故意覆盖早期来源里的那份;误撞名会导致你以为在用某份,实际加载的是另一份。注意这与权限规则的"最后匹配生效"不是一回事:这里是整份 Skill 定义被覆盖,不是规则逐条叠加。
Skill 来源优先级从低到高:
| Skill 来源 | 目录优先级 |
|---|---|
| 内置 Skills | 最低 |
| .agents/skills | 先全局,再从最远祖先目录逐层到当前目录 |
| ~/.config/opencode/skills | 同上层级 |
| 项目 .opencode/skills | 从项目根逐层向当前目录,越靠近当前目录优先级越高 |
| 配置里显式写的 skills 条目 | 按配置优先级 + 数组顺序,最高 |
4.2 SKILL.md 格式
Markdown 文件分两层:Frontmatter 是文件开头被 --- 包裹的元数据区(YAML 格式,存机器可读的配置字段);Markdown 正文是剩下的内容(给模型读的提示词 / 指令,支持标题、列表、代码块等普通 Markdown 语法)。解析时前者被提取成结构化字段,后者作为指令文本保留。
frontmatter 负责 Skill 的命名、描述和可见性:
| 字段 | 作用 |
|---|---|
| name | 展示名,只用来在列表里显示;不写就默认用路径派生的 Skill ID |
| description | 给模型看的一句话摘要,模型靠它判断什么时候该用这个 Skill,必须写清楚 |
| metadata.opencode/autoinvoke | 设为 false 时把 Skill 从模型的可选列表里隐藏 |
| disable-model-invocation | 隐藏效果和上面字段完全一样,是兼容写法 |
需要注意:opencode/autoinvoke: false 只是从可选列表里拿掉,Skill 仍然注册着,之后还能按 Skill ID 被显式加载。它不是权限拒绝;真正挡住加载要靠 Skill 权限的 deny。
范例:~/.config/opencode/skills/git-release/SKILL.md
--- name: git-release description: Create consistent releases and changelogs license: MIT compatibility: opencode ---
## What I do - Draft release notes from merged PRs - Propose a version bump
## When to use me Use when preparing a tagged release.
4.3 命名规则
1–64 字符,小写字母、数字加连字符,正则:
^[a-z0-9]+(-[a-z0-9]+)*$;
不能以下划线开头或结尾,不能有连续 --;
name 必须和所在文件夹名一致;
description 长度 1–1024 字符,要具体到 Agent 能正确选择。
4.4 权限控制
Skill 自身不带有权限,它使用调用 Agent 的权限。Agent 能否调用 Skill 在 opencode.json(c) 里控制:
{
"permission": {
"skill": {
"*": "allow",
"internal-*": "deny",
"experimental-*": "ask"
}
}
}
被 deny 的 Skill 对 Agent 完全隐藏——Agent 连它的存在都不知道。
五、Agents
OpenCode 内置了一些 Agent,也支持通过 Markdown 文件或 JSONC 配置新增可重用的 Agent。
5.1 内置 Agent 与运行模式
| Agent | 模式 | 用途 |
|---|---|---|
| build | primary | 默认编码 Agent,工具和工作目录外访问默认允许 |
| plan | primary | 探索和规划,不直接改普通项目文件 |
| general | subagent | 通用研究和多步任务,不能再派生子 Agent |
| explore | subagent | 搜索和阅读代码 / 网页,不能改文件 |
Agent 有三种模式:
| 模式 | 行为 |
|---|---|
| primary | 作为会话的主 Agent,用户直接对话 |
| subagent | 只通过主 Agent 的 subagent 工具调用 |
| all | 既能当 primary 也能当 subagent |
subagent 在自己独立的子会话里运行,不继承父 Agent 会话的对话历史。它始终在后台工作,不占用当前主会话;当子 Agent 回到空闲时将结果上报给父 Agent。父 Agent 的 subagent 权限只决定它能调用哪些 subagent;对 subagent 来说,它用自己配置的权限干活,不带父 Agent 的权限集合。
5.2 Agent 寻找路径
默认搜寻路径:
项目级:.opencode/agents/<name>.md;
全局级:~/.config/opencode/agents/<name>.md;
嵌套路径成为 Agent ID 的一部分,如 .opencode/agents/team/reviewer.md → team/reviewer。
Agent 也可以直接定义在 opencode.json(c) 里。
5.3 Agent 格式
使用 Markdown 文件或在 opencode.json(c) 里都可以添加可重用的 Agent。
Markdown 文件形式:格式和 Skill 类似,包括 Frontmatter 和 Markdown 两部分。Frontmatter 用于配置 Agent,Markdown 内容会输入给 Agent 作为上下文提示词(即 system 提示)。
Frontmatter 配置选项:
| 字段 | 必填 | 作用 |
|---|---|---|
| description | 否(建议写) | 用途说明;subagent 建议写,模型挑选用哪个时能看到 |
| mode | 否 | primary / subagent / all;新建自定义 Agent 缺省 primary |
| model | 否 | 模型引用,provider/model,可选 #variant,如 anthropic/claude-sonnet-5-5#high;不配则 subagent 继承父会话模型 |
| permissions | 否 | 有序权限规则数组,每条含 action、resource、effect |
| steps | 否 | 最大模型步数(正整数);走到最后一步移除工具、只让模型文本总结;新的用户输入重置额度 |
| hidden | 否 | 从普通列表、交互发现和 subagent 目录隐藏;只控可见性,不是安全边界 |
| color | 否 | UI 颜色:六位 hex(如 #ff6b6b)或主题色名 |
| system | 是 | 系统提示词(Markdown 正文就是) |
| disabled | 否 | 在该配置加载点移除某个内置或自定义 Agent |
范例:
--- description: Reviews changes for correctness and regressions mode: subagent model: anthropic/claude-sonnet-5-5#high permissions: - action: edit resource: "*" effect: deny - action: shell resource: "rm *" effect: deny ---
Review the current changes. List findings in severity order with file and line refs.
5.4 权限合并规则
- 全局 permissions 先应用,Agent 自己的 permissions 追加在后面;后匹配的规则覆盖前面的;Agent 没有的规则继承全局配置,不需要在每个 Agent 里重复写所有规则。
5.5 如何调用
Primary Agent:在 TUI 里用 /agent 切换,或在配置里设 default_agent;
Subagent:直接用自然语言让主 Agent 调用,主 Agent 根据 description 自动判断何时调用。
六、MCP
MCP(Model Context Protocol)是一套外部服务接入协议。OpenCode 可连接 MCP 服务器,把外部系统的工具、提示词、资源及指令等功能暴露给 Agent 使用。通过 MCP,Agent 可以调用 web_search、web_fetch、数据库查询、CI 触发等任意工具。MCP 工具会占用模型上下文,因此请仅添加实际需要的服务器。
6.1 MCP 提供的四类能力
| 能力 | 在 OpenCode 里的形态 |
|---|---|
| Tools(工具) | Agent 可调用的外部函数,命名为 <服务器>_<工具>,如 context7_resolve_library_id |
| Prompts(提示词模板) | 转成斜杠命令 <服务器>:<提示词>,如 /context7:find_docs |
| Resources(资源) | 通过内置工具 list_mcp_resources、read_mcp_resource 读取 |
| Instructions(指令) | 服务器初始化时返回的说明,自动拼进 Agent 的系统提示 |
6.2 两种连接方式
Local(本地):通过 stdio 启动一个命令进程(如 npx -y ...),可配工作目录 cwd、环境变量、超时;
Remote(远程):走 Streamable HTTP,配绝对 URL 和请求头;默认开启 OAuth(PKCE 登录、自动刷新令牌,凭据存在项目配置之外),也可 oauth: false 改用 API Key 等头部凭证。
配置示例:
{
"mcp": {
"servers": {
"playwright": {
"type": "local",
"command": ["bunx", "@playwright/mcp"]
},
"remote-server": {
"type": "remote",
"url": "https://mcp.example.com/mcp",
"timeout": 60000
}
}
}
}
6.3 MCP 与 Provider、Agent / Skill 的关系
图 3 Agent、Skill、MCP 三者关系
| Provider | MCP | |
|---|---|---|
| 管什么 | 模型怎么连 | 工具怎么连 |
| 输出 | 模型生成的文本 | 工具执行结果 |
| 调用方 | 用户选择模型 | 大模型自主判断何时调用 |
用一句话记忆三者关系:Agent 是人,Skill 是人手里的手册,MCP 是人能用到的工具。
| Agent | Skill | MCP | |
|---|---|---|---|
| 本质 | 独立执行者 | SOP 文档 | 外部工具服务 |
| 有独立会话 | 有 | 没有 | 没有 |
| 有自己的模型 | 有 | 没有 | 没有 |
| 调用方式 | Tab 切换 / @提及 | Agent 自动加载 | 大模型自主调用 |
七、Commands
Command 就是把一段提示词模板命名成可复用的斜杠命令。建一个 .opencode/commands/review.md,就能在 TUI 里用 /review 调用:
Review $ARGUMENTS for bugs and missing tests.
在 TUI 输入:
/review src/auth.ts
OpenCode 会把它替换成 "Review src/auth.ts for bugs and missing tests.",作为一条用户提示提交给模型。
7.1 Commands 寻找路径与优先级
默认搜寻路径:
全局(所有项目):~/.config/opencode/commands/;
项目内:.opencode/commands/。
说明:只发现 .md 文件;嵌套路径会变成命令名的 / 分层,如 team/review.md → /team/review;文件正文就是提示词模板,元数据写在顶部 YAML frontmatter;旧的单数目录 command/ 仍兼容,但新文件用 commands/。
Commands 还可以直接定义在 opencode.jsonc 里。Markdown 文件和 JSONC 配置块里的命令进的是同一个命令注册表;名字相同时,后注册的来源把先注册的那条整份替换掉。优先级从低到高:
- 内置命令最先注册;全局命令 ~/.config/opencode/commands/;项目命令 .opencode/commands/,项目内离当前目录越近,优先级高于祖先目录;JSONC 配置块里显式定义的命令,按配置优先级和数组顺序注册。
7.2 Commands 格式
| 字段 | 是否必填 | 作用 |
|---|---|---|
| template | 仅 JSON 需要 | 提示词模板,命令提交给模型的正文 |
| description | 否 | 命令列表、模型发现时展示的说明文字,不进提示词 |
| agent | 否 | 命令运行时切换到的 Agent |
| model | 否 | 模型覆盖,格式 provider/model 或 provider/model#variant |
| subagent | 否 | true 后台子会话跑;false 强制在当前会话跑 |
| subtask | 否 | subagent 的废弃别名,新配置不要用 |
Markdown 文件形式范例:
--- description: Review code for correctness agent: plan model: anthropic/claude-sonnet-5-5#high ---
Review $ARGUMENTS. Report bugs first.
7.3 命令参数
命令支持参数传入,有两种方式:$ARGUMENTS 和 $1、$2。
| 占位符 | 拆分方式 | 适合场景 |
|---|---|---|
| $ARGUMENTS | 整串原样,不拆 | 参数是一句话、一段路径、自由文本 |
| $1、$2… | 按空格分词,引号分组;最后一个兜底吃剩余 | 命令有固定参数顺序,如"文件 + 关注点" |
$ARGUMENTS:整段原样传入,不做任何拆分,用户在命令后面敲的整串文字直接替换进去。
模板 .opencode/commands/component.md:
Create a typed React component named $ARGUMENTS.
执行 /component Account Settings,替换后为:Create a typed React component named Account Settings. 注意 Account Settings 里的空格被完整保留——$ARGUMENTS 不会把它拆成两个词。
$1、$2:按位置拆分,用编号占位符取解析后的位置参数;默认按空格分词,用单引号或双引号括起来的词会分成一组,引号本身会被去掉。
模板 check.md:
Check $1. Focus on $2.
执行 /check src/auth.ts "error handling":$1 = src/auth.ts,$2 = error handling(引号被去掉,但里面的空格保留成一个参数)。
补充:如果模板里既没有 $ARGUMENTS 也没有位置占位符,OpenCode 会把非空参数追加到提示词末尾(空行之后)。
八、三种文件语法基础
8.1 JSON
JSON(JavaScript Object Notation)是一种纯文本数据交换格式,用来写配置文件、接口数据。它只有两种容器:对象(键值对)和数组(有序列表),外加六种基本值。opencode.json 使用的就是 JSON 语法。
两种容器:
对象
{}:键值对集合;键和值之间用冒号 :,每对之间用逗号 , 分隔;
最后一对后面不能再加逗号(标准 JSON);
数组
[]:有序列表;元素可以是对象、字符串、数字等;元素之间用逗号;最后一个元素后面同样不能有尾逗号(标准 JSON)。
六种值类型:
字符串:必须用双引号,如 "src/auth.ts";
数字:整数或小数,不加引号,如 42、3.14、-5;
布尔:小写 true / false;
空值:null;
对象:嵌套 {},如 { "a": 1 };
数组:嵌套 [],如 [1, 2, 3]。
8.2 YAML
YAML(YAML Ain't Markup Language)是一种缩进驱动的数据格式,常用于配置文件和数据交换,比 JSON 更适合人读手写。OpenCode 的 Markdown 文件里,frontmatter 就用 YAML。
缩进只能用空格,不能用 Tab;层级靠缩进区分,一般每层 2 个空格;键和值之间是冒号加一个空格:mode: subagent,写成 mode:subagent 不合法。
三种基本结构:
映射(对象):键: 值,如 mode: subagent,嵌套对象靠缩进;
序列(数组):- 项,每个 -是一个数组元素;元素是对象时,- 后面第一个键和后面的键对齐缩进;
标量值:字符串 reviewer 或 "reviewer",普通文本可裸写,特殊字符或有空格时可用双引号;
数字 8、3.14 不加引号;布尔 true / false 小写;空值 null 或 ~。
字符串写法:单引号为字面量,不做转义,内部两个单引号表示一个 ';双引号支持转义,如 n、t。
8.3 Markdown
Markdown 是纯文本格式,用简单标记表示格式。Skill、Agent 和 Command 文件都是 Markdown 格式。常用语法:
# 一级标题、## 二级标题;`加粗、*斜体*、 代码 `;- 无序列表、1. 有序列表;三反引号代码块,标注语言便于高亮; 转义字符。
8.4 三类 Markdown 文件的对应关系
三者都是"frontmatter 元信息 + 正文指令"的结构,字段和 JSONC 配置条目一一对应:
| 文件类型 | frontmatter 放什么 | Markdown 正文变成什么 |
|---|---|---|
| Agent(.opencode/agents/*.md) | description、mode、model、permissions、steps 等 | Agent 的 system 系统提示 |
| Skill(.opencode/skills/<id>/SKILL.md) | name、description、metadata 可见性 | Skill 的指令正文 |
| Command(.opencode/commands/*.md) | description、agent、model、subagent | 斜杠命令的 template 模板 |
九、常用操作
在 TUI 中输入 / 加命令名即可快速执行;输入 @ 选择 Agent;按 Ctrl+P 打开命令控制面板;在 TUI 中输入英文 !,可以将当前命令行切换到 shell 模式,Shell 命令输出会作为工具结果进入对话。
复制:Shift + 左键 选文字;粘贴:Shift + 鼠标中键。
常用命令与快捷键:
| 命令 | 作用 | 快捷键 |
|---|---|---|
| /connect | 添加或配置模型服务商 | — |
| /agent | 切换 Agent | — |
| /models | 切换可用模型 | Ctrl+X M |
| /skills | 召唤 Skills | — |
| /compact | 压缩当前会话上下文,长会话使用可保持回答质量 | Ctrl+X C |
| /new | 开启新会话(别名 /clear) | Ctrl+X N |
| /sessions | 查看并切换历史会话 | Ctrl+X L |
| /rename | 会话重命名 | — |
| /fork | 从当前会话状态分叉出一条新会话线 | — |
| /export | 导出当前会话为 Markdown | Ctrl+X X |
| /themes | 切换界面主题 | Ctrl+X T |
| /thinking | 显示 / 隐藏模型思考过程 | — |
| /help | 显示帮助 | — |
结语:Agent、Skill、Command 怎么选
| Agent(代理) | Skill(技能) | Command(命令) | |
|---|---|---|---|
| 本质 | 一个命名的助手角色 | 一套可按需加载的知识 / 操作包 | 一条固化的斜杠提示词模板 |
| 解决什么问题 | 用什么身份、什么模型、什么权限边界干活 | 某类任务该怎么做、参考哪些资料 | 把常用 prompt 一键提交,带参数和绑定 |
| 谁来调用 | 会话选定,或父 Agent 通过 subagent 拉起 | 模型根据 description 发现并加载 | 用户在输入框敲 /命令名 触发 |
| 上下文 | subagent 有全新独立上下文 | 加载进当前会话,不另起会话 | 默认当前会话,可指定后台子会话 |
| 权限 | 有自己独立的 permissions 集合 | 没有独立权限,跟随当前 Agent 的权限 | 不自带权限,跑在指定 Agent 下 |
| 模型 | 可自己配 model,否则继承父会话 | 不绑定模型 | 可在定义里覆盖 model |
| 定义内容 | system 提示 + 模型 + 权限 + mode + steps 等 | SKILL.md 正文(步骤 / 说明)+ 附属资源文件 | template 提示词 + 参数占位 + agent/model/subagent 绑定 |
简单总结:Agent 定义"谁来干活",Skill 提供"怎么干的手册",Command 是"一键触发的固定话术",MCP 接上"外部世界的工具",权限规则守住"能干什么"。把这几个对象的目录、优先级和字段对应关系理清,就能在团队里高效复用一套 OpenCode 配置。
128