OpenCode: OpenCode Skills与Skills使用
最后更新：2026-08-31
Skills 是 OpenCode 的预定义技能系统，为 AI 提供专业化的工作流和知识。
1. 你将学到
- Skills 的概念与定位
- 内置 Skills 列表
- Skills 加载与使用
- 自定义 Skills 开发
2. 什么是 Skills
Skills 是预定义的提示词模板 + 工作流 + 知识库，让 AI 在特定领域获得专业化能力。
| 特点 | 说明 |
|---|---|
| 按需加载 | 不预加载，触发关键词时才加载 |
| 模板化 | 标准化的工作流程 |
| 可复用 | 一个 Skill 可在多个项目中使用 |
| 可扩展 | 可以开发自定义 Skills |
3. Skills 触发机制
Skills 通过任务关键词自动触发加载：
| 触发关键词 | 加载的 Skill |
|---|---|
| "新增""开发""模块""功能" | brainstorming |
| "报错""失败""bug""异常" | systematic-debugging |
| 方案获批后 | writing-plans |
| "搞定了""已修复" | verification-before-completion |
| 脚本编写、逻辑变更 | test-driven-development |
| commit 前 | requesting-code-review |
| 批量翻译、多语种 | subagent-driven-development |
4. 核心 Skills
(1) brainstorming（头脑风暴）
在创造性工作前探索意图、需求和设计。
(2) writing-plans（编写计划）
将规格说明或需求转化为分步骤的实施计划。
(3) executing-plans（执行计划）
按计划逐步执行，不跑偏。
(4) systematic-debugging（系统化调试）
遇到 bug 时，先理解根因再修，不猜不试。
(5) test-driven-development（测试驱动开发）
先写失败测试 → 最小实现 → 通过（RED-GREEN-REFACTOR）。
(6) verification-before-completion（完成前验证）
声称完成前必须跑验证命令，证据先于断言。
(7) requesting-code-review（请求代码审查）
提交前安全扫描 + 质量门禁 + 自动修复。
(8) subagent-driven-development（子代理驱动开发）
批量任务时派分身并行执行（两阶段审查）。
(9) dispatching-parallel-agents（分发并行代理）
面对多个独立任务时并行执行。
5. Skills 使用流程
graph TB
A[用户下达任务] --> B{关键词匹配}
B -->|新增/开发| C[加载 brainstorming]
B -->|报错/失败| D[加载 systematic-debugging]
B -->|方案获批| E[加载 writing-plans]
B -->|已完成| F[加载 verification]
C --> G[执行 Skill 工作流]
D --> G
E --> G
F --> G
6. 自定义 Skills
(1) Skills 目录
- 全局：
~/.config/opencode/skills/ - 项目级：
.opencode/skills/
(2) Skill 文件格式
每个 Skill 是一个 Markdown 文件，包含：
MARKDOWN
---
name: my-custom-skill
description: 自定义技能描述
triggers:
- "关键词1"
- "关键词2"
---
## 技能说明
这里写技能的详细工作流程和指导...
## 执行步骤
1. 步骤一
2. 步骤二
3. 步骤三
(3) 在配置中注册
JSON
{
"skills": {
"my-custom-skill": {
"path": "./skills/my-custom-skill.md"
}
}
}
❓ 常见问题
Q Skills 会自动加载吗？
A 不会预加载。Skills 是按需触发——当你的任务关键词匹配到某个 Skill 时，它才会被加载。这样节省 token。
Q Skills 和 AGENTS.md 有什么区别？
A AGENTS.md 是项目规则（告诉 AI 不要做什么），Skills 是工作流（告诉 AI 怎么做某类任务）。两者互补。
Q Alice 只用了内置 Skills，Bob 开发了自定义 Skills，谁的工作质量更高？
A 对于通用任务，内置 Skills 足够。对于有特殊工作流需求的团队，Bob 的自定义 Skills 能显著提高一致性。按需选择。
📖 小节
- Skills 是预定义的专业化工作流
- 按需加载，通过关键词触发
- 核心技能：头脑风暴、调试、TDD、验证等
- 支持自定义 Skills 开发
- 与 AGENTS.md 互补：规则 + 工作流
📝 作业
-
基础题：在 TUI 中触发 brainstorming Skill，体验结构化头脑风暴流程。
-
进阶题：触发 systematic-debugging Skill，用系统化方法调试一个 bug。
-
挑战题：开发一个自定义 Skill，定义你的团队特有的代码审查工作流。
