OpenCode 进阶：把它用得更专业

自定义命令、项目规则、权限与 MCP —— 从会用到用好

本页你会学到什么

在装好、跑通 OpenCode 之后，这几项能力能让它真正融入你的研究工作流：自定义斜杠命令、项目规则（AGENTS.md）、权限控制、MCP 工具接入。内容依据 OpenCode 官方文档整理。

1 自定义斜杠命令：把常用任务一键化

除了内置的 /init、/undo、/redo、/share、/help，你可以把反复要做的研究任务做成自己的斜杠命令。

在项目里新建 .opencode/commands/ 文件夹，放一个 markdown 文件，例如 .opencode/commands/check-data.md：

---
description: 对当前数据做标准检查
agent: build
---
请对 data/ 下的数据做标准检查：行列数、每列数据类型、缺失值数量、描述统计，
并把结果整理成 outputs/report.md。原始数据不要修改。

之后在输入框输入 /check-data 就能一键触发。frontmatter 里的 description 是命令说明，agent 指定用哪个模式执行，正文就是发给模型的提示词模板。

把「数据检查」「变量缩尾」「生成回归表」这些高频动作都做成命令，你的 OpenCode 就成了一套属于你自己的研究流水线。详见官方文档 · Commands。

AGENTS.md（放在项目根目录）是 OpenCode 每次启动都会读取的项目规则/记忆——相当于给 AI 的一份”项目须知”。

在项目里运行 /init，OpenCode 会扫描项目、生成或更新 AGENTS.md，写入运行/测试命令、目录结构、项目约定等。你也可以手动补充规则，例如：

# 项目须知

## 数据
- data/ 下为原始数据，任何情况下都不得修改
- 清洗后的数据写入 data_clean/，分析结果写入 outputs/

## 规范
- 所有脚本用相对路径、中文注释
- 面板数据分析优先用固定效应，并在报告中说明识别策略

这样换台电脑、换个新对话，AI 都能先读 AGENTS.md 快速进入状态，不用每次重复交代。详见官方文档 · Rules。

Build / Plan 模式（Tab 切换）：Plan 模式只读不改、先出方案；Build 模式可写文件、可执行命令。复杂任务先 Plan 出方案、你确认后再 Build 执行，最稳。
权限控制：OpenCode 可以配置哪些操作需要征求同意、哪些自动放行（见官方文档 · Permissions）。研究场景建议：文件读写可放行，删除、git push、联网等敏感操作保留人工确认。

MCP（Model Context Protocol）让 OpenCode 调用外部工具与数据源。在 OpenCode 配置文件 opencode.json 的 mcp 段里按名字添加即可：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "my-tool": {
      "enabled": true
    }
  }
}

加好后，MCP 提供的工具会和内置工具一起自动可用。

MCP 会吃上下文

每个 MCP 服务器都会往上下文里加工具说明，工具一多很快就把上下文占满。只启用当前任务真正需要的 MCP，用完可把 enabled 设为 false 临时关掉。详见官方文档 · MCP Servers。

把这些用熟，OpenCode 就不再只是”能跑代码的聊天框”，而是一套可定制、有记忆、边界清晰的研究助手。更多进阶用法见 OpenCode 官方文档。