3个问题搞定交付残留:no-negative-echo 判断原则完全指南

原创2026-10-23 09:05:421,620 阅读

3个问题搞定交付残留:no-negative-echo 判断原则完全指南

no-negative-echo 是一个解决 AI Agent「交付残留」问题的 Agent Skill:它让 Codex 等编码 Agent 根据最终结果重新生成标题、注释、commit 和 PR 描述,把会话里被否决的方案挡在交付物之外。本文用「番茄炒蛋」的故事讲清楚它的核心——一套只需问 3 个问题 就能判断内容该留该删的原则,帮你快速清理交付物里的会话残留。

为什么 AI 会把被否决的方案写进最终交付?

先还原一个广为流传的场景:你让 AI 做一盘「番茄炒蛋」,它自作主张加了东坡肉;你一问「有必要加吗?」,它立刻说「你说得对」并删掉。可一提 PR,标题却写成了——

- 标题:番茄炒蛋(没有东坡肉)
+ 标题:番茄炒蛋

注释里还长篇大论「为什么本道菜不需要加东坡肉」。这就是典型的负向回声:被否决的内容在交付物里又「响」了一遍。

项目调研发现这类泄漏通常出现在三个表面 🍳:

表面 泄漏的东西
代码 / 注释 / 说明 会话里试过又丢掉的路径
commit / PR 提交说明在讲过程,而不是讲结果
长文 / 综述 负向约束被写进标题,如「……综述——不过度防御且无提示版」

一句话验收标准:一个没参加过这次会话的读者,不应该能从标题或注释里反推出「曾经有过东坡肉」。

no-negative-echo 交付残留判断边界:左边是散落的会话过程与草稿,右边是干净收尾的最终交付

核心方法:3 个问题判断内容该留还是该删

no-negative-echo 的判断原则不靠「禁词清单」,而是要求对每一个输出位置(标题、文件名、注释、commit、PR 正文、交付说明)单独问三个问题:

  1. 不知道本轮对话的读者,需要这条信息吗?
  2. 省略它,会造成事实错误、安全风险、误导或兼容问题吗?
  3. 它是否是权威基线中的真实变化,且当前交付面需要解释它?

三个问题的答案都是「否」→ 直接省略。仅仅「出现过」或「被否过」,不是保留的理由。

判断原则速查表

内容类型 处理方式
只在会话中讨论、从未进入最终基线的方案 省略
助手草稿、中间尝试、用户的措辞纠正 省略
已发布的 API 删除、迁移与外部操作 如实说明
安全、法律、兼容性、审计所需的事实 保留
用户明确要求的对比、引用或决策记录 保留
任务开始前已有的用户改动 保留归属,不算作本次成果

从最终状态重新生成,而不是修补被否文案

这一步是原则落地的关键 ⚡

  • 不要逐词修改被否文案:标题、文件名、开篇和标签,应从正向目标重新生成,而不是在被否句子上打补丁。
  • 「不要提 X」≠「写一句无 X」:如果某个对比没有存在必要,删掉整个对比,而不是换成同义词或加上「已清理」的声明。
  • 保留该留的 why:真实的基线变化、已执行的外部操作、必要的技术名称、诊断、测试和快照,都要如实保留;任务开始前用户已有的改动也要保留归属。

两种使用方式:安装 Skill 或写入 AGENTS.md

方式一:安装 Skill(完整检查流程)

需要判断流程、检查脚本和高保障模式时,让具备网络、终端和文件权限的 Agent 按安装合约执行即可;本地安装示例(以 Codex 为例):

git clone https://gitcode.com/gh_mirrors/no/no-negative-echo.git
cd no-negative-echo
python3 scripts/install_skill.py --agent codex --discovery-root "$HOME/.agents/skills"

完整的安全约束、其他宿主支持与升级方式见 INSTALL.md。重要交付前建议显式调用:

使用 no-negative-echo Skill。
根据最终 diff 写 commit subject、PR 标题、PR 正文和交付说明。

方式二:写入项目 AGENTS.md(持续生效的核心规则)

如果只希望当前项目持续遵守核心行为约束,把精简规则追加到项目根目录的 AGENTS.md 即可:生成标题、注释、commit、PR 和交付说明时,只描述最终采用的状态,假设读者没看过本次会话。两种方式的完整示例文案见 README.md。

两种方式是互补关系:AGENTS.md 提供持续生效的核心规则,Skill 负责重要交付前的完整检查。

交付前验证:内置扫描器与它的边界

Skill 内置了一个轻量扫描器 scripts/check_surface.py,可对最终文本和文件名做精确词匹配检查,并顺带标记可疑 Unicode(如双向控制字符)。注意它的定位 📌:

  • PASS 只代表精确匹配通过,不代表语义检查完成——改写、换说法的残留仍需人工通读。
  • 内容发生变化后要重新检查;工具、hook 或外部系统改写过交付面后,要读回实际结果再确认。
  • 不要为了通过检查而修改 API、迁移、测试、快照或已有用户改动。

同时要清醒认识它的边界:这是提示词层的缓解措施,不是确定性过滤器。Skill 被发现不等于已激活;它无法清除模型已读上下文,也管不到工具日志和宿主 UI。涉及敏感信息、公开发布的场景,才需要加载高保障流程 references/high-assurance-finalization.md。

常见问题(FAQ)

Q:装了 Skill,交付还是出现了残留怎么办? A:Skill 隐式触发不稳定,重要交付请显式调用;也可以叠加 AGENTS.md 方式让核心规则持续生效。

Q:删过头,把有用的「为什么不用 X」也删了? A:这正是三问原则的价值——维护者以后会踩的、从 diff 看不出来的不变量(属于问题 2、3 的范畴)应保留,会话垃圾才删除。判断依据见 BACKGROUND.md 中的机制分析。

Q:凭据、隐私信息泄漏怎么办? A:交给专门的密钥/合规扫描工具处理,本 Skill 的扫描器只面向非敏感的普通术语。

相关资料索引

掌握「三个问题 + 从最终状态生成 + 交付前验证」这套组合拳,你的 Agent 交付物就会像真正的成品,而不是一份带否定句的复盘 ✅

登录后查看全文
no-negative-echo