文档目录07 / 16

核心工作流07 / 16

讨论并审阅意图变更

本页内容

当讨论产生新的产品决定,可以让 Agent 将它整理成意图提议。你先查看文字、调整表达,再决定是否写入正式文档。

带着具体内容开始讨论

把鼠标移到相关段落,在左侧入口选择“就此提问”。Noea 会把段落引用放进输入框,并让文档与对话并排显示。这个动作不会自动发送消息。

你也可以在输入框中输入 @,搜索文档、段落或实现说明。选中的内容会显示为引用标签,并随消息提供给 Agent。

例如:

这段奖励规则没有说明漏打后的处理。请结合当前实现解释现有行为,再和我讨论是否允许补签。

决定明确后,再要求它写成提议:

把“每月允许补签一次”补进当前规则。请提出意图变更,供我审阅。

先判断是修复实现还是改变要求

发现实现与意图不一致时,先确认你原来的要求是否仍然成立。例如,文档要求“连续打卡满 7 天发放奖励”,代码却在第 6 天就发放:

你的决定接下来做什么
仍然要求满 7 天保留意图,要求 Agent 修复实现并验证边界
经过讨论,决定改为满 6 天修改意图,审阅新的触发条件,再核对实现

不要为了迁就代码而改写意图。先确认 Agent 是否理解了原要求,再检查代码是否满足要求:理解错了就澄清说明,代码有问题就修复代码,只有你决定改变规则时才修改意图。

需要修复时,可以明确提出:

仍然保留“满 7 天”的要求。请修复提前发奖的问题,验证第 6 天不发放、第 7 天发放,不要为适应现有代码修改意图。

区分建议和提议

“建议”卡记录 Agent 认为值得加入意图的内容。点击“采纳”会在当前对话中启动一轮工作,把建议整理为现有实现已经满足的提议;它不会直接写入正式意图。点击“忽略”则记录你不采纳这条建议。

“提议”包含具体的意图文档变更,供你审阅和决定。Agent 提交提议后,卡片会在本轮工作结束、停止或出错时显示;点击“查看更改”即可检查。

在文档中审阅

审阅界面沿用文档的排版:新增文字带绿色淡底,删除文字带红色淡底与删除线;替换时展示原文和新文,适合对照的内容还会标出词语层面的变化。

使用底部审阅栏在变更之间移动,或点击文件名切换文档。提议涉及多个文件时,决定作用于整份提议,不提供逐段或逐文件接受。

审阅时可以编辑新增和替换后的文字。原文、被删除内容和未涉及的段落不能在这个审阅状态下直接修改。修改后,主操作会变成“接受我的编辑”。

决定前,除了检查改了哪些词,还要确认这些词表达的是你理解并愿意保留的要求:

  • 能否用自己的话解释新增条件和术语?
  • 本次的执行安排是否被误写成了长期要求?
  • Agent 是否为了让文档符合现有代码,悄悄放宽了原本的约束?
  • 下次想改变这项行为时,能否找到对应的句子?

有不清楚的内容时,先回到对话,请 Agent 解释或调整提议。

选择如何处理

操作意图文档后续实现
接受写入整份提议尚需实现时继续实现;已满足时不再启动实现
接受我的编辑写入你修改后的整份提议根据修改后的提议继续处理
直接实现不写入提议按提议推进实现,仅在仍需实现的提议中提供
忽略不应用这份提议不因此启动它的实现

如果你希望某个决定成为后续开发应遵循的要求,审阅后接受它。选择“直接实现”时,这次要求不会被写回意图。

忽略提议不会撤销此前已经发生的代码修改。例如,Agent 可能先完成了工作,再提议把现有行为补进意图。

提议更新或文档已变化

同一对话中,Agent 可以修订提议。新版本会取代旧版本的待审阅内容,旧位置保留版本提示。你在旧版本审阅界面中尚未接受的修改不会自动带到新版。

如果正式文档已经不再符合提议的改前内容,接受按钮会禁用。使用“请智能体基于当前版本重新提议”,让 Agent 重新读取文档并生成可应用的变更。

接受之后

需要实现的提议会在当前对话继续工作。未完成时,使用卡片上的“继续实现”。实现后回到文档检查说明;没有自动更新时,手动运行“解释”。

如果不希望收到提议时自动进入审阅,可以在“设置 → 当前项目 → 自动化”关闭“自动打开审阅”,改为从提议卡片手动进入。这个开关只控制是否打开审阅界面,不会替你接受提议。

继续阅读让说明跟上变化。