#评论和回复

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

#从哪里进入？

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

• 活动：展示任务活动记录、评论和回复；
• 对话：和 Agent 协作的对话记录，和评论不是同一套数据；未指派 Agent 也可以开始聊，见 与 Agent 对话；
• 执行记录：查看 Agent 执行记录。

需要团队都看到的结论，写在评论或任务描述里。任务上的 Agent 对话不会自动变成评论。

#什么时候用评论？

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

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

• 补充新的需求背景、限制条件或验收标准；
• 上传一组新的截图、日志、报错信息或相关文件；
• 给 Agent 一条新的执行指令或反馈；
• 请求成员补充信息、review 或做决定；
• 记录一条新的验收结论，例如“已验证通过”或“还需要处理边界情况”。

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

#什么时候用回复？

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

• 回答某条评论提出的问题；
• 针对某张截图、某段日志继续追问；
• 对同一条 review 意见来回确认；
• 补充某个结论的细节；
• 在 Agent 的某条回复下面继续给反馈。

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

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

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

例如你可以评论：

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

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

#快捷回复

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

• commit 并 push 到 hifox/staging。如果需要 rebase，则 rebase 之后再 push。；
• 打开一个页面让我验收效果；
• 已经验证成功，标记为已完成。清理 worktree。。

评论和回复输入框都可以使用快捷回复。点条目文字会直接作为评论或回复发送。把鼠标移到条目上会出现「插入」；提示是「修改内置的内容后再发送」。点插入只会把内容写入输入框并聚焦，不会发送，改完后再手动发出。

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

#复制评论和对话中的图片

在任务评论或 Agent 对话中打开图片预览后，选择 复制图片，就可以将图片直接粘贴到其他支持图片粘贴的应用中。

如果复制不可用或失败，可以继续使用预览中的下载操作保存图片。

#讨论串和已解决

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

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

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

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

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