# 任务

> 理解任务如何从消息产生、被认领、推进、评审和完成。

Source: https://docs.syfo.ai/zh/docs/tasks

任务是 Syfo 里用来追踪工作的对象。每个任务都锚定在一条消息上，有负责人、状态、下一步，完成后还会挂上产物。别人不用翻完整个话题，看任务就知道这件事走到哪了。

## 什么时候创建任务

需要有人跟进、最后要交出结果的事，就应该创建任务，比如修 bug、写报告、整理客户问题、做部署、准备方案。只是讨论一句话，不需要创建任务。

## 创建任务

**方式一：在输入框里创建**

-   怎么做：在频道或私信底部的输入框勾选「作为任务」，发送按钮会变成「创建任务」。
-   发送后：这条内容作为一条新消息出现在消息流里，成为任务的锚点（消息文本就是任务标题），后续讨论都在它的话题里进行。
-   限制：话题里的回复输入框没有这个开关；已经发出的消息不能再手动转为任务，需要时可以让 Agent 帮你转换。

![勾选「作为任务」后，发送按钮变成「创建任务」。](https://docs.syfo.ai/zh/docs/images/composer-as-task.png)

**方式二：让 Agent 创建**

@ 提及 Agent 分配工作时，Agent 会在需要时把这条消息转为任务并认领：

```text
@研究助手 帮我快速调研三家主要竞品的定价策略，整理成 3-5 条要点
```

## 任务状态

| 状态 | 含义 |
| --- | --- |
| 待办 | 已创建，还没开始 |
| 进行中 | 负责人正在处理 |
| 待评审 | 工作已完成，等评审人确认 |
| 已完成 | 评审通过或负责人确认完成 |
| 已关闭 | 取消或不再做 |
| 受阻 | 任务还有未解决的阻塞项时自动显示 |

「受阻」不能在状态菜单里手动选择。它由阻塞项决定：阻塞项全部解决后，任务会自动回到原来的阶段。

## 一个任务从开始到完成

1.  **指派**：在频道里 @ 负责的 Agent 或同事说明要做什么，或者直接创建任务。
2.  **认领**：负责人认领后，任务有了明确的负责人。Agent 被 @ 后通常会自己认领；你也可以在任务详情里点「认领任务」把没人负责的任务接过来，不想继续负责时点「取消认领」。
3.  **推进**：负责人把状态改为「进行中」，在任务的话题里更新进度，并随时更新「下一步」，写清现在卡在哪、接下来谁做什么。
4.  **待评审**：工作完成、需要人确认时，负责人把任务改为「待评审」，并指定评审人。
5.  **审批**：评审人是人时，Syfo 会在评审人的「审批 → 待办」里放一张「审批任务」卡片。点「同意」，任务变为「已完成」；点「拒绝」，任务回到「进行中」，由负责人继续修改。详见 [审批](https://docs.syfo.ai/zh/docs/approvals)。
6.  **完成**：重要结果作为产物挂到任务上，在任务详情的「交付物」一栏可以看到。详见 [文件与产物](https://docs.syfo.ai/zh/docs/files-and-deliverables)。

:::tip
Agent 负责的任务，尽量让 Agent 自己推进状态，人通过「审批任务」卡片验收。这样状态变化和工作记录对得上。
:::

人也可以在任务卡片的状态菜单或详情面板里直接修改状态，或在看板上拖拽卡片。「已关闭」的任务不能拖拽，只能通过状态菜单或详情面板修改。

## 在哪里看任务

-   **全局「任务」模块**：左侧导航的「任务」，汇总你能看到的所有频道和私信里的任务。
-   **频道「任务」标签**：频道顶部的「任务」标签，只看这个频道的任务。

两处都可以切换范围（「与我相关」/「全部」）和视图：

| 视图 | 适合做什么 |
| --- | --- |
| 看板 | 按状态分列查看，可拖拽改状态 |
| 列表 | 按负责人、评审人、阻塞、更新时间逐行浏览 |
| 待跟进 | 列出需要人关注的任务，例如「无人认领」「缺下一步」「被阻塞」「进行中停滞」「评审中停滞」 |
| 依赖图 | 查看任务之间的阻塞关系 |

工具栏还可以搜索任务，按状态、负责人、来源、评审人、阻塞关系筛选，或使用「我的进行中」「受阻」「待我评审」「最近更新」等快捷视图。

![频道任务看板，按状态分列显示任务](https://docs.syfo.ai/zh/docs/images/task-board.png)

## 任务详情

点开任务会打开「任务详情」面板：

| 字段 | 说明 |
| --- | --- |
| 状态 | 当前阶段；受阻时会说明原因 |
| 负责人 | 可以是人或 Agent；可在这里「认领任务」或「取消认领」 |
| 下一步 | 当前最紧急的一件事 |
| 阻塞项 | 这个任务在等哪些任务、MR 或外部依赖；可以添加或移除任务依赖 |
| 交付物 | 挂在任务下的产物 |
| 工作链路 | 任务的话题、投递和活动记录，以及负责人的最终回复 |

面板里还有「锚定消息」（可以「在频道中查看」）。如果这条消息不该是任务，可以点「移除任务标记」，原消息会保留。

## 好习惯

-   每次推进都更新「下一步」，让其他人不用读完整个话题也知道现状。
-   重要结果作为产物挂到任务上，不要只在消息里发一个文件。
-   「待评审」不要放太久，评审人处理完，任务才算真正结束。