跳到主要内容

Skills

Skill 是可复用的任务说明包,以 SKILL.md 为入口,并可带配套文件。Dashboard → Skills 管理当前 Profile 的清单;切换 Profile 后,目录和启用状态随之改变。

安装一个本地 ZIP​

先读清包内说明,尤其是命令、外部下载和凭据要求,再选择 Install Skill 上传 .zip。归档只能装一个 Skill,支持两种布局:

  • 归档根目录直接放 SKILL.md 和支持文件;
  • 只放一个 Skill 目录,在其中放 SKILL.md 和支持文件。

SKILL.md 的 name 只能由小写字母、数字和连接它们的单个连字符组成,最长 64 字符,例如 weekly-report;名称不能是路径。有外层目录时建议使用同名目录。

整个上传请求(包括 multipart 开销)最多 10 MiB;ZIP 文件和解压内容也分别受 10 MiB 上限约束。Anyy 在暂存区验证,拒绝越界路径、Symlink、特殊文件及无效名称。归档结构检查不能替你判断指令是否可信。

服务会检查所选 Profile 的上传 ID、SHA-256 与有效期,再写入托管库并重载目录。同名托管 Skill 会被替换。安装只支持本地 ZIP,不支持 GitHub 地址、远程 URL、本地目录或集合安装;已有记录的历史来源仍可显示。

检查是否安装并生效​

  1. 回到清单,打开安装的 Skill。
  2. 核对名称、描述、来源、托管状态、文件路径和正文。
  3. 检查启用状态;替换曾被停用的 Skill,不表示自动重新启用。
  4. 在同一 Profile 的下一条对话中要求使用它。

非 System Skill 可以切换启用/停用。停用只影响正常解析,不删除文件。详情页也显示 Scope、停用原因和关联支持文件,方便检查实际内容。

来源标签表示记录的来处:System 随版本提供,不能在页面关闭或移除;User Installed 位于 Profile 托管库;Agent Created 表示由 Agent 托管流程创建的已有记录。

对话和页面使用同一份库​

可以给 Anyy 主机可访问的可信 ZIP 路径,要求它安装。当前对话提供 skill_manage 时,会写入这个 Profile 的托管库;刷新页面即可检查结果。该工具不负责切换启用状态,应在页面另行核对。

反过来,页面安装完成后,新提示词可以发现重载后的目录,再用 read/bash(也可以经 Codemode)读取入口。已接纳或正在运行的提示词不会被重载替换。若缺少 reader,模型不会获得 Skill 目录。

对话修改通常也自动重载;显式 reload:false 会跳过。看到 reload_error 时,不能把包已保存当成运行时已刷新,应先修复并重载。外部直接修改文件后也需要重载。TUI 可用 /skills、Dashboard Chat 可用 / 浏览当前界面目录;无需仅为了刷新运行时而强制新建会话。

删除和回滚​

托管 Skill 详情页的删除 Skill会移除包并重载,System Skill 不能删除。要回到历史托管版本,使用 CLI:

anyy skills list
anyy skills view weekly-report
anyy skills rollback weekly-report
anyy skills rollback --revision REVISION_ID weekly-report
anyy skills uninstall weekly-report
anyy skills reload

不指定版本时回到上一托管版本。普通文件修改不自动生成这些包版本。

从 CLI 安装​

anyy skills install ./weekly-report.zip
anyy skills install --force ./weekly-report.zip

CLI 优先通过该 Profile 的常驻 RPC 修改,并由常驻服务重载。没有常驻所有者时,才允许取得独占所有权后离线修改;文件在下次启动时被发现。--now 会在离线修改后尝试请求 Gateway reload,没有可达服务时会报告失败。--json 可用于读取结构化结果。

安装失败先检查 Profile、ZIP 名称、单包结构和大小。若页面已存在但对话不能用,应检查启用状态、重载结果和 reader,而不只看安装成功提示。进一步用法见 Skills 系统;Skill 不会授予额外工具或系统权限。