自动化
空间自动化目前有两套：
本页只讲自动化助理，不要按工作流来理解这里的触发器和运行历史。
自动化用于把重复发生的工作交给 HiFox 定期或按事件触发。
你可以把自动化理解成一条规则：什么时候触发、让谁执行、执行什么指令、以及如何查看运行结果。它适合处理周期性检查、固定提醒、状态跟进、外部系统事件响应等工作。
自动化适合用来做什么？
自动化适合处理重复、明确、可以被规则触发的工作，例如：
- 每天早上让 Agent 总结空间里的阻塞任务；
- 每周生成一次项目进度汇总；
- 当任务进入某个状态时，让 Agent 做初步检查；
- 当评论里出现指定关键词时，触发 Agent 执行固定流程；
- 接收 GitHub、GitLab、CI 或其他系统的 Webhook，创建或更新任务；
- 定期检查失败测试、过期任务、未分配任务或等待人工回复的任务。
如果一件事需要人反复提醒、反复筛选、反复让 Agent 执行同一套步骤，就适合做成自动化。
自动化属于空间
自动化是按空间管理的。它通常围绕某个空间里的任务、成员、项目和 Agent 工作流运行。
这样做的好处是：
- 自动化只影响明确的工作范围；
- 空间成员可以理解它为什么存在；
- Agent 运行会继承对应空间和项目的上下文；
- 不同空间可以有不同的自动化规则。
例如，研发空间可以有“每日检查阻塞任务”的自动化，客户支持空间可以有“新客户反馈自动检查”的自动化。
自动化由什么组成？
一个自动化通常包含这些信息：
- 名称：说明这条自动化要做什么；
- Agent 或小队：负责执行的对象；
- 指令（Instruction）：Agent 每次运行时要读取的步骤、规则和预期输出；
- 触发器：什么时候启动自动化；
- 项目：为 Agent 运行提供相关项目上下文；
- 状态：启用、暂停或归档；
- 运行历史：每次运行的 Agent Run、结果和错误。
运行结果通知
你可以在自动化设置中选择一名或多名空间成员作为运行结果通知收件人。收件人配置适用于这条自动化的所有触发器；不选择任何人表示关闭这条自动化的运行通知。只有运行进入最终状态后，才会发送一次结果通知，状态包括已完成、失败、已取消和已跳过。
创建自动化并添加触发器，或在已有自动化中新增触发器时，默认把自动化创建者加入运行结果通知接收人；可再添加其他成员。编辑已有触发器时，不改接收人则保留原值；可以改成其他人，也可以清空全部接收人（含创建者）。
一个自动化可以包含多个触发器，每个触发器都可以单独启用或禁用。创建前设置为禁用的触发器，在保存和刷新后仍会保持禁用，不会因为自动化保存而意外启动。运行结果通知仍然属于自动化级别，适用于这条自动化的所有触发器，不会随单个触发器单独配置。
自动化运行结果也会进入收件箱，并按自动化聚合为一行：最新成功结果通常归入“其他”；最新失败、取消或跳过结果归入“重要”。收件人仍需能访问该空间，具体可选成员以页面显示为准。
指令是什么？
指令（Instruction）是给 Agent 的执行说明。
它应该写清楚：
- 目标：这条自动化要完成什么；
- 上下文：它服务哪个空间、项目或流程；
- 步骤：Agent 每次运行应该按什么顺序检查和处理；
- 输出：运行后应该创建任务、写评论、总结结果，还是只记录运行状态；
- 约束：哪些事情不要做，哪些情况需要等待人工确认。
例如，一个“每日阻塞任务检查”的指令可以写：
检查当前空间中状态为 Blocked 或等待人工回复的任务。总结每个任务阻塞原因、建议下一步和处理人。不要直接修改任务状态；把结果记录在本次运行输出中，必要时再写入触发任务的评论。
指令越清楚，Agent 每次运行越稳定。
触发器类型
自动化可以通过不同方式启动。
时间表
时间表适合周期性工作，例如每小时、每天、工作日、每周或自定义 cron。
常见例子：
- 每个工作日上午 9 点生成今日待处理任务；
- 每周一检查项目进度；
- 每小时检查是否有失败任务需要关注。
任务状态变化
当任务移动到某个状态时，可以触发自动化。
例如：
- 任务进入 In Review 时，让 Agent 做一次检查；
- 任务进入 Blocked 时，让 Agent 总结阻塞原因；
- 任务进入 Done 时，让 Agent 补充验收说明。
这类自动化适合围绕工作流节点运行。
评论关键词
当任务评论中出现指定关键词或命令时，可以触发自动化。
例如在评论里输入：
/summarize：让 Agent 总结当前任务；ready for agent：让 Agent 判断任务是否可以开始执行。
评论关键词适合半自动场景：人决定何时触发，Agent 执行固定流程。这是自动化助理的关键词触发，不是空间里的分拣台。
Webhook
Webhook 适合让外部系统触发 HiFox 自动化。
例如 GitHub、GitLab、CI、监控系统或内部服务可以向 HiFox 的私密 Webhook URL 发送请求，触发自动化运行。
Webhook URL 是私密入口。不要公开分享，也不要提交到公开代码仓库。创建后应立即复制并妥善保存；如果泄露，可以重新生成。
创建自动化
创建自动化的一般流程是：
- 选择所在空间；
- 创建自动化并填写名称；
- 选择执行的 Agent 或小队；
- 编写指令；
- 选择触发器，例如时间表、任务状态、评论关键词或 Webhook；
- 如有需要，设置处理人和项目；
- 保存后先手动运行一次，检查结果是否符合预期。
第一次创建自动化时，建议从低风险场景开始，例如“每天总结阻塞任务”或“评论里出现指定关键词时让 Agent 总结任务”。不要一开始就让自动化直接执行高风险修改。
运行历史和健康度
自动化详情页会显示运行历史和健康度。
常见运行状态包括：
- 运行中：Agent 正在工作；
- 已完成：最近一次运行成功；
- 失败：运行遇到错误；
- 已跳过：本次触发没有执行，通常会有跳过原因。
健康度可以帮助你判断自动化是否需要关注。例如上次运行失败时，自动化会显示需要关注；暂停或归档的自动化不会继续计划运行。
暂停、恢复和归档
如果暂时不想让自动化继续运行，可以暂停它。暂停后，计划运行会停止，直到你恢复。
如果自动化已经不再使用，可以归档或删除。删除会移除自动化、触发器和运行历史，通常不可撤销。
在删除前，先确认团队是否仍然依赖这个自动化，以及是否还有需要保留的运行结果。
自动化和任务的关系
自动化触发后会直接创建一次无关联任务的 Agent Run，不会为每次运行自动新建任务。任务状态和评论仍然可以作为触发源；此时触发任务会作为运行上下文提供给 Agent，但任务本身不会反向控制自动化运行状态。
如果工作需要产出任务、评论或其他可追踪记录，请在指令中明确要求 Agent 创建或更新这些内容。这样可以按场景决定输出位置，而不是依赖隐式创建的关联任务。
对于高风险工作，建议要求 Agent 先汇报计划或创建待人工确认的任务，再执行不可逆修改。
常见问题
自动化会自动重试失败运行吗？
不要默认依赖自动重试。失败后应先查看运行历史和错误原因，再决定是否手动运行、修改指令、调整触发器或修复 Agent / 电脑配置。
一个自动化可以有多个触发器吗？
可以。一个自动化可以通过多个触发器启动，例如同时支持每天定时运行和评论关键词触发。
自动化适合直接改代码吗？
不建议一开始就这样做。更稳妥的方式是先让自动化 Agent Run 检查上下文并汇报计划，或在指令中要求 Agent 创建待人工确认的任务，再执行高风险代码修改。
什么时候应该暂停自动化？
当自动化连续失败、指令需要调整、相关 Agent 或电脑不可用，或者团队暂时不需要这条规则时，可以先暂停。