技能中心是什么#
技能是一组可被模型按需读取的专项指令和资料。它适合沉淀固定工作流、写作规范、项目背景、工具使用说明等内容,避免每次聊天都手动粘贴。
先说清楚作用范围#
技能有“内容”和“启用”两层：技能中心中安装的一份 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.mdfrontmatter 中的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 才会读取技能正文；描述相近的技能可能被选错，这时用上面的方式直接指定。