🧩 技能
用纯文本指令教会 AI 如何处理某类任务。
Skill 是可复用的 Markdown 指令集。你可以把它绑定到模型上，或者在聊天里临时调用。它和 Tools 的区别在于：Tool 是可执行代码，而 Skill 是纯文本方法论，例如 code review checklist、写作风格规范、故障排查手册、数据分析 SOP。
你可以在聊天中用 $ 直接引用 skill，把完整内容注入当前会话；也可以把 skill 挂到模型上，通过惰性加载按需取用。
为什么用 Skills？
无需写代码
Skill 用 Markdown 就能写，不需要 Python、API 或额外部署。
按需加载
挂在模型上的 skill 默认只注入轻量 manifest（名称 + 描述）。当模型判断确实需要时，才会通过 view_skill 加载全文。
跨模型复用
同一份 “Code Review Guidelines” 可以挂到所有 coding 模型上。你更新一次，所有模型都能继承新版规则。
可与工具组合
Skill 负责告诉模型怎么用工具，而 Tool / Open Terminal 负责提供能力本身。
核心特性
| 📝 Markdown 内容 | 纯 Markdown 编写 |
⚡ 聊天中 $ 调用 | 直接把完整内容注入当前对话 |
| 🤖 模型绑定 | 挂在模型上，长期可用 |
| 📦 Lazy loading | 默认只注入 manifest，正文按需载入 |
| 📥 导入 / 导出 | 可导入带 frontmatter 的 .md 文件，也可导出 |
| 🔒 访问控制 | 默认私有，可共享给用户或组 |
| 🔀 启用 / 停用 | 可停用 skill 而无需删除 |
Skills 的工作方式
用户主动选择（$ 引用）
在聊天输入框中输入 $，打开 skill picker。选中后，Skill 的完整内容会直接注入系统提示词。
模型绑定的 Skills
绑定到模型上的 Skills 使用惰性加载：
- 系统先只把 skill 的名称和描述注入上下文
- 模型收到一个
view_skillbuiltin tool - 当它认为某个 skill 有用时，调用
view_skill(skill_name)拉取全文
这样即使给模型挂了很多 skills，也不会在一开始就占满上下文窗口。
创建 Skill
进入 工作区 > 技能，点击 + 新建技能。
| 字段 | 说明 |
|---|---|
| Name | 展示名称，例如 “Code Review Guidelines” |
| Skill ID | 唯一 slug；创建时可编辑，创建后只读 |
| Description | 简短摘要，模型会依赖它判断是否需要加载全文 |
| Content | Skill 正文，Markdown 格式 |
从 Markdown 导入
点击 Import，选择 .md 文件。如果文件前部带有 YAML frontmatter 中的 name 或 description，界面会自动填入。
将 Skill 绑定到模型
- 打开 工作区 > 模型
- 编辑目标模型
- 在 Skills 区域勾选要绑定的 skill
- 点击 Save
之后模型就能在相关任务里按需加载这些 skill。
Skill 管理
在 Skills 列表页中，可以通过菜单执行：
| 操作 | 说明 |
|---|---|
| Edit | 编辑内容、名称、描述 |
| Clone | 克隆一份副本 |
| Export | 导出为 JSON |
| Delete | 删除 |
顶部 Export 按钮还可以一次性导出所有可访问 skills。
Active / Inactive：停用后的 skill 不会被注入 manifest，也不能被模型加载。
访问控制
Skills 使用与其他 Workspace 资源一致的访问控制：
- 默认私有
- 可分享给用户或组
- 可设置只读或可编辑权限
把某个 skill 挂到模型上，并不会自动让所有用户都能拿到它。
当用户与模型对话时， OPL 数据空间仍会检查该用户是否对 skill 具有 read 权限；没有权限的 skill 会被静默排除。
需要的权限
| 权限 | 控制内容 |
|---|---|
| 工作区 > 技能访问 | 访问技能工作区、创建和管理 skill |
| 分享 > 分享技能 | 把技能分享给用户或组 |
| Sharing > Public Skills | 把 skill 设为公开 |
典型用法
Code review 标准
把团队的 review checklist 写成 skill，挂到 coding 模型上，让每次审查都按同一标准执行。
写作风格规范
把术语、语气、格式规则写成 skill，挂到写作模型上。
故障排查手册
把 runbook 编成 skill，例如“先看日志，再测配置，再看连通性，最后再升级处理”。
工具使用说明
配合 Open Terminal 告诉模型如何更稳地使用工具，例如“始终检查 exit code”、“长命令使用流式输出”等。
限制
纯文本，不可执行
Skill 是指导文本，不是可执行代码。需要计算、系统调用或 API 调用时，还是要用 Tools。
$ 引用会占上下文
通过 $ 注入时，完整正文会立刻进入系统提示词。很长的 skill 可能会挤压会话历史。
Lazy loading 依赖 function calling
模型绑定的 skills 依赖 view_skill 工具，因此需要启用 native function calling。否则模型只能看到 manifest，而拿不到正文。