no-negative-echo 实战手册:如何给 Codex 的 commit、PR 和文章标题「瘦身」?6个真实场景

原创2026-10-23 21:36:302,271 阅读

no-negative-echo 实战手册:如何给 Codex 的 commit、PR 和文章标题「瘦身」?6个真实场景

用 Codex 写代码时,你是否发现 commit message 里写满了「按用户要求移除冗余方案」、PR 标题叫「番茄炒蛋(无东坡肉)」?🍅 no-negative-echo 正是为这类「残留」问题而生的开源 Skill:它要求 Codex 等编码 Agent 只从最终被采纳的结果出发,生成标题、注释、commit 和 PR,让被否决的方案与对话里的纠正,不再出现在交付物中。

📌 一句话定位:no-negative-echo 是一个 Agent Skills 格式的 Skill,可挂载到 Codex、Claude Code、Cursor 等宿主,让 Agent「交付结果,而非复述对话」(Ship the result, not the conversation)。

no-negative-echo 过滤会话残留示意图:左侧是散乱丢弃的方案气泡,右侧是干净利落的最终交付物

🍅 no-negative-echo 解决什么问题:负向回声现象

社区流传过一个出圈段子:让 AI 做一盘番茄炒蛋,模型自作主张加了东坡肉;用户一句「有必要吗」,它立刻「你说得对」删掉——结果 PR 标题写着 「番茄炒蛋(无东坡肉)」,注释里还长篇论证本道菜为什么不需要东坡肉。

这就是本项目命名中的「负向回声(negative echo)」,常见于三个交付面:

  • commit:提交说明在讲「过程怎么来的」,而不是「仓库现在有什么」;
  • PR / 注释:删完后仍用「(无 X)」和「为什么不需要 X」证明自己听话;
  • 文章标题:删掉自证句后,标题反而变成「XXXX 综述——不过度防御且无提示版」。

现象的完整来龙去脉可查阅 BACKGROUND.md,仓库内的验收夹具见 tests/evaluation-cases.md。

🧹 安装步骤:在 Codex 中一键装上 Skill

官方推荐的本地安装路径是「克隆 → 跑测试 → 执行安装脚本」,只需 Python 3.10+ 和 Git:

git clone https://gitcode.com/gh_mirrors/no/no-negative-echo
cd no-negative-echo
python3 -I -m unittest discover -s tests -p 'test_*.py'
python3 -I scripts/install_skill.py \
  --expected-provenance-sha256 d42280b21f519ea00e417c68f31c68ca3d7faae607faf6dcb6e04beeff9c5ed6 \
  --discovery-root "$HOME/.agents/skills" \
  --agent codex

⚠️ 安装器带有严格的安全合约(源码审查、哈希校验、安装前测试、回滚目录等),完整约束见安装合约文档 INSTALL.md。

替代方式:写入 AGENTS.md。 如果只想让核心规则长期生效,可在项目根目录 AGENTS.md 追加几行指令:「生成最终产物及其包装时,只描述最终采用的状态,假设读者没看过本次会话」。Codex 会在每次运行时读取项目指令,修改后需开启新会话才能加载。两种方式可叠加使用:AGENTS.md 提供持续生效的核心规则,Skill 负责重要交付前的完整检查。

💬 日常调用姿势:两个提示词模板

重要交付前建议显式调用(代码场景):

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

文章场景则换成:

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

完整规则定义在 no-negative-echo/SKILL.md;配套的扫描脚本 no-negative-echo/scripts/check_surface.py 可做精确关键词与文件名检查。

🎯 6个真实场景:commit、PR 与文章标题瘦身实战

以下 6 个场景取材自仓库公开的评测用例,每个都是「残留 → 瘦身」的前后对比:

场景 1:commit message ——「Redis 只是讨论稿」

最终实现是 PostgreSQL 任务队列,但 commit 却在讲被丢弃的 Redis。

交付面 残留(前) 瘦身(后)
commit 移除冗余的 Redis 方案,按用户要求改用 PostgreSQL Add PostgreSQL task queue

场景 2:PR 标题 —— 括号里的自我声明

导出流程已改为流式处理,标题却还要挂个括号自证。

交付面 残留(前) 瘦身(后)
PR 标题 Stream large exports(no full buffering) Stream large exports

场景 3:文章标题 ——「负向约束」成了新残留

要求综述删掉自证句,标题却还在自证。

交付面 残留(前) 瘦身(后)
标题 + 开篇 XXXX 综述——不过度防御且无提示版;「本文不存在过度防御」 XXXX 综述;开篇直接进入正文

场景 4:交付说明 —— 经典的「无东坡肉」

交付面 残留(前) 瘦身(后)
标题 + 说明 番茄炒蛋(无东坡肉);为什么本道菜不需要东坡肉 番茄炒蛋;菜谱只讲这道菜

场景 5:删除 API —— 该留的要留

「移除」本身就是读者必须知道的真实变化,no-negative-echo 并不一刀切:

交付面 错误(清理过度) 正确 ✅
迁移说明 + commit 完全不再提 v1 被移除 迁移指南如实写明 v1 已删除,commit 写「Remove v1 API,新增 v2 迁移指南」

场景 6:敏感凭据 —— 不复述明文值

事故报告误含测试凭据时,新表面只按类别指代,绝不复述完整值。

交付面 残留(前) 瘦身(后)
commit / PR 复述完整凭据值 仅写「移除泄漏的测试凭据」,不留明文

这些场景对应的判定数据与评分协议位于 evals/evaluation-oracle.jsonl 与 evals/evaluation-protocol.md。

⚖️ 三问判断法:哪些内容必须保留

不是所有「不 X」都能机械删除——Skill 的核心是给每个交付面单独过三问:

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

速查表(节选自 README):

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

涉及敏感信息、公开发布与严格验收时,仓库提供了高保障收口流程:no-negative-echo/references/high-assurance-finalization.md。

⚠️ 边界与常见误区

  • Skill 被发现 ≠ 已激活:重要交付请按上文模板显式调用;
  • 它是提示词层的缓解措施,不是确定性过滤器,无法清除模型已读上下文;
  • 内置扫描器只做文本、文件名与可疑 Unicode 检查,PASS 不等于语义检查完成;
  • 不要为了通过检查而修改 API、测试、快照或已有的用户改动。

🧭 仓库资源导航

✅ 写在最后

no-negative-echo 的验收标准可以浓缩成一句话:一个没参加本次会话的读者,不应该能从标题或注释里反推出「曾经有过东坡肉」。无论是花一条命令安装 Skill,还是往 AGENTS.md 写几行核心规则,都能让 Codex 的 commit、PR 和文章标题只说「最终结果」,把对话过程留给对话本身。

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