#Skill

Skill 用来把团队可复用的指令沉淀下来，绑定给 Agent 使用。

如果一段要求只针对某个任务，直接写在任务描述或评论里即可。如果同一套要求会反复给不同任务或不同 Agent 使用，就适合整理成 Skill。

#创建或导入 Skill

在 Skill 或 Agent 设置中点击统一的 + 添加 Skills，再选择来源。可用方式包括：

• 从空间 Skill 选择：选择当前 Agent 所属空间中、当前成员有权限使用的 Skill；这是绑定已有 Skill，不会复制出新的 Skill；
• 手动创建：从空白 Skill 开始填写名称、描述和指令；
• 上传文件或文件夹：上传 SKILL.md、.skill 文件、zip 包，或包含这些文件的文件夹；
• 从 URL 导入：从支持的公开来源导入 Skill；
• 从 Runtime 导入：从所选电脑和 Runtime 发现的本地 Skill 中选择并导入。

通过 URL、Runtime 或文件导入的 Skill 会成为 HiFox 管理的副本，后续与原始 URL、本地文件或本地目录相互独立。导入公开或本地 Skill 后，建议先检查内容，确认它符合团队的安全要求和工作方式，再绑定给 Agent。

有效的 Skill 通常以 SKILL.md 为入口，包含名称、描述和指令；zip 包或文件夹还可以包含模板、示例和其他辅助文本文件。文件路径应使用相对路径，不要包含密钥、token 或其他敏感凭据。上传和导入会拒绝隐藏或敏感路径、不支持的二进制内容、不安全的压缩包条目、重复路径以及超过服务限制的包。

#绑定 Skill 到 Agent

Skill 创建或导入后，需要绑定到 Agent，Agent 才会在 任务执行 中使用它。

你可以在创建 Agent 时选择 Skill，也可以之后在 Agent 设置中添加或移除 Skill。

建议按职责绑定：

• 前端修复 Agent：绑定前端规范、组件测试、UI 文案流程；
• 文档 Agent：绑定文档风格、术语表、发布说明模板；
• Review Agent：绑定代码 review 清单、安全检查规则；
• 项目助理 Agent：绑定周报、项目总结、风险识别模板。

不要给一个 Agent 绑定太多无关 Skill。Skill 太多会增加上下文噪音，让 Agent 更难判断该按哪套流程执行。

#编辑和维护 Skill

当团队流程变化时，应该更新对应 Skill。例如：

• 测试命令变了；
• 文档风格改了；
• 发布检查清单新增了步骤；
• 团队决定换一种 code review 口径；
• 某个 Skill 的输出格式不再适合当前工作。

更新 Skill 后，绑定它的 Agent 会在后续任务中使用新的内容。

#权限和删除

Skill 可能是只读的，也可能只有创建者或组织管理员可以编辑。

如果你不能编辑某个 Skill，通常是因为你不是创建者，也不是组织管理员。

删除 Skill 前，先确认是否有 Agent 正在使用它。删除后，依赖它的 Agent 将不再获得这部分指令和资料。

#注意事项

• Skill 不应该保存密钥、token 或敏感凭据；敏感信息应该放在密钥配置中。
• Skill 应该描述可复用的工作方式，而不是某个单次任务的具体要求。
• Skill 的描述要写清楚适用场景，方便 Agent 判断什么时候使用。
• 从外部 URL 安装的 Skill，使用前应先 review 内容。