HiFox 里的 Agent:一份可以检查、可以复用的工作配置

Agent 不是一句提示词,也不是执行主机。指令、电脑、运行时、技能、仓库和运行设置决定它怎么工作。结果回到任务上,由人审查。

Jamie

Jamie

2026-10-27

HiFox 里的 Agent:一份可以检查、可以复用的工作配置

没有人因为一份简历就信任新同事。信任来自结构:责任有边界,工作发生在团队看得见的地方,任何东西发布之前都有审查。拿掉其中任何一条,再聪明的同事也会变成负担。把 AI Agent 当成同事,也是一样。问题从来不是「模型够不够聪明」。问题是「我知不知道它被允许碰什么,我能不能看见它做了什么,有没有什么东西会在没有人说可以的时候发出去」。

HiFox 用配置回答这件事,而不是用承诺。HiFox 里的 Agent 是一份保存下来的工作配置,不是一句用过即弃的提示词。它的指令、运行时、技能、仓库、环境和运行设置,决定它怎么处理工作。终端关上,提示词就没了。配置可以检查、可以分享,而且每一次运行都稳定。

如果想先看平台概览,从「HiFox 是什么」那篇开始再回来。那篇中文还没发布,这里先不放链接。

先说结论

HiFox 里的 Agent,是为一个 AI 执行者保存下来、可以反复使用的工作配置:操作指令、电脑和运行时的绑定、挂上的技能、Git 仓库、环境变量,以及并发、超时、工作目录模式这类运行设置。你信任它的方式,和信任同事一样,靠结构而不是靠信念:范围写在配置里,执行状态和轨迹看得见,结果回到任务上,由人审查并接受。Agent 调研、执行、测试并汇报。人定方向、授权,并接受结果。

Agent 是什么,不是什么

Agent 是配置来在 HiFox 里处理工作的 AI 执行者。它可以接收被指派的任务、写评论、按可用的工作流更新任务状态,并留下执行轨迹。因为配置是保存下来的,团队可以为改代码、审查、测试、文档或运维分拣各自维护 Agent,而不必每条任务都重写同一套指令。

有两条边界要先说清楚。

Agent 不是执行主机。它的工作通过已连接电脑上选定的运行时来跑。Agent 定义工作应该怎么处理。电脑提供主机。运行时执行真正的会话。任务仍然是共享记录。每个角色只做一件事,所以一台电脑可以服务多个 Agent。

Agent 不自己挑模型。它跟随运行时的默认模型。Agent 上没有模型选择器,也没有思考深度控制。要换模型,到运行时或电脑上的工具配置里改,例如在 Claude Code 或 Codex 自己里面改。

信任是系统的属性,不是模型的属性

这篇文章站在这个论点上:一个 Agent 值得信任,是因为它的工作有范围、看得见、可以审查。不是因为模型令人印象深刻。

有范围,是指它跑起来之前,权限已经写下来:能碰哪些仓库,在哪台电脑上执行,指令允许什么,一次可以跑几条任务,一次运行可以持续多久。看得见,是指运行状态、轨迹事件和结果回到任务上,任何人都能检查,而不是消失在私人终端里。可以审查,是指人坐在循环的尽头:Agent 可以把任务留在等待人回复或等待人审查,这些信号会进到负责人的收件箱。

这就是实践里的人与 Agent 约定。自动化停在需要团队判断的地方。如果你还在权衡工作流本身,关于从提示到指派的那篇入门还没发布中文,这里先不放链接。

Agent 的配置面

一个 Agent 可以包含名称、描述、头像和所有者;操作指令;可见性和所在空间;电脑连接和运行时;指派的技能;Agent 自己的 Git 仓库;普通和密钥环境变量;额外的运行时参数;任务工作目录设置;以及并行任务上限和单条任务超时。每一项都是信任的杠杆。

指令会进入每一次运行。用它写应该对每条任务都成立的行为:范围和角色,行动前如何检查任务,什么时候向人提问,期望的检查,以及汇报格式。文档里有一条有用的三分法:只属于这条任务的要求,写在任务描述或评论里;多个 Agent 可以共享的可复用步骤,写成技能;Agent 自己的指令,承载它稳定的身份。「行动前读完任务描述和最近的评论。改动限制在被要求的行为上。跑最接近的相关检查,失败了就报告,不要藏起来。」这句话属于 Agent,因为它星期一该成立,到了三月仍然该成立。描述服务的是另一个读者:它告诉人该派什么,指令告诉 Agent 怎么工作。

可见性可以是个人,只有当前所有者能用;也可以是空间,能访问这个 Agent 所在空间的人都能用。它也决定谁可以指派这个 Agent、和它开始 Agent 对话,或通过评论、提及触发它。调的时候先用个人。配置值得分享时,再改成空间。这一次提升,就是一个开发者的工作方法变成团队基础设施的时刻。

电脑和运行时合在一起,才是执行目标。电脑在线只说明它的本地服务在发心跳,不说明选定的运行时就能执行任务。电脑离线时,新的运行通常会等它重新连上。选定的运行时不在了,就另选一个可用的。电脑那篇中文还没发布,这里先不放链接。

技能把可复用的指令和配套文件打包:审查规则、交付清单、一套团队流程。这台电脑上的本地运行时技能会自动可用。空间里共享的技能必须显式指派。有一句值得重复的提醒:不要绑定很多互相重叠的技能,冲突的指令会让执行更不可预测。技能那篇中文还没发布,这里先不放链接。

仓库是你手上最干净的范围杠杆。当 Agent 需要比空间默认更窄的代码范围时,把仓库绑到 Agent 上。没有绑定的话,HiFox 会退回到这条任务所在空间配置的仓库。一个只绑了文档仓库的文档 Agent,没有路径通向你们的支付服务。

环境和运行设置限制一次运行能消耗什么。普通和密钥环境变量,再加上额外的运行时参数,让运行可以带上配置,而不必有人把凭据贴进任务。不要把仓库令牌、私钥或安装令牌写进任务描述、评论、Agent 指令或技能。任务运行设置控制并行任务、最长运行时间和工作目录模式:

临时目录指定目录
一次运行得到什么每条任务一个隔离目录;带仓库的运行可以准备一份新的 worktree从 Agent 的目录池里取一个已配置的本地绝对路径
并发更安全的并行;默认是电脑上限的 50%每个目录一次只跑一个;默认数量和目录数一致
可用范围任何已连接的电脑仅本地电脑
适合大多数仓库工作,以及多条任务可能同时改同一套代码的时候非常大的仓库、昂贵的本地缓存,或绑定本地服务的任务

如果手动把并发设得比目录数更高,产品会警告写入可能碰撞。隔离机制是另一篇的主题:多个 Agent 并行为什么不会改到同一份文件。那篇中文还没发布,这里先不放链接。

对话和任务:两个表面,一条规则

Agent 对话是一段独立对话,用来提问、调查一个题目,或在任何东西需要变成可跟踪的任务之前,把计划成形。对话有三种模式:探索,只读调查;计划,你审查并确认提案之后,HiFox 才创建计划中的任务和子任务;执行,通过 Agent 配置的命令行直接行动。每次会话属于创建它的人。

当工作需要所有者、状态、执行历史或审查时,它应该变成任务。这一对决定是:工作还不需要被跟踪时,用对话来探索、计划或行动;工作需要处理人、状态、验收标准或一份可长期保留的记录时,用任务。

有一条边界让团队不丢上下文。在 Agent 对话里发消息,不会变成任务评论。任务里 Agent 对话中的消息,也不会作为评论出现在动态里。如果团队需要看见一个结论,把它抄进任务描述或一条评论。信任依赖共享记录,共享记录就是任务。

状态在告诉你什么

这里的可见,是一组你可以读的具体状态,不是仪表盘上的口号。

一次任务运行会经过排队、已派出、等待本地目录、运行中、已完成、失败和已取消。运行状态和任务的工作流状态是分开的:一次运行可以失败,而任务仍然开着,等下一次尝试。执行日志记录为什么排队、何时开始和结束、工具调用和运行时事件、触发来源,以及失败细节。

Agent 是否可用,是第三个、分开的信号。一个在线的 Agent 仍然可能有排队的工作,因为并发或目录容量满了。待办则是停车场:派给 Agent 的任务如果还在待办里,就会等着。把它移到可以开工的状态,运行才会开始。指派 Agent 从来不会突然把工作点着。

你的第一个 Agent:一条你可以信任的走法

建立信任最快的办法,是文档里那个最小的有用循环:接上一台电脑,创建一个 Agent,派一条风险不高的任务。文档见 Agent 文档。

  1. 连接一台电脑。打开设置,然后是电脑,选择连接电脑。等到它显示已连接,并且至少有一个可用的运行时。
  2. 用一个窄角色创建 Agent。名称:代码阅读者。描述:阅读仓库,解释当前实现,报告风险,不改文件。可见性:个人。
  3. 写下把范围钉死的指令:「行动前读完整条任务和相关评论。范围停在请求之内。第一条任务不要改文件。报告你检查了什么、每个结论的证据,以及仍然不确定的地方。」
  4. 绑上代码。挂一个 Git 仓库,或配置一个已经放着这份代码的指定本地目录。技能可以以后再说。
  5. 建一条小的、纯文字的任务:审查认证错误路径,找出三个用户能看见的失败情况,每个都引用相关文件,什么都不要改。
  6. 指派并开始。用一个可以开工的状态,而不是待办。看运行状态从排队到运行中,然后在任务上读结果。
  7. 认真审查。检查 Agent 看的是你要它看的代码,守住了不改文件的边界,给了证据,并且把不确定记下来,而不是猜。

最后这一步就是全部意义。第一条只读任务,让 Agent 在握有任何权限之前先挣到授权。循环走通之后,再有意地放宽范围。怎么派第一条任务,那篇中文还没发布,这里先不放链接。

如果一个 Agent 不再配得上这份信任,撤销是干净的。归档会把它从指派和提及里拿掉,并取消它正在跑的工作,而它以前的任务、评论和运行历史仍然在。一个你能让它离岗、又不丢掉工作记录的同事,才是你负担得起让它入职的同事。

常见问题

HiFox 里的 Agent 到底是什么?

Agent 是配置来在 HiFox 里处理工作的 AI 执行者:一份保存下来的配置,包含指令、电脑和运行时绑定、技能、仓库、环境变量和运行设置。它可以接收被指派的任务、写评论、更新任务状态,并留下执行轨迹。因为配置是保存下来的,Agent 共享到空间之后,一个人的工作方法就可以被反复使用。

HiFox 的 Agent 用哪个模型?

Agent 跟随所选运行时的默认模型,例如 Claude Code 或 Codex,不展示、也不承诺某个具体模型名。Agent 上没有模型选择器,也没有思考深度控制。要换模型,去改运行时或电脑上的工具配置。

和 Agent 聊天,与给它派任务,有什么区别?

Agent 对话是一段独立对话,用来在工作还不需要被跟踪之前探索、计划或行动。任务是共享的工作单位,有处理人、状态、执行历史和审查。聊天消息不会变成任务评论,所以团队要看见的结论属于任务。

怎么限制 Agent 能做什么?

范围设在配置里:指令定义角色和谨慎规则,仓库绑定限制它能看见的代码,任务运行设置封顶并行任务和运行时长。临时工作目录模式给每条任务自己的目录,再加上隔离。最终接受仍然属于人。

为什么我派出去的任务没有开始?

查三件事。待办里的任务按设计会等着,把它移到可以开工的状态。电脑在线只说明心跳到了,还要确认选定的运行时显示为可用。在线的 Agent 在并发或指定目录满了的时候,仍然会把工作排进队列。

Explore more

AI Agent 交接:Agent 对 Agent 与对人

AI Agent 交接:Agent 对 Agent 与对人

多 Agent 工作流多半死在交接:产物交出去了,上下文和「轮到谁」没交。把 Agent 对 Agent 设成自动流动,Agent 对人设成停在审阅门,用状态而不是终端消息承接。

2026-11-05

Datasette Agent:从聊天到受控数据应用

Datasette Agent:从聊天到受控数据应用

Datasette Agent 把聊天放在数据页面旁,Apps 把生成的界面留在 Datasette 内。拆解页面同屏、存储查询授权与写入审批,并给出可复核的团队试用步骤。

2026-11-05

Mozilla Otari:Agent 权限、预算与审计

Mozilla Otari:Agent 权限、预算与审计

Otari 把模型与工具授权、预算预留和仓库 hook 检查放到执行链路。本文拆解拦截时点、审计证据与已知边界,给部署团队一套验证步骤。

2026-11-05