#连接飞书：让群聊里的问题真正被推进下去

很多工作，都是从飞书群里的一句话开始的。

有人说线上登录失败，接着发了一张报错截图。产品补充影响范围，开发提到最近改过相关代码，测试又说之前也遇到过类似问题。

几个人聊了十几分钟，最后得出一个结论，需要有人跟进。

然后这件事就停在了群里。

没有明确标题，没有结构化背景，也没有验收标准。几天后有人问进展，大家还要重新翻聊天记录。开发开始以后，代码改到哪一步了、测试有没有跑、还缺什么权限，最早提出问题的人也不清楚。

我们团队使用 HiFox 之后，把 HiFox 连接上飞书，这个问题终于被完美地解决了！

飞书继续作为团队讨论和反馈的入口，HiFox 负责把讨论整理成任务，交给 Agent 执行，再把过程和结果同步回原来的话题。

#HiFox 连接飞书后能做到什么

#把群里的讨论整理成任务

在飞书话题里 @ HiFox Agent，它可以读取当前话题里的上下文，理解问题背景、现象、影响范围和大家已经讨论出的结论。

你不需要先把聊天记录复制出来，再手动粘贴到任务系统。

可以直接让 Agent 把当前讨论整理成一条任务。它会提炼任务标题和正文，把截图、录屏、日志等资料带入任务，并把缺少的信息列出来。

#任务进度自动关联

这是连接飞书最有价值的地方。

任务创建以后，HiFox 会自动关联当前飞书话题。

问题从飞书话题里提出，任务从这个话题产生，开发进展回到这个话题，测试结果也回到这个话题。

原来的讨论不会和任务割裂。飞书里的补充消息会进入任务上下文，HiFox 任务里的进展和评论也可以同步回原来的话题。

#直接让 Agent 推进开发

任务创建以后，可以把它交给 Agent 开发。

Agent 会读取任务标题、描述、评论、附件、代码库和自己的工作指令，然后在电脑上启动 Claude Code、Codex 等 Runtime，进入代码目录，修改文件并运行命令。

产品、开发和测试不需要再把需求复制到不同工具里，所有人都可以从任务里看到当前进度、执行记录、阻塞原因和最终结果。

#让 Agent 自动执行测试

开发完成后，可以让 Agent 运行项目中的测试、lint、类型检查和构建命令。

如果测试失败，Agent 可以记录失败命令、具体用例、错误信息和复现步骤。开发人员继续在原任务里补充意见，Agent 再基于同一份上下文修改和验证。

团队也可以配置自动化，让 Agent 定期检查失败测试，或者在任务进入待验收状态时执行一轮检查。

#如何操作

#第一步，绑定飞书任务助手，并配置执行环境

优先使用系统提供的 飞书任务助手，不必先从 Agent 页新建一个任务助手。需要这个空间有额外习惯时，绑定后可以填写附加提示词，并查看内置提示词；创建的任务仍进入该助手绑定时选择的空间。

打开 外部应用集成 → 飞书，在 任务助手 分组里为当前空间选择 Runtime，再扫码绑定飞书机器人。每个空间只能有一个任务助手。它只在飞书里工作，不会出现在普通 Agent 列表里。

如果你仍想用自己创建的 Agent 处理飞书群里的任务，也可以继续创建飞书智能体。这个 Agent 的职责不是简单地把聊天内容复制进任务，而是把零散讨论整理成一条可以继续推进的工作项。

自建 Agent 的指令可以写成这样：

# 角色

你是一个 HiFox 任务创建助手。根据用户的描述/背景，调用 `HiFox` CLI 创建任务，并自动指派给用户要求的负责人。用户的描述可以是一个 HiFox task id 也可以是具体的需求描述, 如果是一个 task ID，你要用 HiFox cli 来完善补充需求, 不需要新建。

# 工作流程

1. **理解需求**：阅读用户的描述与背景，提炼出一条清晰、可执行的任务。
2. **创建任务**：使用 HiFox CLI 创建任务，创建到 Org 是 {{OrgName}} 这个组织 {{SpaceName}}这个 Space 下
3. **处理附件**（仅当用户提供附件时）：多个视频或图片按编号（如 `01-复现视频.mp4`、`02-报错截图.png`）依次处理，并在正文中保持相同顺序。每个附件必须写明编号、文件名和用途说明。先下载全部附件，创建任务时通过 `--attachment` 上传；创建后通过 `HiFox task view <taskID> --output json` 获取任务自身的 `attachments[].preview.url`。视频作为任务附件，图片还必须使用 `![描述](图片URL)` 嵌入正文对应位置。
4. **订阅任务发起人**（所有任务创建、附件处理和校验均完成后执行）：识别触发本次创建任务的原始飞书消息发送者；如由飞书话题触发，则识别该话题创建者。获取其对应的 HiFox 成员邮箱或成员 ID，执行 `HiFox task subscriber add <任务编号> --user "member:<成员邮箱或成员ID>"`，再执行 `HiFox task subscriber list <任务编号> --output json` 确认该成员已成为任务订阅者。

# 硬性要求

- 用户带图片时，**绝不能**遗漏图片，必须以 Markdown URL 格式嵌入 description。
- 必须按编号顺序下载、上传并在正文中说明全部视频和图片，不得遗漏、错序或混淆。
- 必须通过 `--attachment` 将全部附件上传到目标任务。
- 图片必须使用目标任务自身的 `attachments[].preview.url` 以 Markdown 格式嵌入正文，禁止使用聊天附件原 URL。
- 必须校验附件数量等于用户提供的附件总数，并校验 `taskId`、预览状态、附件顺序和 Markdown 图片数量。
- 任一步失败时回复“已创建”，但需要说明失败的步骤。
- 要按照用户所描述的任务类型创建/更新，比如建bug，需要先理解并匹配到对应的任务类型是缺陷或者Bug，然后--type指定任务类型去创建/更新。
- 创建任务后，如果需要有失败项需要重试，不能重复创建，重试都在已创建的任务中执行修改。

# 回复

- 回复一个任务链接给用户，如:
  - 已创建需求 https://app.hifox.com/orgname/tasks/HF-10000，指派给 xxx

除了指令之外，还需要设定以下这些项：

• 电脑和 Runtime：你需要指定这个 Agent 在哪台电脑上运行。由于飞书任务助理一般需要 24 小时运行，所以最好是一台 24 小时开机的共享机，上面安装 HiFox 和 Claude Code/Codex 等等。

• Git 仓库：为了让 Agent 能正确理解你的任务和问题，最好把你们的代码库配置给 Agent。可以在 HiFox 的空间中配置，也可以在 Agent 上配置。

• Skill、MCP、知识库：视实际需求配置即可。

#第二步，连接飞书

在 HiFox 的组织设置中进入“外部应用集成”，找到“飞书”并绑定刚刚创建的 Agent。

系统会生成二维码。

使用飞书扫码，或者打开二维码里的授权链接，在飞书中完成智能体创建和授权。返回 HiFox，等待连接状态变成已连接。

连接完成后，你可以进入 Agent 的飞书集成设置，确认它响应哪些消息。

研发场景建议先打开私聊和群里被 @。如果需要，也可以配置表情触发或指定群的普通消息触发。

#第三步，在飞书中把讨论变成任务

当群里出现值得跟踪的问题时，在对应话题里 @任务助手。

Agent 会读取当前话题里可访问的消息、图片、引用内容和成员信息。

创建任务时，HiFox 会自动关联当前飞书话题，不需要再手动绑定。如果讨论的是一个已经存在的问题，要告诉 Agent 使用原任务。

后续话题中的新消息会进入任务评论。任务里的过程信息也会同步回原来的话题。大家继续在飞书里讨论，Agent 则从同一条任务中读取完整上下文。

#第四步，关联自己的飞书账号

以上流程都是让飞书可以操作 HiFox，但 HiFox 还没有权限主动把跟你相关的任务变化通知到飞书。这个时候，就需要在 HiFox 中关联你的飞书账号。

方法是在 HiFox 的组织设置中进入“外部应用集成”，找到“飞书”，然后“我的飞书账号”。

绑定了自己的飞书账号之后，飞书机器人就会把跟你相关的各种任务变动通知到飞书了。

#第四步，产品-开发-测试-发布

如果你是负责这个任务的负责人，接下来就可以正式进入开发环节了。

首先，前面提到的 “HiFox 任务助手”会创建一个任务，产品经理可以 review 这个任务和其中的方案，确认是否合适。

其次，这个任务确认之后就可以在 HiFox 中直接进入开发，开发同学可以指派自己的 Agent 来做这个任务。

等到开发完成，进入提测，测试同学可以用自己的 HiFox 测试 Agent 来做白盒和黑盒测试、UI 测试，还可以保留各种测试证据。

关于以上的开发、测试等环节，我们会在另一篇关于开发和测试的最佳实践中写到。

最终，任务负责人完成验收，这个任务就可以上线了。整个所有流程都会同步会最初的飞书话题，所有相关人都可以看到整个流转过程。

#养成任务协作的新习惯

HiFox 连接飞书以后，建议团队形成三个习惯。

第一，所有关于本任务的讨论都在同一个飞书话题下展开。这样，上下文最清楚，Agent 不会遗漏信息。如果沟通散落在群里，Agent 很难区分到底哪些沟通是关于本任务的，就容易遗漏信息。

第二，讨论有初步结果时就创建任务。如果需要一些调研或者数据才能继续，可以先创建任务初稿，然后让负责调研的 Agent 去补充信息，这些过程都会同步到飞书话题里。不要等到信息完整、所有人都达成一致才引入 Agent。

第三，尽量给出充足的上下文。比如用户反馈的原始对话记录、使用截图等等，都同步到飞书话题，这样 Agent 都可以作为后续开发和测试的参考，保证产出质量。

这样，飞书适合快速沟通。HiFox 适合持续推进。

连接起来以后，群里的那句「有人跟一下吗」，就可以变成一条有背景、有负责人、有执行记录、有测试结果的任务。

而且，过程不会消失在聊天记录里。