技能
技能用来把团队可复用的指令沉淀下来,绑定给 Agent 使用。
如果一段要求只针对某个任务,直接写在任务描述或评论里即可。如果同一套要求会反复给不同任务或不同 Agent 使用,就适合整理成技能。
创建或导入技能
安装过程中会显示安装中;完成后变为已安装。如果提示需要升级 CLI,按页面指引升级后再试。
在技能或 Agent 设置中点击统一的 + 添加技能,再选择来源。可用方式包括:
- 从空间技能选择:选择当前 Agent 所属空间中、当前成员有权限使用的技能;这是绑定已有技能,不会复制出新的技能;
- 手动创建:从空白技能开始填写名称、描述和指令;
- 上传文件或文件夹:上传
SKILL.md、.skill文件、zip 包,或包含这些文件的文件夹; - 从 URL 导入:从支持的公开来源导入技能;
- 从 Runtime 导入:从所选电脑和 Runtime 发现的本地技能中选择并导入。
电脑离线时添加技能,会提示电脑离线、技能已排队,电脑上线后自动安装,而不是一直显示「等待 CLI」。
通过 URL、Runtime 或文件导入的技能会成为 HiFox 管理的副本,后续与原始 URL、本地文件或本地目录相互独立。导入公开或本地技能后,建议先检查内容,确认它符合团队的安全要求和工作方式,再绑定给 Agent。
有效的技能通常以 SKILL.md 为入口,包含名称、描述和指令;zip 包或文件夹还可以包含模板、示例和其他辅助文本文件。文件路径应使用相对路径,不要包含密钥、token 或其他敏感凭据。上传和导入会拒绝隐藏或敏感路径、不支持的二进制内容、不安全的压缩包条目、重复路径以及超过服务限制的包。
绑定技能到 Agent
技能创建或导入后,需要绑定到 Agent,Agent 才会在 任务执行 中使用它。
你可以在创建 Agent 时选择技能,也可以之后在 Agent 设置中添加或移除技能。
建议按职责绑定:
- 前端修复 Agent:绑定前端规范、组件测试、UI 文案流程;
- 文档 Agent:绑定文档风格、术语表、发布说明模板;
- Review Agent:绑定代码 review 清单、安全检查规则;
- 专项助理 Agent:绑定周报、专项总结、风险识别模板。
不要给一个 Agent 绑定太多无关技能。技能太多会增加上下文噪音,让 Agent 更难判断该按哪套流程执行。
编辑和维护技能
当团队流程变化时,应该更新对应技能。例如:
- 测试命令变了;
- 文档风格改了;
- 发布检查清单新增了步骤;
- 团队决定换一种 code review 口径;
- 某个技能的输出格式不再适合当前工作。
更新技能后,绑定它的 Agent 会在后续任务中使用新的内容。
权限和删除
技能可能是只读的,也可能只有创建者或组织管理员可以编辑。
如果你不能编辑某个技能,通常是因为你不是创建者,也不是组织管理员。
删除技能前,先确认是否有 Agent 正在使用它。删除后,依赖它的 Agent 将不再获得这部分指令和资料。
注意事项
- 技能不应该保存密钥、token 或敏感凭据;敏感信息应该放在密钥配置中。
- 技能应该描述可复用的工作方式,而不是某个单次任务的具体要求。
- 技能的描述要写清楚适用场景,方便 Agent 判断什么时候使用。
- 从外部 URL 安装的技能,使用前应先 review 内容。