自动化
空间自动化目前有两套：
本页只讲自动化助理，不要按工作流来理解这里的触发器和运行历史。
自动化用于把重复发生的工作交给 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 或电脑不可用，或者团队暂时不需要这条规则时，可以先暂停。