Stop That Shit

把任务做完,也知道何时停下。

一次导出,多出了一份没人读取的 SHA-256。这让我开始追问:Agent 增加的每一步,到底改变了什么?

本文目录

同样是校验,去留取决于用途。

两人隔案传递一卷文书,另一些未用的卷册留在一旁。

没有后续读取

result.csv 与未被读取的摘要文件

后续流程只读取结果文件。摘要没有参与交付,可以省掉。

参与发布判断

文件 → 摘要 → 发布校验器

发布校验器读取摘要,并在不匹配时拒绝发布。这一步应该保留。

情境对照:去留取决于摘要是否参与当前交付,完整判断依据见下方 Stop Ladder。

如何工作

给使用编码 Agent 的人

先明确任务与验收条件

需要交付什么,允许哪些动作。

Skill 判断必要性

用 Stop Ladder 查找当前任务需要这一步的依据。

指导 Agent 取舍

完成请求与必要后续,省去没有依据的额外工作。

Guard 检查明确边界

核对已声明的模式、文件与动作边界。

检查受覆盖的动作

明确任务模式启用后,返回允许或拒绝结果。

Skill 提供判断建议;Guard 默认处于观察模式,只有明确任务模式启用后才约束受支持的 Host 动作路径。查看 Skill 与 Guard 的职责

别只说“不要过度工程”。沿着 Stop Ladder 找证据。

抽象的提醒很容易被新的未来场景绕过去。Stop Ladder 把判断拉回当前请求、可达代码、数据、部署状态和验收条件。

  • 用户要求了吗?
  • 它是完成当前结果所必需的吗?
  • 哪段可达代码、数据、用户决策、部署状态或验收条件证明了这一点?
  • 省掉它,当前任务会在哪里失败?

没有当前任务的证据,就不要把“以后可能有用”升级成“现在就做”。

阅读证据与方法

安装与支持

说明对应版本: 0.2.4

Codex 安装命令固定到下方版本。重启后,在 CLI TUI 的 /hooks 中对照该 tag 的 Hook 清单检查并信任命令;完整变更见 GitHub Release。STSS Skill 也可以单独安装。

CODEX / POWERSHELL
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

GitHub 安装文档

常见问题

使用与安装

这是什么工具?

它是一套面向 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 为准。

GitHub 安装文档

接着读

只让 Codex 导出一个文件,它却多做了一份 SHA-256

AI Agent 的防御性工程,是怎么一步步长出来的?

Stop That Shit 与 AGENTS.md 有什么区别?

查看项目源码

返回项目介绍