No Negative Echo

这是什么

方案已经改对，Agent 最后却把聊天里淘汰过的内容写进了标题、注释、commit 或 PR。no-negative-echo 用于降低这类会话残留进入最终交付的概率。

- 标题：番茄炒蛋（没有东坡肉）
+ 标题：番茄炒蛋

它要求从最终采用且已经验证的状态重写正文和外层文案，并分别检查标题、文件名、代码注释、测试名、commit、PR、发布说明和交付说明。聊天里被否掉的草案通常只作为控制信息；真实基线变化、已执行的外部操作和必要的安全、迁移、兼容及审计事实仍须保留。

为什么做这个 Skill

我已经手改过太多次 commit message。其中一类改得最多，我给它起了个固定名字：「移除此地无银三百两」。

典型场景是，让 Agent 做一盘番茄炒蛋，它先加了东坡肉。指出问题后，菜改对了，PR 标题却成了 番茄炒蛋（无东坡肉），注释里还要解释为什么这道菜不需要东坡肉。

写文章也会碰到同样的问题。正文里的自证句删完，标题又冒出 某某综述：不过度防御且无提示版。成品已经和那些说法没关系，交付层却把纠正过程带了回来。

这个比喻来自 @songkeys 的帖子，更完整的背景和讨论收在 BACKGROUND.md。

安装

目前按 Codex Skill 结构适配，并提供确定性脚本测试和公开评测协议；仓库尚未发布模型行为有效性结果。

让 Codex 直接安装

把下面这段发给 Codex：

请安装 no-negative-echo Skill。克隆 https://github.com/LB623/no-negative-echo 后，先检查运行文件清单并运行 python3 -m unittest discover -s no-negative-echo/tests -p 'test_*.py'，通过后再运行 python3 no-negative-echo/scripts/install_skill.py。告诉我安装路径、安装来源提交和验证结果，并提醒我下一轮对话开始使用。

命令行安装

git clone --depth 1 https://github.com/LB623/no-negative-echo.git
python3 -m unittest discover -s no-negative-echo/tests -p 'test_*.py'
python3 no-negative-echo/scripts/install_skill.py

脚本默认安装到 ${CODEX_HOME:-$HOME/.codex}/skills/no-negative-echo。它只接受固定运行文件清单，拒绝符号链接、特殊文件和未知文件；再次运行只会替换能验证为同名 Skill 的目录。新目标激活前，Python 能捕获的替换异常（包括 KeyboardInterrupt）会尝试恢复旧目录；恢复失败则报告需要人工检查的备份路径。新目标激活后就视为安装成功；清理旧备份失败只会警告并报告路径，不会把已激活的新版误报为未安装。进程崩溃、断电或 SIGKILL 仍可能在两次重命名之间留下 .no-negative-echo-backup-* 并使目标暂时缺失；重试前应先检查该备份。需要可复现安装时，请先 checkout 你信任的 tag 或 commit。

安装完成后，重新加载或重启 Codex。

不安装：复制到 AGENTS.md

只想先用一条轻量规则，可以把下面这段加到项目的 AGENTS.md：

## 最终交付清理

- 交付前，按用户当前要求、每个输出位置的权威基线（如父提交、PR 目标分支、上一发布版本或用户批准稿）和可复核的最终状态，检查本任务新建或修改的正文、标题与开篇、文件名、注释/docstring、测试名、commit/PR、发布说明和交付说明。只陈述最终采用的结果、真实差异、实际执行的验证，以及读者理解或审计结果所需的理由；未验证项必须明确标注。
- 未进入最终基线的被否方案、纠错经过、助手草稿和临时尝试，以及仅用于控制生成过程、无需对读者公开的负向指令或禁用词表，只作为工作信息，不写入成品；也不得用近义改写、括号、“无 X”“非 X 版”或“已清理”等标签保留。每个位置单独判断：不了解本轮会话的读者是否需要该信息？若不需要，且省略不会造成事实错误、误导、安全、兼容、迁移、合规或审计风险，则省略。
- 不得覆盖、回退或误归因任务开始前及并发发生的用户改动，也不得把它们算作本次成果。按需如实保留真实基线变化、已执行的外部操作及部分失败、未解决风险，以及用户明确要求对外说明的比较、引用、审计或迁移信息；敏感信息按目的地最小披露。
- 此规则只授权清理表述和交付组织。除非用户明确授权、任务本身要求并已完成相应验证，不得改写既有历史或外部记录，不得改变可执行行为、公共 API、协议、数据结构或配置格式、迁移与诊断语义、测试断言、覆盖范围、快照或 Golden 文件，也不得通过修改测试或快照掩盖失败。

这是无需安装的轻量版，但不等价于完整 Skill：它没有长会话重新激活、分离生成与验证、扫描器、冻结与回读流程和完整验收闸门。不过 AGENTS.md 通常会被项目稳定加载；可以先用这一段，重要交付再安装并显式调用 Skill。

使用

Codex 可以隐式加载它。长对话结束后，准备生成 commit、PR、发布标题或交付说明时，最好显式调用一次：

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

文章场景可以这样用：

$no-negative-echo
根据最终保留的正文重写标题和开篇。

它会检查哪些位置

判断边界

这个 Skill 不做关键词清零。真实发生过的删除、迁移要求和安全信息，本来就应该写清楚。

每个输出位置都要单独判断：

• 没参与过这轮对话的读者，是否需要这条信息？
• 省略它，是否会带来安全风险、事实错误、误导、兼容性或合规问题？
• 它是否真实存在于权威基线中，而且当前产物需要说明这项变化？

第一项是前提。在此基础上，第二项或第三项至少满足一项，这条信息才保留。用户明确要求的方案比较、审计、逐字引用、发布记录或迁移说明也应保留。

权威基线要按输出位置选择：commit 看父 tree 或 staged diff，PR 看目标分支 merge-base，发布说明看上一个已发布版本，交付说明还要考虑任务开始时的完整工作区和实际执行过的外部操作。未提交不等于被否；用户原有改动必须单独保留归属。助手草稿、未采用补丁和纯本地临时尝试才属于会话历史。

能力边界

这是提示词层的缓解措施，不是确定性过滤器。它能降低会话残留进入成品的概率，但不能保证每次都拦住。

• Codex 是否隐式加载 Skill 由宿主决定，做重要交付时最好显式调用。
• Skill 无法擦除模型已经读到的上下文，也控制不了终端输出、工具日志和宿主生成的界面文案。
• 自带扫描器只提供原始文本、文件名和可疑 Unicode 的确定性检查；传入 --root 时会检查相对路径中的目录名，否则只检查 basename。它不是渲染、语义、媒体或秘密扫描器，PASS 不能单独证明最终交付干净。
• producer 或 validator 的上下文继承模式无法确认时，只能称为 best-effort，不能声称上下文已隔离或经过独立验证。
• 它处理最终交付里的会话残留，不负责阻止模型一开始做多余的实现。
• 凭据、个人信息和其他敏感数据仍应使用专门的密钥扫描或合规工具检查。

Claude Code、Cursor 等环境还没有做过独立的安装和行为测试，本仓库不会把它们写成已支持平台。

开发和评测

运行本地测试：

python3 -m unittest discover -s tests -p 'test_*.py'

安装目录 no-negative-echo/ 只放运行时文件。评测提示和答案放在 evals/ 里，避免开发用例跟着 Skill 一起进入模型上下文。

公开用例只用于开发，跑通不等于问题消失。仓库提供无 Skill、固定对照提示、显式调用和隐式调用的评测协议，要求把 routing 与激活后的行为分开报告，并使用独立裁判、冻结输出、真实 surface 回读和未公开 holdout。CI 只运行确定性脚本与评分器测试，不运行 Codex 模型评测，也不产生有效性百分比。格式和统计限制见 evaluation-protocol.md。

.
├── .github/workflows/test.yml
├── BACKGROUND.md
├── LICENSE
├── README.md
├── README_EN.md
├── evals/
│   ├── comparator.txt
│   ├── evaluation-oracle.jsonl
│   ├── evaluation-prompts.jsonl
│   ├── evaluation-protocol.md
│   └── score_eval.py
├── no-negative-echo/
│   ├── SKILL.md
│   ├── agents/openai.yaml
│   ├── assets/
│   │   ├── decision-boundary.png
│   │   ├── icon-400.png
│   │   └── icon.png
│   └── scripts/check_surface.py
├── scripts/install_skill.py
└── tests/
    ├── evaluation-cases.md
    ├── test_eval_integrity.py
    ├── test_installer_scanner.py
    └── test_scripts.py

许可证

本项目采用 MIT License。允许商用、修改、分发和闭源再发布，但必须保留原始版权与许可声明。

反馈

如果遇到新的「此地无银三百两」输出，提 Issue 时请带上原始请求、实际输出、期望输出和出现位置，再说明当时是显式调用还是隐式触发。提交前，请先替换真实凭据、个人信息和内部项目名。