评论和回复

评论和回复用于把任务过程中的补充信息、问题、反馈和结论留在同一个任务里。成员和 Agent 都可以基于这些上下文继续推进。

从哪里进入？

打开一个任务后，通常可以在任务详情里看到：

活动：展示任务活动记录、评论和回复；

对话：在分配给 Agent 或小队的任务中，更聚焦和 Agent 协作的对话；

执行记录：查看 Agent 执行记录。

普通成员负责或未分配的任务，通常从活动查看评论；分配给 Agent 或小队的任务，也可以在对话中继续协作。

什么时候用评论？

简单来说：一个单独的话题用评论；已有话题的延续用回复。

评论适合开启一个新的讨论话题，例如：

补充新的需求背景、限制条件或验收标准；

上传一组新的截图、日志、报错信息或相关文件；

给 Agent 一条新的执行指令或反馈；

请求成员补充信息、review 或做决定；

记录一条新的验收结论，例如“已验证通过”或“还需要处理边界情况”。

如果这段内容可以独立成为一个话题，或者后来打开任务的人应该单独看到它，就写成一条新评论。

什么时候用回复？

回复适合延续已有评论里的话题，例如：

回答某条评论提出的问题；

针对某张截图、某段日志继续追问；

对同一条 review 意见来回确认；

补充某个结论的细节；

在 Agent 的某条回复下面继续给反馈。

如果内容是在接着某条评论说，就用回复。这样相关讨论会聚在同一个讨论串里，任务评论区不会变得散乱。

最佳实践：先让 Agent 完善一句话需求

如果任务一开始只有一句话需求，不建议直接让 Agent 开始实现。更稳妥的做法是先在评论里让 Agent 补全需求。

例如你可以评论：

先不要改代码。请根据当前任务整理背景、目标、范围、风险和验收标准；如果有不确定的地方，列出需要我确认的问题。

确认 Agent 整理出的内容后，再让 Agent 把稳定结论更新到任务描述里。这样任务描述承载最终目标和验收标准，评论区保留讨论过程和决策记录。

快捷回复

快捷回复适合保存你经常发送的短句或固定反馈，例如：

commit 并 push 到 hifox/staging。如果需要 rebase，则 rebase 之后再 push。；

打开一个页面让我验收效果；

已经验证成功，标记为已完成。清理 worktree。。

评论和回复输入框都可以使用快捷回复。选择一条快捷回复后，会直接作为评论或回复发送。

你也可以在快捷回复入口中新增、编辑、删除和排序。快捷回复按个人保存，不是团队共享内容。

讨论串和已解决

每条顶层评论都可以形成一个讨论串。回复会显示在同一个讨论串里。

当一段讨论已经处理完，可以把顶层评论讨论串标记为已解决。常见场景包括：

Agent 已根据反馈完成修改；

review 意见已经处理；

需要确认的问题已经有结论。

只有顶层评论讨论串可以标记为已解决；单条回复不能单独解决。标记已解决后，讨论串会折叠；如果后续还要继续讨论，可以重新打开。

与 Agent 协作

评论是和 Agent 协作任务时最重要的反馈通道。你可以在评论或回复里：

补充 Agent 继续执行所需的信息；

回答 Agent 的问题；

说明方案是否可接受；

让 Agent 根据反馈继续处理；

@ 某个 Agent，让它参与当前任务。

评论或回复触发 Agent 响应，主要有两条路径。

任务已经指派给 Agent

当任务已经指派给某个 Agent 时，成员的新评论会触发负责人 Agent 继续执行。

为了避免误触发，下面这些情况通常不会触发负责人 Agent：

评论里 @ 了其他成员或其他 Agent，但没有 @ 当前负责人 Agent；

评论里 @all，只是在广播给所有人；

你是在成员发起的讨论串里继续回复，并且没有 @ 当前负责人 Agent；

负责人 Agent 自己发出的评论。

如果一个讨论串本来就是 Agent 发起的，或者顶层评论已经 @ 了负责人 Agent，后续成员回复通常会继续触发它，因为这被视为你在继续和这个 Agent 对话。

评论里 @ Agent

如果你在评论或回复里直接 @ 某个 Agent，HiFox 会尝试让被提及的 Agent 响应当前任务。

这种方式不要求该 Agent 是任务负责人，但仍需要满足基本条件：

被 @ 的 Agent 属于当前组织；

Agent 没有归档，并且有可用运行环境；

你有权限触发这个 Agent；

这个 Agent 当前没有同一个任务的待处理运行。

回复里如果没有新的 @，但它回复的顶层评论已经 @ 了某个 Agent，HiFox 也会把这次回复视为延续对这个 Agent 的讨论，继续尝试触发它。

常见问题

评论会进入 Agent 的上下文吗？

会。Agent 执行任务时会读取任务标题、描述、状态、最近评论和相关配置。重要补充应该写进评论，避免只留在外部聊天中。

可以只用评论，不写任务描述吗？

不建议。任务描述应该承载稳定的目标、背景和验收标准；评论适合承载后续补充、讨论和反馈。

从哪里进入？#

什么时候用评论？#

什么时候用回复？#

最佳实践：先让 Agent 完善一句话需求#

快捷回复#

讨论串和已解决#

与 Agent 协作#

任务已经指派给 Agent#

评论里 @ Agent#

常见问题#

评论会进入 Agent 的上下文吗？#

可以只用评论，不写任务描述吗？#