# 技能中心与助手技能

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：模型与 AI 能力。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/skills/

## 技能中心是什么

技能是一组可被模型按需读取的专项指令和资料。它适合沉淀固定工作流、写作规范、项目背景、工具使用说明等内容,避免每次聊天都手动粘贴。

## 先说清楚作用范围

技能有“内容”和“启用”两层：技能中心中安装的一份 Skill 内容由本应用内的助手共享，但**安装不等于对所有助手自动生效**。每个助手都可以在自己的“技能”页独立打开或关闭同一个 Skill；只有当前助手已启用的 Skill 才会暴露给模型。

也可以从技能这一侧批量设置：在技能中心列表中点技能右侧的 **启用** 或助手数，或打开技能详情的 **概览 → 启用到助手**，一次勾选多个助手，支持全选和反选，关闭面板即保存。Skill 市场中已安装技能的详情页，以及对话中创建技能成功后的卡片，也提供同一入口。

关闭某个助手的开关只影响该助手，不会删除 Skill，也不影响其它助手。相反，编辑、更新或删除 Skill 本体会影响所有已启用它的助手；需要不同规则时，应创建或复制为另一份 Skill。

## 在哪里管理

打开 **设置 → 助手与能力 → 技能中心**,可以新建技能、编辑技能、删除技能。列表顶部可进入 **技能市场**；上方筛选可只看已启用、未启用或有新版本的技能，标题栏的搜索可按名称和触发描述查找。点标题栏的 **＋**，可以新建技能或分组，从文件导入 zip 或带 frontmatter 的 `SKILL.md` 文本文件，也可以从 GitHub 安装（粘贴公开的仓库、技能子目录或 `SKILL.md` 链接）。

从 GitHub 导入时，先查找技能；仓库内有多个技能时，选择需要的项目，再核对来源、附件和运行条件后安装。安装的是所选技能目录及其附件，不只是 `SKILL.md` 正文。同名技能需要明确确认覆盖；失败项可单独重试。安装后可选择助手启用；从助手编辑页进入时，启用只加入原编辑草稿，仍需保存助手。

**外部技能的运行条件**：受系统与当前环境限制，安装成功不代表所有功能均可直接运行。技能里的 Python 脚本和 `python`、`pip` 等命令行可以用应用内置的 Python 运行环境执行；依赖 Node.js、系统程序或 MCP 的技能可能需要另外配置远端环境或工具。技能详情和导入页会分析运行条件，标出「本机可运行」「部分可用」或「需要外部环境」，并列出已预置和首次运行会自动安装的依赖；缺失依赖不阻止安装。作者未声明依赖时，会提示运行条件未确认，而不会标为已兼容。安装不会自动执行脚本、连接服务或启用工具。

删除 Skill 会同时清理所有助手对它的启用引用，而且当前不可撤销。预置 Skill 删除后也不会在下次启动或版本升级时自动恢复；需要保留副本时，应先在技能详情中导出 ZIP，之后可再导入。

普通和大型技能包均可免费导入；Skill 市场下载和更新也无需 Pro，但需要登录并连接在线服务。文件数量超过 1000 个或解压后超过 50 MiB 时会识别为“大型技能包”，支持海量资料的分段读取和资源定位。GitHub 导入可在安装前查看文件数量与大小。超过安全上限，或包含设备无法可靠处理的超长路径时会拒绝导入，并提示精简目录、缩短文件名或拆分技能包。

## 预置技能

应用提供多种预置技能，可以按需启用、编辑或删除。例如，`app-help` 可以读取帮助中心、当前安装版本和历史版本的更新说明，回答应用使用和版本变化问题或为技能更新提供依据，`grilling` 帮你逐步澄清方案；「文档转 Markdown」用于转换文档，「ZIP 文件处理」用于配合代码工作台处理压缩包。Word、Excel、PPT 的生成和编辑已由独立的「Office 文档」内置工具提供。

这些内置文档与表格能力无需 Pro。生成文件只需在当前聊天中勾选 **Office 文档**。旧官方文档与表格技能由新工具替代；用户自行修改过的技能会保留。具体步骤见「如何生成 Word、Excel 和 PPT 文件？」。

## 技能包含什么

- **概览**:技能名称和触发描述等基础信息。触发描述就是 `SKILL.md` frontmatter 中的 `description`,模型据此判断是否需要加载该技能。
- **正文**:技能的主说明,模型调用 `use_skill` 时会读取这里的指令。
- **文件**:技能附带资料。可以上传文本和文档,文档会先抽取为文本后保存到技能文件中。

技能包可附带 `cube-extension.json` 声明版本、来源、运行环境、工具依赖和必备资源，在概览显示“扩展要求”。来源由作者填写，不代表认证。应用会检查清单和资源；安装不会自动启用工具、连接 MCP 或安装运行时。模型加载技能时会得到本轮实际可用的依赖名称。Python 由应用内置环境提供，Node.js 需要另行准备远端环境。删除技能不删除独立配置的 MCP 连接。

## 怎么给助手启用

进入 **助手 → 编辑助手 → 技能**,打开需要的技能开关。相同的 Skill 可以在助手 A 中打开、在助手 B 中关闭，无需复制一份 Skill；也可以在该区域点 **管理** 跳转到技能中心。

## 在对话中创建或编辑

先在 **助手 → 编辑助手 → 工具** 中打开 **管理技能**。开启后不需要在对话工具选择器中再次勾选，你可以直接要求助手“创建一个 Skill”“优化并更新某个 Skill”或“恢复上一版”。模型会生成结构化草稿，并在消息中展示名称、触发描述、正文差异和文本附件变更。Skill 名称是展示名，支持中文等任意文本(不超过 64 个字符)；应用会自动生成内部目录标识，与展示名互不影响。编辑现有技能时，如果触发描述未修改，模型可以在工具调用中省略该字段，草稿会继承技能中已保存的值。确认前可以直接编辑触发描述、正文和附件内容。

**只改需要调整的部分**：例如说「把这个技能里要求输出表格的那一段改为分点说明，其他内容保持原样」。助手可以按关键词定位正文片段，再只提交这部分的替换文字；编辑读取默认分段返回，不必为了改一句话读取、重写整个技能。只改触发描述时，也无需重新提交未改动的正文。这能减少编辑时的 token 消耗，实际用量仍取决于模型调用方式和修改范围。此处的局部替换支持技能主正文，技能附件的内容更新仍按单个文件处理。

**根据应用更新调整技能**：在当前助手的 **技能** 页启用 `app-help`，并在 **工具** 页开启 **管理技能** 后，可以说「读取当前版本更新说明，检查我的某某技能需要哪些调整，并生成修改草稿」。助手可搜索或分段读取与 **设置 → 关于 Cube Agent → 更新说明** 相同的内容，再结合帮助主题和实际可用工具核对用法。读取不会自动修改技能，修改仍需你确认草稿。

**问版本变化**：启用 `app-help` 后，也可以问「相比上一版改了什么」「这个功能是哪个版本加的」。助手会读取与 **设置 → 关于 Cube Agent → 历史版本** 相同的随包说明，引用对应版本的原文回答；资料只到当前安装的版本，不包含尚未安装的新版本。

草稿确认后会直接保存到技能中心，并可为当前助手启用；取消则不会写入任何内容。每次覆盖前会自动保存当前内容作为“上一版”，新的正式更新会覆盖更早的备份。恢复上一版时两版会交换，因此误恢复后仍可切回。

更新或恢复现有 Skill 时会在内部校验当前内容是否发生变化。如果编辑期间原文件已经变化，会停止覆盖；草稿卡可直接基于最新版重试。对话内可以新增、修改或删除小型文本附件，但不能删除整个 Skill，也不能访问 `.cubeagent` 内部目录；删除整个 Skill 仍需前往技能中心。

**管理技能** 完全由当前助手的工具开关控制。它控制的是“创建、更新或恢复共享 Skill 内容”的权限，不是某个 Skill 的使用开关。关闭后，即使助手已经启用了其他 Skill，也不能创建、更新或恢复 Skill；会话中的历史工具选择同样不能绕过。拒绝或取消草稿不会修改任何文件。

只有当前助手启用的技能会暴露给模型。对话时,模型会先看到技能摘要,再通过 `use_skill` 按需读取完整正文或文件内容。大型文件会分段读取;大型资料技能可以先按路径关键词搜索资源,避免一次加载整个资料目录。

## 连接技能账号（如 ima 知识库）

部分技能需要你自己的账号，例如 ima 知识库与笔记。这类技能会在 **技能详情 → 账号连接** 显示连接入口；对话中第一次用到时，结果下方也会出现 **连接** 卡片。点开后按提示打开获取页面，把 Client ID、API Key 等粘贴进去，点 **验证并连接**。

- 只需填写一次。可勾选 **同时用于其他助手**，让已启用该技能的其他助手一起使用。
- 保存的内容只在请求该技能声明的网站（卡片上会写明，如 ima.qq.com）时由应用自动填入，AI 和脚本都看不到内容，也不需要把 Key 发在聊天里。
- 连接成功后对话会自动继续。Key 过期或被重置时，AI 会再次显示连接卡片，重新粘贴即可。
- 技能更新后如果改了发送目标网站，会显示 **需重新确认**，确认前不会自动发送。
- 不想继续使用时，在连接界面点 **断开连接**，会删除已保存的字段。

## Skill 的接口密钥

Skill 需要调用外部 API 时，把 Token 保存到 **助手 → 编辑助手 → 提示词 → 变量**，在 Skill 中只记录变量名和接口鉴权方式。同一个 Skill 给不同助手使用时，每个助手使用自己的变量。

调用接口时启用 **网络请求**，使用 `http_request` 的 `credential_env` 指定变量名、`url` 指定真实 HTTPS 接口地址；应用读取当前助手的变量并附加到请求头。`credential_header` 默认为 Authorization，`credential_prefix` 默认为“Bearer ”（末尾有空格）；按接口要求设置，自定义请求头直接传密钥时将前缀设为空字符串。不要把 Token 写进 Skill、聊天正文或脚本。

## 旧技能提示 process.env 为空怎么办？

代码工作台不会注入助手环境变量。旧技能要求读取 `process.env.ZHIHU_ACCESS_SECRET` 等变量时，应将其请求步骤迁移到上述宿主凭据代用；可先用 `assistant_env list` 核对变量名，无需用 get 将值返回给模型，也无需重新在对话中输入凭证。环境变量工具的开关不会改变脚本的 process.env。

`getLocalSecret` 不用于读取助手变量，不要尝试猜测 CUBEKEY 编号。若接口需要用密钥进行签名计算或放入请求体，当前请求头代用方式不能直接替代，需要技能作者适配受支持的鉴权链路。

## 本轮指定技能

技能多、名字相近时，可以在输入框用 **/** 或 **＋ → 技能** 直接指定这一条消息用哪个技能，见「怎么让 AI 直接用某个文件或技能？」。

## 注意事项

技能能力依赖当前模型的工具调用能力和指令遵循程度。没有指定技能时，模型要先调用 `use_skill` 才会读取技能正文；描述相近的技能可能被选错，这时用上面的方式直接指定。