评论和回复
评论和回复用于把任务过程中的补充信息、问题、反馈和结论留在同一个任务里。成员和 Agent 都可以基于这些上下文继续推进。
从哪里进入？
打开一个 任务 后，通常可以在任务详情里看到：
- 活动：展示任务活动记录、评论和回复；
- 对话：和 Agent 协作的对话记录，和评论不是同一套数据；未指派 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 提及。创建或编辑快捷回复时，在编辑器中选择要提及的 Agent；保存后重新打开仍会保留提及。直接发送快捷回复，或先点「插入」将内容写入评论、回复或 Agent 对话编辑器后再发送时，提及会按正常的 Agent 提及规则处理。
只有当前组织、空间和成员权限允许使用的 Agent 才能作为有效提及。Agent 已归档、不可用、属于其他空间或当前成员无权使用时，提及可能降级为普通文本或无法发送；快捷回复不会因此把 Agent 绑定到所有任务。
快捷回复中的审阅确认
如果任务处于待审状态，成功发送“已审阅，没问题”快捷回复后，HiFox 会自动移除待审标识。列表、任务详情和重新打开任务后都会保持一致。只有消息成功发送且任务确实处于待审状态时，才会触发这个动作。
这只会清除待审标识，不会修改任务的生命周期状态，也不会把任务标记为已完成。
复制评论和对话中的图片
在任务评论或 Agent 对话中打开图片预览后，选择 复制图片，就可以将图片直接粘贴到其他支持图片粘贴的应用中。
如果复制不可用或失败，可以继续使用预览中的下载操作保存图片。
下载大附件
无法直接预览的大附件应使用下载而不是打开。点击后会显示下载反馈；下载完成后，桌面端会自动打开下载目录并定位或选中文件。下载目录行为取决于操作系统权限和桌面端能力；如果没有自动定位，请到系统下载目录查找。
分享任务中的评论
在活动中，可以从评论或回复的分享入口进入选择模式，并选择一条或多条评论内容。可分享的内容以界面允许选择的项目为准；第三方集成带入的内容可能无法选择。
分享链接可设为获得链接的任何人或仅组织成员，也可以创建分享图片。分享是创建时的快照，后续评论和编辑不会改变已生成的分享页；选择取消分享会使该来源的现有分享链接失效。
分享前确认内容来源，以及原始外部系统的访问边界。不要分享密码、Token、API Key、私钥、个人信息、内部日志或未经脱敏的截图；获得链接的任何人都可能访问公开链接。
展开回复编辑器
回复输入框可以展开为更大的编辑区域。展开和收起不会清空当前草稿、长文本或已经粘贴的图片，适合在需要更多空间时继续编辑后再发送。
讨论串和已解决
每条顶层评论都可以形成一个讨论串。回复会显示在同一个讨论串里。
当一段讨论已经处理完，可以把顶层评论讨论串标记为已解决。常见场景包括：
- Agent 已根据反馈完成修改；
- review 意见已经处理；
- 需要确认的问题已经有结论。
只有顶层评论讨论串可以标记为已解决；单条回复不能单独解决。标记已解决后，讨论串会折叠；如果后续还要继续讨论，可以重新打开。
与 Agent 协作
评论适合补充团队都要看到的信息。要让 Agent 开始或继续工作，需要在评论里 @ 这个 Agent，或直接进入任务上的对话。
你可以在评论里：
- 补充 Agent 继续执行所需的信息；
- 回答 Agent 的问题；
- 说明方案是否可接受；
- @ 某个 Agent，让它参与当前任务。
普通评论不会自动触发处理人 Agent。只有在评论里 @ Agent 或 @ 小队时，才会让被提及的对象响应当前任务。
评论里 @ Agent
如果你在评论里直接 @ 某个 Agent 或小队，HiFox 会打开或继续它在这个任务上的对话，并把这条评论写入该对话。活动里可以看到「已转入 与某某的对话」。同一任务上，同一个 Agent 共用一条对话；@ 不同 Agent 会各自进入各自的对话。
这种方式不要求该 Agent 是任务处理人，但仍需要满足基本条件：
- 被 @ 的 Agent 属于当前组织；
- Agent 没有归档，并且有可用运行时；
- 你有权限触发这个 Agent；
- 这个 Agent 当前没有同一个任务的待处理运行。
继续对话请在任务的「对话」里回复，或再次 @ 同一个 Agent。等待人工回复、等待审阅等交接出现在对应的任务对话中；收件箱仍可能把这些对话信号汇总到任务行。详见 与 Agent 对话。
常见问题
评论会进入 Agent 的上下文吗？
会。Agent 执行任务时会读取任务标题、描述、状态、最近评论和相关配置。重要补充应该写进评论，避免只留在外部聊天中。
可以只用评论，不写任务描述吗？
不建议。任务描述应该承载稳定的目标、背景和验收标准；评论适合承载后续补充、讨论和反馈。