核心工作流07 / 16
讨论并审阅意图变更
本页内容
当讨论产生新的产品决定,可以让 Agent 将它整理成意图提议。你先查看文字、调整表达,再决定是否写入正式文档。
带着具体内容开始讨论
把鼠标移到相关段落,在左侧入口选择“就此提问”。Noea 会把段落引用放进输入框,并让文档与对话并排显示。这个动作不会自动发送消息。
你也可以在输入框中输入 @,搜索文档、段落或实现说明。选中的内容会显示为引用标签,并随消息提供给 Agent。
例如:
这段奖励规则没有说明漏打后的处理。请结合当前实现解释现有行为,再和我讨论是否允许补签。
决定明确后,再要求它写成提议:
把“每月允许补签一次”补进当前规则。请提出意图变更,供我审阅。
先判断是修复实现还是改变要求
发现实现与意图不一致时,先确认你原来的要求是否仍然成立。例如,文档要求“连续打卡满 7 天发放奖励”,代码却在第 6 天就发放:
| 你的决定 | 接下来做什么 |
|---|---|
| 仍然要求满 7 天 | 保留意图,要求 Agent 修复实现并验证边界 |
| 经过讨论,决定改为满 6 天 | 修改意图,审阅新的触发条件,再核对实现 |
不要为了迁就代码而改写意图。先确认 Agent 是否理解了原要求,再检查代码是否满足要求:理解错了就澄清说明,代码有问题就修复代码,只有你决定改变规则时才修改意图。
需要修复时,可以明确提出:
仍然保留“满 7 天”的要求。请修复提前发奖的问题,验证第 6 天不发放、第 7 天发放,不要为适应现有代码修改意图。
区分建议和提议
“建议”卡记录 Agent 认为值得加入意图的内容。点击“采纳”会在当前对话中启动一轮工作,把建议整理为现有实现已经满足的提议;它不会直接写入正式意图。点击“忽略”则记录你不采纳这条建议。
“提议”包含具体的意图文档变更,供你审阅和决定。Agent 提交提议后,卡片会在本轮工作结束、停止或出错时显示;点击“查看更改”即可检查。
在文档中审阅
审阅界面沿用文档的排版:新增文字带绿色淡底,删除文字带红色淡底与删除线;替换时展示原文和新文,适合对照的内容还会标出词语层面的变化。
使用底部审阅栏在变更之间移动,或点击文件名切换文档。提议涉及多个文件时,决定作用于整份提议,不提供逐段或逐文件接受。
审阅时可以编辑新增和替换后的文字。原文、被删除内容和未涉及的段落不能在这个审阅状态下直接修改。修改后,主操作会变成“接受我的编辑”。
决定前,除了检查改了哪些词,还要确认这些词表达的是你理解并愿意保留的要求:
- 能否用自己的话解释新增条件和术语?
- 本次的执行安排是否被误写成了长期要求?
- Agent 是否为了让文档符合现有代码,悄悄放宽了原本的约束?
- 下次想改变这项行为时,能否找到对应的句子?
有不清楚的内容时,先回到对话,请 Agent 解释或调整提议。
选择如何处理
| 操作 | 意图文档 | 后续实现 |
|---|---|---|
| 接受 | 写入整份提议 | 尚需实现时继续实现;已满足时不再启动实现 |
| 接受我的编辑 | 写入你修改后的整份提议 | 根据修改后的提议继续处理 |
| 直接实现 | 不写入提议 | 按提议推进实现,仅在仍需实现的提议中提供 |
| 忽略 | 不应用这份提议 | 不因此启动它的实现 |
如果你希望某个决定成为后续开发应遵循的要求,审阅后接受它。选择“直接实现”时,这次要求不会被写回意图。
忽略提议不会撤销此前已经发生的代码修改。例如,Agent 可能先完成了工作,再提议把现有行为补进意图。
提议更新或文档已变化
同一对话中,Agent 可以修订提议。新版本会取代旧版本的待审阅内容,旧位置保留版本提示。你在旧版本审阅界面中尚未接受的修改不会自动带到新版。
如果正式文档已经不再符合提议的改前内容,接受按钮会禁用。使用“请智能体基于当前版本重新提议”,让 Agent 重新读取文档并生成可应用的变更。
接受之后
需要实现的提议会在当前对话继续工作。未完成时,使用卡片上的“继续实现”。实现后回到文档检查说明;没有自动更新时,手动运行“解释”。
如果不希望收到提议时自动进入审阅,可以在“设置 → 当前项目 → 自动化”关闭“自动打开审阅”,改为从提议卡片手动进入。这个开关只控制是否打开审阅界面,不会替你接受提议。
继续阅读让说明跟上变化。