Stop That Shit
把任务做完,也知道何时停下。
一次导出,多出了一份没人读取的 SHA-256。这让我开始追问:Agent 增加的每一步,到底改变了什么?
Stop That Shit 是面向 AI coding agent 的任务边界 Skill + Guard。Skill 用 Stop Ladder 指导实现与验收;Guard 在受支持的 Host 路径上检查明确的任务、文件、依赖、hash 和 subagent 边界。STSS 为提案、文章、案例和图注提供重写、审稿与新稿生成指导。
本文目录
同样是校验,去留取决于用途。

没有后续读取
result.csv 与未被读取的摘要文件
后续流程只读取结果文件。摘要没有参与交付,可以省掉。
参与发布判断
文件 → 摘要 → 发布校验器
发布校验器读取摘要,并在不匹配时拒绝发布。这一步应该保留。
如何工作
给使用编码 Agent 的人
先明确任务与验收条件
需要交付什么,允许哪些动作。
Skill 判断必要性
用 Stop Ladder 查找当前任务需要这一步的依据。
完成请求与必要后续,省去没有依据的额外工作。
Guard 检查明确边界
核对已声明的模式、文件与动作边界。
明确任务模式启用后,返回允许或拒绝结果。
沿着 Stop Ladder,把当前责任做完整。
先明确结果与已有承诺,再选直接方案,补具体缺口,判断防御的实际作用,验证充分后结束。
- 当前要交付什么,已有边界与支持承诺是什么?
- 已有代码、标准库、平台能力或已安装依赖够用吗?
- 还有哪个具体缺口需要补齐?
- 这层防御检测什么,会怎样拒绝、恢复或诊断?
- 结果与必要后续是否完成,相关验证是否充分?
完成请求和必要后续;没有当前用途的额外工作就停下。
安装与支持
说明对应版本: 0.2.5
Codex 安装命令固定到下方版本。重启后,在 CLI TUI 的 /hooks 中对照该 tag 的 Hook 清单检查并信任命令;完整变更见 GitHub Release。STSS Skill 也可以单独安装。
codex plugin marketplace add lennney/stop-that-shit --ref 0.2.5
codex plugin add stop-that-shit@stop-that-shit完成 Hook 检查后,在新任务里用 $stop-that-shit review 或 $stop-that-shit change 写明授权。 核心 Guard 需要 Node.js 18+。Pi 0.84.4 自身需要 Node.js 22.19+;Oh My Pi 18.4.4 的已记录验证使用 Bun 1.3.14。各 Host 的要求和安装步骤见版本化 INSTALL.md。
同一套任务边界,6 种 Host 接入
- Codex
- Plugin + packaged Hooks
- Claude Code
- Plugin + native lifecycle Hooks
- OpenCode
- V1 / V2 plugins + before-action checks
- Hermes Agent CLI
- Native plugin callbacks
- Pi
- Native Extension + before-action checks
- Oh My Pi
- Explicit OMP Extension + native /sts controls
常见问题
使用与安装
这是什么工具?
Stop That Shit 是面向 AI coding agent 的任务边界 Skill + Guard。Skill 用 Stop Ladder 指导实现与验收;Guard 在受支持的 Host 路径上检查明确的任务、文件、依赖、hash 和 subagent 边界。STSS 为提案、文章、案例和图注提供重写、审稿与新稿生成指导。
是 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 区分测试、适配器行为与宿主最终效果;这些记录不证明模型整体更听话。
支持哪些编码助手?
当前稳定版提供下方 Host 列表中的 Adapter,包括 Oh My Pi 独立 Extension;OpenCode 包含 V1 与 V2。各 Host 的安装、信任、重启与事件覆盖不同。Pi 的独立子进程不继承父任务合同;完整要求见安装区与版本化 INSTALL.md。
行为与边界
与 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 帮助删改无用途的免责声明、堆叠保留与自我辩护,并保留影响读者判断的条件、来源和责任。
源码和版本记录在哪里?
公开源码、Release 和版本化下载文档都在 GitHub 仓库 github.com/lennney/stop-that-shit;本页是 lennney 维护的双语产品说明。核对代码、版本或安装步骤时,以 GitHub tag 和 Release 为准。
接着读
只让 Codex 导出一个文件,它却多做了一份 SHA-256