OpenCode 中文实战课 Skill 技能系统详解：如何把重复操作封装成 AI 技能的 3 种高级模式

• 文档
• 教程

OpenCode 的 Skill（技能系统）让你把「重复操作」封装成按需加载的 AI 技能：在 SKILL.md 中写清它做什么、何时用，之后 AI 会自动识别任务并加载执行。本文基于OpenCode 中文实战课的 Skill 三课内容，带你从零创建技能，并掌握3 种高级模式，把重复劳动变成可复用的自动化工作流。

为什么需要 Skill：告别重复解释的烦恼 🤔

想象这个场景：你让 AI 查询收入数据，但它不知道你们的表结构、指标定义和过滤规则，每次都要从头解释一遍。

问题根源：AI 每次对话都是全新开始，没有你团队的专业知识。

Skill 就是一套按需加载的知识包：把专业知识封装成技能，AI 判断任务匹配时自动加载，立刻"懂行"。

那它和 CLAUDE.md 有什么区别？

选择原则：项目特有的规范放 CLAUDE.md；可复用的流程性知识做 Skill。

如何创建你的第一个 Skill：3 步快速上手

第 1 步：建目录

在项目下建.opencode/skill/目录，每个技能一个文件夹，里面放主文件：

.opencode/skill/code-review/SKILL.md

注意两点：文件必须叫SKILL.md（全大写）；skill/和skills/目录都支持。

第 2 步：写最小可用的 SKILL.md

文件开头只需两个字段：

name: code-review description: 执行代码审查，检查规范、Bug、性能和安全。 用户要求"审查代码""code review"时使用。

• name：小写字母 + 数字 + 单个连字符，如sql-analysis
• description：唯一决定技能是否被触发的字段，AI 靠它做语义判断

第 3 步：把 description 写"准"

差的写法是"帮助处理文档"——太模糊，AI 无法判断何时触发。好的写法包含 4 个要素：

完整格式规范和权限配置（allow/ask/deny）见 Skill 基础课。

Skill 三层结构：用渐进式披露省下上下文 💡

Skill 系统的核心设计是渐进式披露（Progressive Disclosure）——像组织一本手册一样分层加载信息：

目录长这样：

.opencode/skill/sql-analysis/ ├── SKILL.md # 第二层：工作流程和关键逻辑 └── references/ # 第三层：按需读取 ├── finance.md └── examples.md

原则：SKILL.md 只写工作流和决策逻辑，详细的表结构、查询示例放 references/，AI 需要时自己去读。这样既装下了海量知识，又不会撑爆上下文窗口。

3 种高级模式：把重复操作变成自动化工作流

课程 5.3c 高级模式 总结了五种工作流模式，这里挑最常用、最贴近"封装重复操作"的 3 种：

模式 1：顺序工作流编排——固定多步骤流程

适用：必须按固定顺序执行的重复操作，比如"入职新客户 = 创建账户 → 设置支付 → 创建订阅 → 发送欢迎邮件"。

写进 SKILL.md 的 3 个关键技巧：

• 步骤编号：明确 1/2/3 顺序，别让 AI 跳步
• 声明依赖：步骤 3 的订阅要用步骤 1 输出的 customer_id
• 失败回滚：任何一步失败时，记录原因、回滚已创建的资源、通知管理员

模式 2：迭代优化——自动改到质量达标

适用：一次做不好、需要反复打磨的场景，比如生成报告、撰写文案。

这个模式的三件套：

1. 质量标准：明确检查项（缺失章节、格式不一致、数据错误）
2. 优化循环：初稿 → 验证 → 修复问题 → 再验证
3. 终止条件：设定最大迭代次数（如 3 次）

最容易踩的坑：没写"何时停止"。迭代循环不收敛，AI 会反复空转——把最大次数写进技能里，问题就解决了。

模式 3：上下文感知工具选择——决策树

适用：同一目标、视情况选不同工具的场景。比如存文件：大文件走云存储、协作文档走 Notion、代码走代码仓库、临时文件留本地。

在技能里写一棵决策树：先检查文件类型和大小 → 按分支选工具 → 向用户解释为什么这样选。透明的决策过程，用得更放心。

课程中还覆盖了另外两种模式——多 MCP 协调（一个技能编排 Figma、云盘、任务系统、IM 多个服务完成设计交接）和领域智能（操作前先做合规检查并留审计记录），需要时可查阅完整课程内容。

分发团队技能：从个人工具到团队资产

技能打磨好了，别只放在自己电脑上。OpenCode 支持 4 种分发方式：

一句话建议：个人用本地目录起步；团队把技能库放进共享目录或 Git 仓库，在opencode.json里配置一次，全员即可使用。

常见坑与解决办法 ⚠️

总结：封装重复操作的 3 步法

1. 封装知识：写 SKILL.md，用 description 说清"何时用我"
2. 设计工作流：按场景选模式——固定流程用顺序编排，需要打磨用迭代优化，多工具选路用决策树
3. 测试与共享：做触发测试（正向激活）和负向测试（不该激活的场景），验证后分发给团队

想系统学习完整内容，包括真实案例和安全审计清单，可以直接阅读课程原文：

• 5.3a Skill 基础：封装可复用的专业知识
• 5.3b Skill 进阶：三层结构与可执行脚本
• 5.3c Skill 高级模式：工作流编排与分发共享

搭配 5.4 快捷命令 还能用斜杠命令一键触发常用任务；更多进阶内容见 第五阶段目录。

• 文档
• 教程