HiFox “技能”是什么？把一个人的提示词手艺变成团队能复用的步骤

每个用上 AI 编程 Agent 的团队里，都有一个开发者的提示词就是好用。他的审查请求回来时，结构和团队喜欢的样子一致。他写测试的指令，第一遍就能写出符合内部风格的测试。问他怎么做到的，答案通常是一个草稿文件、一个 dotfiles 仓库，或者每天早上贴进新会话的一段话。这门手艺是真的。问题是它住在哪里。

住在一个人脑子里的提示词手艺，扩不出去，挺不过假期，也不会出现在别人的 Agent 运行里。那个开发者不在，质量就掉。团队从一个 Agent 变成五个，这五个会对工作该怎么做意见不一。

技能是 HiFox 对这个缺口的回答。技能把可复用的指令和配套文件打包给 Agent 的工作，带所有者、范围和明确的权限。如果想先看通用概念，编码 Agent 的技能是什么，那篇讲定义和更广的生态。那篇中文还没发布，这里先不放链接。这篇讲的是 HiFox 里面的工作流。

先说结论

HiFox 里的技能，把可复用的指令和配套文件打包给 Agent 的工作：审查规则、交付清单、写作标准、一套团队流程。你可以从零创建，从支持的公开来源安装一个已发布的技能，导入本地运行时发现的一个，或上传 SKILL.md、.skill 文件或 zip 包。每个技能正好有一个范围：组织、空间或 Agent。范围在创建时选定，之后固定。Agent 通过自己的技能设置绑定有资格的技能。变更作用于之后的运行。编辑权留在创建者、组织所有者和管理员那里。结果是：提示词手艺不再住在一个开发者的 dotfiles 里，而变成共享的、有权限控制的团队基础设施。

提示词手艺有了住处之后，什么变了

一条好提示词和一项技能的差别，不在文字。在文字周围的一切。

草稿文件里的提示词没有所有者，没有读者，也没有生命周期。没人知道它存在。没人能判断 Slack 里找到的那份是不是当前版本。流程变了，也没人对更新它负责。技能三样都有。它属于一个组织。它的范围写明哪些 Agent 可以使用。它的编辑权限写明谁可以改。流程变了，你更新这一次技能，每个绑定了它的 Agent，之后的运行都会带上这个变化。

这就是杠杆论点的缩小版。团队的杠杆不来自打开更多 AI 聊天。它来自分享角色、规则、上下文和工作流。而且因为 Agent 把结果交回任务，一次由技能引导的运行，输出会落在团队可以审查的共享记录上。

进入工作流之前有一条边界。技能不是某条任务的要求。一次性的要求留在任务描述或评论里。如果只有这条任务需要，它是上下文。如果下个月的运行也需要，它是基础设施。

从零创建一项技能

一项技能从三样东西开始：名称、描述和指令。这个拆分比看上去更要紧。

描述说明 Agent 什么时候应该使用这项技能。这是触发条件，是告诉正在扫自己能力的 Agent「眼前这份工作用得上它」的那句话。指令定义可重复的过程和预期输出：步骤、检查，以及结果应该长什么样。一个有用的测试是，你能不能用一句话说出 Agent 什么时候该伸手去拿这项技能。如果说不出，你看到的大概是两项技能，或者一项都不是。

底层上，主要指令住在一个 SKILL.md 文件里：顶部是 YAML 的 name 和 description 字段，后面是指令。配套文件可以一起走，提供模板、例子或参考数据。一项交付清单技能可以带上清单模板。一项迁移写作技能可以带上两个带注释的例子。让它们保持聚焦。又大又无关的文件集合会增加上下文，却不会改善 Agent 的决定。

把你已经有的手艺导入进来

多数团队不是从零开始。提示词手艺已经存在，只是散着。HiFox 给你三条导入路径。

从支持的公开来源安装。HiFox 可以取回一个已发布的技能，并在你选定的范围里创建一份受管理的副本。受管理的副本是关键：你不是链到别人的文件，你是拿走一份你的组织控制的快照。绑定到任何 Agent 之前，先审查来源和导入的内容。把外部指令当成第三方代码，而不是可信的组织政策。

从本地运行时导入。这条路径就是为 dotfiles 问题准备的。一个在线的本地运行时可以报告它在本地技能目录里发现的技能。这意味着一个开发者悄悄积累的手艺，对组织变成可见的。导入会把技能复制进组织。原来的本地副本仍然分开，所以那个开发者的环境不会因此坏掉。有一句提醒让这件事保持诚实：Agent 的运行时可以直接使用的本地技能，在产品里根本不需要绑定。只有当它应该变成一项有明确范围、受管理、可复用的技能时，才导入。不是因为它存在就导入。

上传一个包。如果技能住在仓库里，或来自同事，上传 SKILL.md、.skill 文件或 zip 包。HiFox 会校验进来的东西：文件路径必须是相对的，不能跑到技能外面。上传和导入会拒绝隐藏或敏感路径、不支持的二进制内容、不安全的压缩包条目、重复路径，以及超过服务限制的包。技能是 Agent 会遵循的指令。它值得和依赖一样被审视。

范围：决定谁能使用一项技能

每项技能属于一个组织，并且正好有一个范围，在创建时选定。范围决定哪些 Agent 可以绑定它，之后不能改。

文档里的经验法则是对的：选和目标读者匹配的最窄范围。范围也是爆炸半径。一项过时的空间技能，会搞乱一个团队的 Agent。一项过时的组织技能，会搞乱所有人的。dotfiles 里的提示词，读者永远是一个人。技能的读者是一个刻意的决定，记在系统里。

把技能绑到 Agent

技能在被 Agent 带上之前什么都不做。在 HiFox 里，Agent 是一份保存下来的工作配置。绑定一项技能，就是给它加上一项能力。Agent 那篇中文还没发布，这里先不放链接。

机制很小。用 Agent 的技能设置添加或移除有资格的技能，或在创建 Agent 时选择技能。资格遵循范围规则。变更作用于之后的 Agent 运行。所以你今天加上的绑定，塑造的是明天的工作，不打扰正在进行的任何事。

需要判断的是一个 Agent 该带多少技能。文档说得很直：不要绑定很多互相重叠的技能，因为冲突或冗余的指令会让执行更不可预测。两项锋利的技能，好过六项互相吵架的。如果一个 Agent 的技能列表读起来像杂物抽屉，它的运行也会这样。

Agent 自己的指令和它的技能之间，还有分工。Agent 指令承载这一个角色的稳定行为：范围、什么时候向人提问、汇报格式。几个 Agent 可以共享的可复用步骤，属于技能。当你发现自己把同一段话贴进第三个 Agent 的指令，那段话就该变成一项技能。

绑定才让平台剩下的部分叠加上去。带着你们审查技能的那个 Agent，也是自动化会按日程或状态变化启动的那个。所以一次记下的标准，会出现在没人手动发起的重复运行里。技能也可以用脚本看：CLI 提供 hifox skill list 和 hifox skill view，并可以输出 JSON。自动化那篇中文还没发布，这里先不放链接。

治理：谁编辑，谁删除，谁审查

共享的能力需要共享的控制。这是技能和提示词文件分得最开的地方。

技能可以由创建者，或组织所有者、管理员编辑或删除。空间范围的技能还需要对该空间的写权限。创建或导入 Agent 范围的技能，以及更改 Agent 的技能绑定，需要管理目标 Agent 的权限。没有人能在星期五下午悄悄改写审查标准。

维护遵循同一个「只改一处」的原则。流程变了，更新技能的指令和配套文件，之后的运行会带上新版本。删除是要放慢的操作：它会把这项技能从每一个使用它的 Agent 上拿掉，所以先看当前绑定。

安全规则短，而且不能谈。不要把密码、访问令牌、私钥或其他密钥放进技能指令或配套文件。使用前审查每一个外部或本地导入的技能。命令和例子保持最小权限。更改 Agent 的空间关联或技能内容之后，重新检查绑定，因为资格可能在绑定底下发生变化。

贯穿这些的，仍然是人与 Agent 的约定。Agent 加载技能，遵循过程，把结果交回任务。人决定哪些技能承载团队的权威。技能抬高的是一致性的地板。它不取消审查者。

什么时候不要创建技能

技能是基础设施，基础设施有携带成本。诚实的一对决定是：一次性要求留在任务描述或评论里；同一项能力应该在未来的运行里可用时，才创建技能。

还有几种正确答案是「不要技能」的情况。如果一套步骤住在本地运行时的技能目录里，而且只有那台电脑上的运行需要它，就留在本地。如果两项候选技能在同一个 Agent 上会大量重叠，先合并或磨尖，再绑定任何一个。如果你写不出那句描述，这套过程还不够稳定，先别收进来。

从一套步骤开始

挑一套你们团队反复在做、而且悄悄依赖某一个人的步骤。把它写成一项窄的技能：一个名称，一句说明何时适用的描述，以及定义过程和预期输出的指令。范围设到你们的空间。绑到一个 Agent 上，派给那个 Agent 一条真实任务，读回来的东西。

这就是整条循环。住在一个开发者脑子里的手艺，现在有了名称、范围、所有者，以及一个更新的地方。如果你对平台还生疏，概览那篇说明技能如何和任务、Agent、电脑放在一起，入门那篇把第一次连接从头走到尾。那两篇中文还没发布，这里先不放链接。上面每一条规则的完整说明在 技能文档里。

常见问题

技能和 Agent 的指令有什么区别？

Agent 指令定义一个角色的稳定行为：它的范围、什么时候提问、怎么汇报。技能是几个 Agent 可以共享的可复用步骤，带自己的配套文件和权限。如果一段话正在被复制到多个 Agent 之间，它属于技能。

创建之后能改技能的范围吗？

不能。技能的范围在创建时固定。读者需要变时，在正确的范围创建一项新技能，再重新绑定需要它的 Agent。所以文档建议一开始就选和目标读者匹配的最窄范围。

导入的技能会和来源保持同步吗？

不会。从支持的公开来源安装，会在你选定的范围里创建一份受管理的副本。从本地运行时导入，会把技能复制进组织，原来的本地副本仍然分开。从那以后，你们的组织控制自己的这份副本。

新绑定一项技能，会影响 Agent 正在跑的任务吗？

不会。Agent 技能绑定的变更作用于之后的运行。已经在进行的工作，按它开始时的配置跑完。下一次运行才会带上更新后的技能集合。

从公开来源安装技能安全吗？

可以安全，但要审查。把每一个外部或本地导入的技能当成第三方代码或配置：绑定前读指令和配套文件，命令保持最小权限，绝不让密钥进入技能。HiFox 的上传校验会拒绝不安全的路径和压缩包条目。但这套指令值不值得你们团队信任，判断仍然留在人这里。