no-negative-echo 实战手册:如何给 Codex 的 commit、PR 和文章标题「瘦身」?6个真实场景
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 解决什么问题:负向回声现象
社区流传过一个出圈段子:让 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 的核心是给每个交付面单独过三问:
- 没看过本轮对话的读者,需要这条信息吗?
- 省略它会造成事实错误、安全风险或误导吗?
- 它是权威基线中的真实变化,且当前交付面需要解释它吗?
速查表(节选自 README):
| 内容 | 处理 |
|---|---|
| 只在会话中讨论、从未进入基线的方案 | 省略 |
| 已发布的 API 删除、迁移与外部操作 | 如实说明 |
| 安全、法律、兼容性、审计所需事实 | 保留 |
| 用户明确要求的对比、引用或决策记录 | 保留 |
| 任务开始前已有的用户改动 | 保留归属,不算本次成果 |
涉及敏感信息、公开发布与严格验收时,仓库提供了高保障收口流程:no-negative-echo/references/high-assurance-finalization.md。
⚠️ 边界与常见误区
- Skill 被发现 ≠ 已激活:重要交付请按上文模板显式调用;
- 它是提示词层的缓解措施,不是确定性过滤器,无法清除模型已读上下文;
- 内置扫描器只做文本、文件名与可疑 Unicode 检查,
PASS不等于语义检查完成; - 不要为了通过检查而修改 API、测试、快照或已有的用户改动。
🧭 仓库资源导航
- 官方文档:README.md / README_EN.md
- 安装合约:INSTALL.md
- Skill 核心规则:no-negative-echo/SKILL.md
- 交付面扫描脚本:no-negative-echo/scripts/check_surface.py
- 评测用例:tests/evaluation-cases.md
- 评测协议:evals/evaluation-protocol.md
- 设计背景:BACKGROUND.md
✅ 写在最后
no-negative-echo 的验收标准可以浓缩成一句话:一个没参加本次会话的读者,不应该能从标题或注释里反推出「曾经有过东坡肉」。无论是花一条命令安装 Skill,还是往 AGENTS.md 写几行核心规则,都能让 Codex 的 commit、PR 和文章标题只说「最终结果」,把对话过程留给对话本身。
