Stop That Shit
把任务做完,也知道何时停下。
一次导出,多出了一份没人读取的 SHA-256。这让我开始追问:Agent 增加的每一步,到底改变了什么?
本文目录
同样是校验,去留取决于用途。

没有后续读取
result.csv 与未被读取的摘要文件
后续流程只读取结果文件。摘要没有参与交付,可以省掉。
参与发布判断
文件 → 摘要 → 发布校验器
发布校验器读取摘要,并在不匹配时拒绝发布。这一步应该保留。
如何工作
给使用编码 Agent 的人
先明确任务与验收条件
需要交付什么,允许哪些动作。
Skill 判断必要性
用 Stop Ladder 查找当前任务需要这一步的依据。
完成请求与必要后续,省去没有依据的额外工作。
Guard 检查明确边界
核对已声明的模式、文件与动作边界。
明确任务模式启用后,返回允许或拒绝结果。
别只说“不要过度工程”。沿着 Stop Ladder 找证据。
抽象的提醒很容易被新的未来场景绕过去。Stop Ladder 把判断拉回当前请求、可达代码、数据、部署状态和验收条件。
- 用户要求了吗?
- 它是完成当前结果所必需的吗?
- 哪段可达代码、数据、用户决策、部署状态或验收条件证明了这一点?
- 省掉它,当前任务会在哪里失败?
没有当前任务的证据,就不要把“以后可能有用”升级成“现在就做”。
安装与支持
说明对应版本: 0.2.4
Codex 安装命令固定到下方版本。重启后,在 CLI TUI 的 /hooks 中对照该 tag 的 Hook 清单检查并信任命令;完整变更见 GitHub Release。STSS Skill 也可以单独安装。
codex plugin marketplace add lennney/stop-that-shit --ref 0.2.4
codex plugin add stop-that-shit@stop-that-shit需要 Node.js 18+。完成 Hook 检查后,新任务里用 $stop-that-shit review 或 $stop-that-shit change 写明授权。
同一套任务边界,五种 Host 接入
- Codex
- Plugin + packaged Hooks
- Claude Code
- Plugin + native lifecycle Hooks
- OpenCode
- V1 / V2 插件与动作前拒绝
- Hermes Agent CLI
- Native plugin callbacks
- Pi
- Native Extension + before-action checks
常见问题
使用与安装
这是什么工具?
它是一套面向 AI coding agent 的任务边界 Skill + Hook Guard。独立 Skill 用 Stop Ladder 和任务模式提供建议性指导;完整插件的 Guard 在受支持的 Hook 路径上检查模式、依赖、hash、文件和 subagent 边界。STSS 是可单独安装的写作 Skill,帮助删改没有决策消费者的句子。
是 Skill,还是插件?
两者都是。独立 Skill 提供 Stop Ladder 和 review/change 等任务模式,属于建议性指导;完整插件还包含 Guard 与 Host Adapter,能在受支持的 Hook 路径上检查明确边界。
怎样在 Codex 中安装?
从 GitHub Release 查看当前 tag,并按该 tag 的 INSTALL.md 安装或更新。Codex 需要 Node.js 18+;将 marketplace 固定到安装区所示 tag,重启后在 CLI TUI 的 /hooks 中对照该 tag 的 Hook 清单检查并信任命令。新任务用 review 或 change 声明授权。
适合哪些工作流?
先在临时仓库做一次 review/change smoke,再用成对的 Bad Case 与 Good Case 判断误放和误拦。EVIDENCE.md 区分测试、适配器行为与宿主最终效果;这些记录不证明模型整体更听话。
支持哪些编码助手?
插件为 Codex、Claude Code、OpenCode、Hermes Agent CLI 和 Pi 提供 Adapter;OpenCode 同时支持 V1 与 V2。各 Host 的安装、信任、重启和事件覆盖范围不同。Pi 的独立子进程不继承父任务合同,细节以版本化安装文档和适配器契约为准。
行为与边界
与 AGENTS.md 有什么区别?
AGENTS.md 适合记录仓库长期有效的架构、命令和约定。Stop That Shit 不替代这些上下文;它让用户为当前任务声明 review/change、文件、依赖、hash 和 subagent 边界,并在受支持的 Hook 路径上检查明确动作。
SHIT 指什么?
SHIT 不是单独的执行模式,而是四类任务漂移的缩写:Scope creep(范围膨胀)、Hashing and hypothetical hardening(无消费者的摘要与假设性防御)、Intent violation(意图越界)和 Task thrashing(任务打转)。真正的任务模式是 review、answer、monitor 和 change 等。
有哪些局限?
它只能检查 Host 已提供、并且输入足够明确的 Hook 事件,不是安全沙箱,也不会看到 migration、retry 或 cache 就自动判定多余。Guard 返回拒绝只说明它发出了拒绝响应,不证明已观察到 Host 的最终执行结果。
它会禁止所有 Hash 或 checksum 吗?
不会。发布验证需要读取摘要,缺少它就无法通过验收,这是有消费者的 checksum。对可识别的新 hash 动作,当前任务可以用 hash=allow 明确授权;是否需要它仍要看请求和消费者。
版本与来源
STSS 是什么?
STSS 是可单独安装的写作 Skill,提供 rewrite 与 audit 两种模式。它用 Sentence Consumer Test、Claim Ledger 和 Claim Diff,帮助删改没有决策消费者的免责声明、过度保留和自我辩护。安装方法与变更记录见对应版本的 INSTALL.md 和 Release。
源码和版本记录在哪里?
公开源码、Release 和版本化下载文档都在 GitHub 仓库 github.com/lennney/stop-that-shit;本页是 lennney 维护的双语产品说明。核对代码、版本或安装步骤时,以 GitHub tag 和 Release 为准。
接着读
只让 Codex 导出一个文件,它却多做了一份 SHA-256