自动化

自动化用于把重复发生的工作交给 HiFox 定期或按事件触发。

你可以把自动化理解成一条规则：什么时候触发、让谁执行、执行什么指令、结果写到哪里。它适合处理周期性检查、固定提醒、任务分诊、状态跟进、外部系统事件响应等工作。

自动化适合用来做什么？

自动化适合处理重复、明确、可以被规则触发的工作，例如：

每天早上让 Agent 总结空间里的阻塞任务；

每周生成一次项目进度汇总；

当任务进入某个状态时，让 Agent 做初步检查；

当评论里出现 /triage 时，触发 Agent 做分诊；

接收 GitHub、GitLab、CI 或其他系统的 Webhook，创建或更新任务；

定期检查失败测试、过期任务、未分配任务或等待人工回复的任务。

如果一件事需要人反复提醒、反复筛选、反复让 Agent 执行同一套步骤，就适合做成自动化。

自动化属于空间

自动化是按空间管理的。它通常围绕某个空间里的任务、成员、项目和 Agent 工作流运行。

这样做的好处是：

自动化只影响明确的工作范围；

空间成员可以理解它为什么存在；

运行结果更容易回到对应空间的任务里；

不同空间可以有不同的自动化规则。

例如，研发空间可以有“每日检查阻塞任务”的自动化，客户支持空间可以有“新客户反馈自动分诊”的自动化。

自动化由什么组成？

一个自动化通常包含这些信息：

名称：说明这条自动化要做什么；

Agent 或小队：负责执行的对象；

指令（Instruction）：Agent 每次运行时要读取的步骤、规则和预期输出；

触发器：什么时候启动自动化；

处理人：自动化创建任务或需要跟进时的负责人；

项目：自动化创建或关联任务时所属的项目；

状态：启用、暂停或归档；

运行历史：每次运行的结果、错误和关联任务。

指令是什么？

指令（Instruction）是给 Agent 的执行说明。

它应该写清楚：

目标：这条自动化要完成什么；

上下文：它服务哪个空间、项目或流程；

步骤：Agent 每次运行应该按什么顺序检查和处理；

输出：运行后应该创建任务、写评论、总结结果，还是只记录运行状态；

约束：哪些事情不要做，哪些情况需要等待人工确认。

例如，一个“每日阻塞任务检查”的指令可以写：

检查当前空间中状态为 Blocked 或等待人工回复的任务。总结每个任务阻塞原因、建议下一步和负责人。不要直接修改任务状态；把结果写入自动化创建的任务评论中。

指令越清楚，Agent 每次运行越稳定。

触发器类型

自动化可以通过不同方式启动。

时间表

时间表适合周期性工作，例如每小时、每天、工作日、每周或自定义 cron。

常见例子：

每个工作日上午 9 点生成今日待处理任务；

每周一检查项目进度；

每小时检查是否有失败任务需要关注。

任务状态变化

当任务移动到某个状态时，可以触发自动化。

例如：

任务进入 In Review 时，让 Agent 做一次检查；

任务进入 Blocked 时，让 Agent 总结阻塞原因；

任务进入 Done 时，让 Agent 补充验收说明。

这类自动化适合围绕工作流节点运行。

评论关键词

当任务评论中出现指定关键词或命令时，可以触发自动化。

例如在评论里输入：

/triage：让 Agent 做分诊；

/summarize：让 Agent 总结当前任务；

ready for agent：让 Agent 判断任务是否可以开始执行。

评论关键词适合半自动场景：人决定何时触发，Agent 执行固定流程。

Webhook

Webhook 适合让外部系统触发 HiFox 自动化。

例如 GitHub、GitLab、CI、监控系统或内部服务可以向 HiFox 的私密 Webhook URL 发送请求，触发自动化运行。

Webhook URL 是私密入口。不要公开分享，也不要提交到公开代码仓库。创建后应立即复制并妥善保存；如果泄露，可以重新生成。

创建自动化

创建自动化的一般流程是：

选择所在空间；

创建自动化并填写名称；

选择执行的 Agent 或小队；

编写指令；

选择触发器，例如时间表、任务状态、评论关键词或 Webhook；

如有需要，设置处理人和项目；

保存后先手动运行一次，检查结果是否符合预期。

第一次创建自动化时，建议从低风险场景开始，例如“每天总结阻塞任务”或“评论 /triage 时做任务分诊”。不要一开始就让自动化直接执行高风险修改。

运行历史和健康度

自动化详情页会显示运行历史和健康度。

常见运行状态包括：

已创建任务：自动化创建了关联任务；

运行中：Agent 正在工作；

已完成：最近一次运行成功；

失败：运行遇到错误；

已跳过：本次触发没有执行，通常会有跳过原因。

健康度可以帮助你判断自动化是否需要关注。例如上次运行失败时，自动化会显示需要关注；暂停或归档的自动化不会继续计划运行。

暂停、恢复和归档

如果暂时不想让自动化继续运行，可以暂停它。暂停后，计划运行会停止，直到你恢复。

如果自动化已经不再使用，可以归档或删除。删除会移除自动化、触发器和运行历史，通常不可撤销。

在删除前，先确认团队是否仍然依赖这个自动化，以及是否还有需要保留的运行结果或关联任务。

自动化和任务的关系

建议让自动化尽量产出可追踪的任务或评论，而不是只在后台静默运行。

这样做有几个好处：

团队能看到自动化为什么运行；

Agent 的输出会留在任务上下文里；

后续成员或 Agent 可以基于已有结果继续处理。

对于高风险工作，推荐自动化先创建任务，再由 Agent 在任务里执行，而不是直接在后台完成所有操作。

常见问题

自动化会自动重试失败运行吗？

不要默认依赖自动重试。失败后应先查看运行历史和错误原因，再决定是否手动运行、修改指令、调整触发器或修复 Agent / 机器配置。

一个自动化可以有多个触发器吗？

可以。一个自动化可以通过多个触发器启动，例如同时支持每天定时运行和评论关键词触发。

自动化适合直接改代码吗？

不建议一开始就这样做。更稳妥的方式是让自动化创建任务或写入任务评论，再让 Agent 在明确任务上下文中执行和汇报。

什么时候应该暂停自动化？

当自动化连续失败、指令需要调整、相关 Agent 或机器不可用，或者团队暂时不需要这条规则时，可以先暂停。

自动化适合用来做什么？#

自动化属于空间#

自动化由什么组成？#

指令是什么？#

触发器类型#

时间表#

任务状态变化#

评论关键词#

Webhook#

创建自动化#

运行历史和健康度#

暂停、恢复和归档#

自动化和任务的关系#

常见问题#

自动化会自动重试失败运行吗？#

一个自动化可以有多个触发器吗？#

自动化适合直接改代码吗？#

什么时候应该暂停自动化？#