Skills 系统

重复工作可以整理为 Skill：SKILL.md 说明适用任务和步骤，支持文件按需读取。它使用当前会话已有工具，不会额外获得操作系统权限。安装前先核对命令、外部服务、凭据和关联文件。

准备和安装包

Anyy 只接受一个本地 .zip 包，不直接安装 GitHub 地址、远程 URL、本地目录或集合，也没有 --all。ZIP 中放一个 Skill，可以直接放入口与支持文件，或使用单个外层目录。

入口的 name 最长 64 字符，只能用小写字母、数字以及连接它们的单个连字符，例如 invoice-check。不能把路径作为名称；外层目录建议与名称一致。ZIP 和解压后的总内容各不超过 10 MiB，Dashboard 整个 multipart 请求也不能超过 10 MiB。无效名称、越界路径、Symlink、特殊文件和多个 Skill 都会被拒绝。

anyy skills install ./invoice-check.zip

替换同名托管包才使用 --force。也可以从 Dashboard → Skills → Install Skill 上传，或者把 Anyy 主机可读的 ZIP 路径交给具备 skill_manage 的对话。三种入口写当前 Profile 的同一份托管库；历史来源标签仍可显示，但不能用来重新启用旧远程安装入口。已有本地发现与只读外部根目录是加载能力，不是目录安装。

安装之后确认两端都能使用

页面安装后，检查 Skill 详情的正文、来源、路径及启用状态；替换停用的包不会自动重新启用。随后在同一 Profile 发一条新提示词，例如：

按 invoice-check Skill 检查这份账单；先读说明，再告诉我需要哪些输入。

对话安装也应回到页面检查实际记录，不能只依据成功回复。CLI 常驻 RPC 和 Dashboard 修改会重载目录；对话 skill_manage 默认也重载，但 reload:false 会跳过，reload_error 表示保存与刷新没有全部成功。

离线 CLI 修改仅在没有常驻所有者、取得独占 Profile 所有权后执行，文件在下次启动时被发现。--now 是离线修改后请求 Gateway reload，没有可达 Gateway 时会报告失败。

模型怎样读取 Skill

目录给出入口位置，模型用选中的 read 或 bash 按需读取，支持文件的相对引用以入口目录为基准。reader 经 Codemode 可达时仍保留目录；两种 reader 都不可用时，不向模型提供 Skill 目录。没有独立的 skills_list／skill_view 模型工具。

显式 /skill:NAME 为该次提交展开指定 Skill。已识别入口若读不到或解析失败，消息仍会被接纳并交给模型，同时产生非致命展开错误通知，通知可能晚于回复开始。投递方式见通知与投递。

目录重载影响后续发现与接纳，不替换已排队、已运行消息或已接纳复盘中的说明和选择。不需要仅为了接收重载而新建会话。

查看、回滚和删除

CLI 可以查看目录、入口及声明的支持文件：

anyy skills list
anyy skills view invoice-check
anyy skills view invoice-check references/rules.md

需要撤销一次托管更新时：

anyy skills rollback invoice-check
anyy skills rollback --revision REVISION_ID invoice-check
anyy skills uninstall invoice-check
anyy skills reload

不指定 revision 就回到上一托管版本。--json 输出结构化结果；--now 的含义同上。Dashboard 可以启用／停用非 System Skill，也可以移除托管包；停用不删除文件。

托管 Skill 更新

skill_manage 能安装、创建、修改、删除托管文件以及回滚，并保存包版本。普通文件编辑不自动取得这一版本保证。内置和外部发现的 Skill 对托管 writer 只读；重载、添加外部根目录不会产生包版本。

自动复盘继承父对话的工具选择、排除项与工具组，还需要可用托管 writer。接纳时的选择跨重试或重启保持，后来修改父对话不为既有复盘增加工具。只有实际成功的托管结果才触发更新通知；没有可复用学习时可以不改库。

保留原 ZIP 便于复现。个人长期偏好应放 Memory；流程适合 Skill，外部服务连接适合 MCP。页面步骤见 Dashboard Skills。