技能

技能是可复用的做法包：一段说明 + 可选脚本 + 可选参考文件。它不常驻上下文，只在需要时加载，因此可以放很多而不拖慢对话。

一个技能包含什么

部分	作用
名称 / 描述	让 Agent 判断「什么时候该用」
指令（instructions）	具体怎么做：步骤、约束、输出格式
脚本（scripts）	可执行文件，运行时按需调用
参考（references）	文档、模板、示例，按需读取

新建技能

左侧菜单 Skills → 新建，填写名称、描述、指令，再按需添加脚本与参考文件。

导入技能

• 从目录导入：把技能目录拖到上传区域。目录里通常包含 SKILL.md 与 scripts/、references/。
• 从 GitHub 导入：填 owner/repo 或仓库 URL，可指定包名与分支。适合团队共享。

导入后请检查：

1. 描述是否写清了触发场景；
2. 脚本是否有可执行权限；
3. 引用的文件是否齐全。

在 Agent 中使用

打开 Agents 编辑页，在技能区域按分组勾选。技能多时先搜索名称。

备份到 GitHub

Skills → 备份 可以把技能目录同步到一个仓库：

• 填仓库（owner/repo）与 Token（需要 repo 权限）
• 指定分支
• 强覆盖会以本地为准替换远端同名文件，执行前确认

写一个好技能

1. 描述写触发条件，不要写实现细节。例如「当用户要求生成 Excel 时使用」。
2. 指令写步骤，每步可验证；不确定的地方写「先确认」。
3. 脚本保持幂等，重复执行不出错。
4. 大文件放参考，不要塞进指令。

常见问题

Agent 没用到技能：检查描述是否包含用户会说的关键词；确认已在 Agent 里勾选。

脚本执行失败：确认解释器与依赖；沙盒镜像里可能没有对应运行时。

导入后文件缺失：重新打包目录，确保引用路径是相对路径。