技能
技能是一个可复用的指令文件——一个带有名称、描述和步骤的 Markdown SKILL.md——智能体可以按需将它拉入一项任务。MCP 服务器为智能体提供新的工具和数据，而技能则赋予它专业知识：如何进行一次严谨的代码审查、如何设计一个实验、如何从零构建一个 .docx。你在对话中通过键入 / 并从菜单中选取来调用某个技能。
技能是智能体自己的功能——每个受支持的智能体都从它自己的技能目录中读取它们。Codeg 是其上的管理层，它为你提供两种把技能放到那里的方式：
- 技能包——Codeg 附带的精选捆绑包（Experts、Science、Office）。你为选定的智能体启用某个包的技能，Codeg 便会将它们链接进去。
- 你自己的技能——为任意智能体手动编写一个
SKILL.md，可在全局或按项目的范围。
无论哪种方式，结果都相同：技能会出现在该智能体的 / 菜单中，随时可以调用。这两者位于相邻的设置界面下——技能包和技能——本页接下来将依次介绍。
启用一个精选技能包
打开设置 → 技能包。这是一个带标签页的中心，管理着三个由 Codeg 管理的精选捆绑包，它们共享同一个中央存储（~/.codeg/skills）和同一套启用模型：
| 技能包 | 其中有什么 | 深度 |
|---|---|---|
| Experts | 一个软件工程工作流库（取自开源的 superpowers 合集）——按发现、规划、执行、质量、调试、审查和元分组。 | 开箱即用 |
| Science | 一个研究工具箱——构思、设计、分析、可视化、评估和文献。 → 科学研究 | |
| Office | 用于创建和编辑 .docx、.xlsx 和 .pptx 的文档技能，由内置的 officecli 工具驱动。 → Office 文档 |
技能与智能体矩阵
每个标签页都显示一个网格：技能在侧边（按类别分组），你的智能体在顶部横排。勾选一个单元格即可为该智能体启用该技能，取消勾选则将其移除。一切都可批量操作：
- 一个技能的 ⋯ 菜单可以一次性在每个智能体上启用或禁用它。
- 一个智能体的列标题则相反——一次性处理某个智能体的每个技能。
- 选择若干技能（那些复选框），即可为选定的智能体子集切换选定的一组技能，而右上角的全部菜单可切换整个网格。
- 点击一个技能的名称可打开一个预览抽屉——它完整的
SKILL.md，外加一个按智能体的开关列表。
启用是即时且可撤销的；批量禁用会先征询确认，因为那是破坏性的方向。
启用究竟是如何运作的
中央存储是唯一的事实来源。当你为一个智能体启用某个技能时，Codeg 会从该智能体的技能目录放置一个指向中央副本的符号链接（在 Windows 上是联接）——因此没有任何东西被复制，也不存在记录启用状态的单独数据库：链接要么存在，要么不存在。如果你想查看，工具栏中的打开中央文件夹按钮会显示出 ~/.codeg/skills。
一个单元格并不总是简单的开/关。你可能会看到：
- 已阻止——一个同名的真实文件夹已存在于该智能体的技能目录中，因此 Codeg 不会覆盖它。请移动或重命名它，然后再启用。
- 链接至他处——该名称已经是一个链接，指向 Codeg 存储之外的某个地方。
- 复制模式 （琥珀色圆环）——文件系统拒绝了符号链接，因此 Codeg 改为复制了这些文件。它仍然有效；只是不会就地自动更新。
技能包会自我更新
Experts（以及任何内置技能）都烘焙进了 Codeg，并会在你升级时被重新提取到中央存储——因此已启用的技能无需你操作即可保持最新。就地编辑一个内置技能，Codeg 会将其标记为用户已修改并保留你的版本。Science 技能可能带有需要密钥或需要设置徽标——它们能正常链接，但技能本身在运行前需要一个 API 密钥或一个 Python 环境；参见该技能自己的说明以及凭据存放位置。
编写你自己的技能
对于任何不在任何技能包中的技能——一项内部约定、一个你反复执行的工作流——打开设置 → 技能并直接编写它。
选择一个受管目标（只有真正支持技能的智能体才会出现在下拉列表中），然后选择一个范围：
- 全局——智能体的主技能目录（Claude Code 的是
~/.claude/skills），在每个文件夹中都可用。 - 文件夹——一个项目范围的目录（
{folder}/.claude/skills），仅在你于该文件夹中工作时才出现。从你在 Codeg 中打开过的文件夹列表里选择该文件夹。
点击新建技能，为它指定一个 id（它将成为磁盘上的文件或 {id}/SKILL.md 目录，以及你将用来调用的 / 名称），然后编写正文。编辑器是分栏的：一个 Markdown 源码窗格，以及一个实时预览，后者会渲染内容并提取出 YAML 前置字段。一个 SKILL.md 只不过是前置内容加上一段步骤：
---
name: pr-review
description: Review a pull request for correctness, tests, and style
---
When asked to review a PR:
1. Read the diff and summarize the intent in one line.
2. Check each changed file for logic errors and missing tests.
3. Flag anything that breaks the project's conventions.保存后，它会与技能包安装的技能并列出现。在列表中，你可以预览、编辑、打开它所在的文件夹，或删除它。作为系统一部分附带的技能会被标记为只读——你可以阅读它们，但不能更改。因为你是直接写入智能体自己的技能目录，所以这就是智能体的原生技能格式；Codeg 只是为它提供了一个编辑器和一个预览。
在对话中调用技能
已启用的技能会在你需要它们的那一刻出现在 composer 中。键入 /，它们就会紧挨着斜杠命令出现在自动补全里——选取一个即可将它放入你的消息。（Codex 使用 $ 而非 /，以符合它自己的约定。） + 菜单还带有三大技能家族——Experts、Office 和 Research——的快捷方式，让你无需记住名称即可找到常用技能。
有两点需要了解：
- 一个未为当前智能体启用的技能会显示为锁定状态——先为该智能体启用它（在技能包或技能中），它就会亮起来。
- 你编写的文件夹范围技能仅在你于其所在文件夹中工作时才出现；全局技能则始终存在。
须知
- 技能是按智能体划分的，而非按 Codeg 划分。 为 Claude Code 启用一个技能并不会为 Codex 启用它——这正是那个矩阵的意义所在。你可以为任意多个智能体开启同一个技能。
- 更改在下一个会话生效。 技能会在智能体启动一个对话时被读取；对于一个已经打开的对话，重新连接以应用会在不丢失历史的情况下加载它。→ 配置智能体
- 禁用是安全的。 它只会从那一个智能体移除链接——中央副本以及其他每个智能体的链接都原封不动。彻底移除一个内置技能则会一次性把它从所有智能体中删除。
- 在服务器上运作方式相同。 两个设置界面都在浏览器版本中；技能位于 Codeg 运行所在的机器上。
- 自定义的 Pi 智能体目录不参与。 如果你已把 Pi 指向一个非默认的
PI_CODING_AGENT_DIR，它就不受共享存储管理，也不会作为目标出现。→ 智能体之间有何不同