#评论和回复

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

#从哪里进入？

打开一个 任务 后，任务详情里通常有 动态 和 对话记录 两个 Tab：

• 动态：展示任务活动记录、评论和回复；
• 对话记录：查看这个任务下的所有 Agent 对话。

和 Agent 的对话不占 Tab。它在任务详情右侧面板里打开，和评论不是同一套数据；未指派 Agent 也可以开始聊，见 与 Agent 对话。

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

评论通知和 Agent 对话通知是两套规则：普通评论按任务关注和通知设置发送；Agent 在任务对话里的回复及相关交接提醒按对话发起人定向发送，不会广播给其他关注者。

#什么时候用评论？

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

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

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

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

#什么时候用回复？

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

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

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

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

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

例如你可以评论：

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

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

#快捷回复

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

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

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

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

#在快捷回复中提及 Agent

快捷回复可以保存 Agent 提及。创建或编辑快捷回复时，在编辑器中选择要提及的 Agent；保存后重新打开仍会保留提及。直接发送快捷回复，或先点「插入」将内容写入评论、回复或 Agent 对话编辑器后再发送时，提及会按正常的 Agent 提及规则处理。

只有当前组织、空间和成员权限允许使用的 Agent 才能作为有效提及。Agent 已归档、不可用、属于其他空间或当前成员无权使用时，提及可能降级为普通文本或无法发送；快捷回复不会因此把 Agent 绑定到所有任务。

#快捷回复中的审阅确认

如果任务处于待审状态，成功发送“已审阅，没问题”快捷回复后，HiFox 会自动移除待审标识。列表、任务详情和重新打开任务后都会保持一致。只有消息成功发送且任务确实处于待审状态时，才会触发这个动作。

这只会清除待审标识，不会修改任务的生命周期状态，也不会把任务标记为已完成。

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

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

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

#下载大附件

无法直接预览的大附件应使用下载而不是打开。点击后会显示下载反馈；下载完成后，桌面端会自动打开下载目录并定位或选中文件。下载目录行为取决于操作系统权限和桌面端能力；如果没有自动定位，请到系统下载目录查找。

#长评论

任务动态里过长的评论默认折叠，底部提供 全部展开；展开后同一屏才能看到被挤下去的其他评论。展开后可以 收起。

#附件

在支持上传多个附件的地方，点附件按钮选择文件时可以一次选中多个文件，一起上传，不必一个一个来。

附件在正文里出现时，就是这条内容的一部分。移出和永久删除是两件事：

• 从正文移出：能编辑任务说明的成员都可以移出正文里的附件，包括用退格或删除键去掉。移出只去掉正文里的引用，文件保留在任务的独立附件区，正文保存也不会因此失败。
• 永久删除：只有附件的上传者和组织管理员可以永久删除文件。没有权限时，删除入口不可用，键盘移除和移出都按「从正文移出」处理。

如果只是不想放在正文里、但文件还要留着，使用 从任务说明移出 或 从评论内容移出。移出后出现在独立附件区；再插入内容后，独立附件卡消失。

评论附件保持原有语义：从评论正文里删除附件并保存，会永久删除该文件。

独立附件删除仍需确认，确认后永久删除。图片、视频和普通文件使用同一套删除 / 移出语义；预览方式可以不同。

评论进入编辑后，这条评论上还未被当前草稿引用的附件仍显示为独立附件，可以插入、移出或删除。

把评论正文全部删空并保存时：

• 若这条评论已经没有任何附件，会询问是否 删除评论（不要默默把原文还原）；
• 若还留着评论级独立附件，则保留这条只有附件的评论。

任务说明里：单击选中附件节点，双击预览。评论只读正文：单击预览。本节不涵盖对话附件。

#分享任务中的评论

在动态中，可以从评论或回复的分享入口进入选择模式，并选择一条或多条评论内容。可分享的内容以界面允许选择的项目为准；第三方集成带入的内容可能无法选择。

分享链接可设为获得链接的任何人或仅组织成员，也可以创建分享图片。分享是创建时的快照，后续评论和编辑不会改变已生成的分享页；选择取消分享会使该来源的现有分享链接失效。

分享前确认内容来源，以及原始外部系统的访问边界。不要分享密码、Token、API Key、私钥、个人信息、内部日志或未经脱敏的截图；获得链接的任何人都可能访问公开链接。

#展开回复编辑器

回复输入框可以展开为更大的编辑区域。展开和收起不会清空当前草稿、长文本或已经粘贴的图片，适合在需要更多空间时继续编辑后再发送。

#讨论串和已解决

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

评论的 更多 菜单（以线上为准）通常包括：

• 编辑：放在菜单顶部；进入后有明确编辑态，光标落在编辑区；
• 用此评论标记为已解决（带 Resolution 标记的评论显示 重新打开评论）；
• 复制、复制为 Prompt；
• 分享；
• 删除。

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

• Agent 已根据反馈完成修改；
• review 意见已经处理；
• 某个问题已经确认关闭。

解决的是整个讨论串，不是单条回复。可以从顶层评论或任意回复标记已解决；解决该讨论串的那条评论会显示 Resolution 标记。已解决后，只有这条评论的菜单显示 重新打开评论；其他评论仍是 用此评论标记为已解决，会把 Resolution 标记改到当前评论。标记已解决后，讨论串会折叠；如果后续还要继续讨论，可以重新打开。

#与 Agent 协作

评论适合补充团队都要看到的信息。要让 Agent 开始或继续工作，需要在评论里 @ 这个 Agent，或直接进入任务上的对话。

你可以在评论里：

• 补充 Agent 继续执行所需的信息；
• 回答 Agent 的问题；
• 说明方案是否可接受；
• @ 某个 Agent，让它参与当前任务。

普通评论不会自动触发处理人 Agent。只有在评论里 @ Agent 或 @ 小队时，才会让被提及的对象响应当前任务。

#评论里 @ Agent

如果你在评论里直接 @ 某个 Agent 或小队，HiFox 会在当前任务上新开一条对话，把这条评论作为起点，并把评论内容写进这条对话。这条评论下方会出现一张对话卡片，标题是「与某某的对话」，并标出是谁触发的（「某某 通过评论触发」，人工发起则是「某某 发起」）。动态里仍可以看到「已转入 与某某的对话」。

因此同一个 Agent 在同一个任务上可以有多条对话，互不覆盖；@ 不同 Agent 会各自进入各自的对话。想再开一条，用任务详情右侧对话面板的 新对话，或 召唤 Agent 菜单里的 选择 Agent 新开对话；这两个名单会显示对方在这个任务上已有几个对话，一个都没有时不显示。处理人 标签只标在最初被指派的那条对话上。

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

• 被 @ 的 Agent 属于当前组织；
• Agent 没有归档，并且有可用运行时；
• 你有权限触发这个 Agent。

同一个 Agent 在同一个任务上的多次运行仍然排队执行，不会并行。

如果 @ 发起方本身也是一个 Agent，而被 @ 的 Agent 在这个任务上已经有排队中的运行，这次 @ 会被跳过，用来避免几个 Agent 互相反复触发。成员在评论里 @ Agent 不会因为已有运行而被跳过。

要继续某一条对话，请在该对话的卡片里回复；再次 @ 同一个 Agent 会新开一条，而不是接上原来那条。等人回复、等待审阅等交接出现在对应的任务对话中；收件箱仍可能把这些对话信号汇总到任务行。详见 与 Agent 对话。

#常见问题

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

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

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

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