管理 Skill 内容和版本
Skill 是包含 SKILL.md 和相关文件的版本化能力包。准备好 Skill 内容和版本后，再通过技能组模板或实例把一个或多个 Skill 提供给智能体。
准备 Skill 内容和版本
先准备并审查 Skill 内容，再明确版本选择，确保加入技能组前能够识别要使用的文件和版本。
以下入口仅在租户已启用 Skill 能力时可用。按钮会在新标签页打开控制台。若先进入登录页，控制台目前不会在登录后自动返回目标页面；请登录后返回本文，再次选择按钮。
创建或导入 Skill
打开 Skills 管理。
也可从左侧导航进入 Skills 管理。
在 Skills 管理 中可以：
- 选择 新建 Skill 并编辑
SKILL.md。 - 添加和编辑 Skill 文件。
- 导入 zip（新建 Skill）。
- 导出 zip。
- 克隆 Skill。
- 选择 新版本。
- 选择 设为 latest 或 设为 stable。
导入 ZIP 前检查文件内容，不要把密钥、个人数据或不受信任的可执行内容打包进 Skill。
选择 新建 Skill 时可以直接提供初始 SKILL.md。打开目标 Skill 后，在 文件 中可以选择 上传，或打开 新建文件 创建文本文件；文本内容可以编辑和删除，二进制文件不能在线编辑。
导入 ZIP 后，先逐个检查 SKILL.md、脚本、配置和附带文件，再把状态调整为可用于团队的状态。导入成功不代表内容已经通过安全审查。
管理 Skill 版本
生产技能组应优先固定明确版本。选择 latest 会动态跟随最新版本；latest 变化后，后续使用结果可能改变。
推荐流程：
- 选择 新版本，在 新建版本 中基于当前编辑器内容填写 描述和 创建人。
- 检查新版本的文件列表和
SKILL.md。 - 选择 设为 latest，在开发技能组中测试。
- 把通过验证的版本 设为 stable。
- 在生产技能组中选择明确版本号。
- 更新智能体实例并执行回归测试。
不要把 stable 标记理解为自动部署或自动回滚，它只是版本选择信息。
设为 latest 会改变选择 latest 的技能组今后使用的版本。生产技能组需要可重复结果时，选择具体版本号，而不是 latest。
从 Skills 广场克隆
打开 Skills 广场。
也可从左侧导航进入 Skills 广场。
在 Skills 广场 中搜索 Skill，并选择 克隆。克隆时选择 stable 或 latest 后，检查得到的内容和文件，再加入团队技能组。
广场提供发现和克隆入口，不代表内容已经通过当前租户的安全或业务审批。
需要在环境间审查或迁移时，可以从 Skill 详情选择 导出 zip。导出物可能包含脚本和业务内容，应按内部软件制品处理，不要通过公开聊天或不受控文件服务传递。
将 Skill 提供给智能体
Skill 需要通过技能组提供给智能体；配置后，应验证目标版本的说明和相关资源能够在运行时按预期读取。
将 Skill 加入技能组
智能体通过技能组使用 Skill。准备好内容和版本后，参见配置技能组模板和实例，选择每个 Skill 的具体版本或 latest，并把技能组添加到智能体模板。
在运行时读取 Skill 内容和资源
智能体通过技能组取得 Skill。运行时先根据名称激活匹配的 Skill，读取所选版本的 SKILL.md；当说明引用脚本、配置、参考资料或其他相关文件时，再按相对路径读取对应资源。
SKILL.md：提供任务步骤、适用条件、示例和边界。- 相关文本资源：在 Skill 说明需要时读取，作为完成任务的输入。
- 脚本文件：可以作为 Skill 资源读取，但不会因此自动执行、安装依赖或注册为工具。
Skill 资源读取和沙箱文件是两条独立路径。即使来源智能体模板同时关联技能组和沙箱，所选 Skill 文件也不会自动进入沙箱。任务需要执行命令、脚本或业务操作时，应确认沙箱本身具备相应文件、运行时和依赖，再通过沙箱工具显式执行并检查结果。
验证 Skill 版本
保存 Skill 后，把它加入技能组并创建或更新智能体实例，再完成以下步骤来验证实例是否按预期使用它：
- 用能明确触发 Skill 的输入测试。
- 在 Trace 中确认发生了 Skill 激活；测试依赖相关文件时，还要确认发生了资源读取。
- 使用只存在于目标版本中的短语或样例，确认实际解析的 Skill 版本。
- 检查读取的资源路径与所选版本中的文件路径一致。
- 用不会触发 Skill 的输入确认边界。
维护 Skill
通过新增版本和调整技能组引用完成升级或回退；删除前先确认现有引用和需要保留的制品。
升级或回退 Skill
升级 Skill 时保留当前可用版本，再创建并检查新版本。在测试技能组中选择目标版本，更新测试智能体实例，并用目标版本独有的说明或资源完成回归。测试通过后，再按升级或回退技能组更新生产技能组。
回退时让技能组重新选择先前验证的具体版本。不要为了回退而删除仍被生产技能组引用的版本。
删除 Skill 或版本
删除前检查技能组模板、技能组实例、智能体模板和智能体实例的引用：
- 删除一个版本可能让固定到该版本的技能组无法解析。
- 删除 Skill 会移除其元信息和版本入口，不能自动修复技能组。
先让引用该 Skill 的技能组、智能体模板和智能体实例改用替代版本并完成回归，再执行删除。对于需要保留的制品，删除前选择 导出 zip 并存入团队批准的制品库。