Skill

Skill 是一套面向 Agent 的任务说明包，可以同时包含教学指令、参考资料、模板、资源和脚本。它告诉 Agent“这类任务应该怎么做”，但不会因为被安装或选中就自动获得文件、命令、网络或 MCP 权限。

三种来源

工作区 Skill 来自项目可编辑内容，默认按不受信任的指令看待。已安装 Skill 经过用户确认，但“用户已安装”仍不等于其每个脚本都安全。

当前一次运行最多选择或激活 8 个 Skill。选择越多不一定越好；无关指令会占用上下文并增加冲突。通常只选最接近目标的一到两个。

如果已选 Skill 在发送前发生更新，界面会要求“使用最新版本”；如果它被移除或离开了所属项目，需要移除失效选择后再发送。

Agent 也可以从当前可用目录中发现并激活匹配 Skill。激活只在本次运行有效，不会让 Skill 永久驻留在对话中。

安装预览有有效期；过期后需要重新检查。安装完成后，可以在技能列表中启停、更新或卸载。

卸载只移除 Captain Who 管理的本地 Skill 包，不会修改原 GitHub 仓库或你最初选择的源目录。

一个最小工作区 Skill 形如：

text

.agents/
└── skills/
    └── my-skill/
        └── SKILL.md

入口文件必须精确命名为 SKILL.md。Skill 还可以带 references/、assets/、templates/、scripts/ 等资源。创建完整 Skill 请参考创建 Skill 教程，不要直接修改随应用安装的内置 Skill。

当前 Skill Script 只支持包内 Python 脚本，并依赖本机可验证的 Python 3。运行脚本要求完全读写范围和 Full Access 前置条件，而且每次执行都需要明确审批；缺少 Python 依赖时只会报告，不会自动安装。

这意味着“脚本来自一个 Skill”不是自动执行理由。审批时仍应核对 Skill、脚本、参数、依赖和目标项目。

创建或编辑 Word、Excel 和 PowerPoint 依赖相应内置 Skill。底层 Office 工具主要负责检查、验证和渲染；真正的新建与编辑由 Skill 提供的受管 Builder/Editor 完成。