跳到主要内容

STOP THAT SHIT / 别再造史了

Stop That Shit:只要一个结果,为什么 AI 还要生成 SHA-256?

给 Coding Agent 一条清楚的任务边界。该做的 caller、fixture 和测试继续做;没有请求、没有当前证据、删掉也不影响验收的工作,到此为止。

TASK RECEIPT / HASHSTOP
REQUEST
导出 result.csv
REQUIRED
EXTRA
生成 result.csv.sha256
UNASKED
CONSUMER
后续没有命令读取
NONE
DECISION
停止这一步
STOP

01 / TASK DRIFT

Stop That Shit 的 SHIT 模式是什么?

SHIT 不是一个单独的执行模式,而是四类任务漂移的记忆缩写。每一步单看都像工程实践,合在一起却可能已经不是用户要求的任务。

S

Scope creep

修一个点,顺手重构半个项目。

H

Hashing & hardening

没有消费者,仍然添加摘要、guard 或兼容层。

I

Intent violation

用户只让 Review,Agent 却直接修改文件。

T

Task thrashing

已经查过、测过、审过,又从头来一轮。

02 / STOP LADDER

别只说“不要过度工程”。问四个问题。

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

  1. 01

    用户要求了吗?

  2. 02

    它是完成当前结果所必需的吗?

  3. 03

    哪段可达代码、数据、用户决策、部署状态或验收条件证明了这一点?

  4. 04

    省掉它,当前任务会在哪里失败?

四个问题都没有答案,就不要把“以后可能有用”升级成“现在就做”。

03 / BAD CASE + GOOD CASE

同一个关键词,结论可以相反。

BAD / NO CONSUMER

给两份 CSV 的每一行算 SHA-256。

算完以后仍然逐行比较。Hash 没有替代任何操作,也不改变下一步。

STOP / UNNECESSARY HASH
GOOD / REQUIRED CONSUMER

生成发布流程要求的 checksum。

Release verifier 会读取摘要;不一致时拒绝产物。少了它,当前发布会失败。

ALLOW / hash=allow

04 / INSTALL

Stop That Shit 插件怎么安装?

Codex 安装固定到公开的 0.1.0 Release。重启后,在 CLI TUI 的 /hooks 中检查并信任 UserPromptSubmit 与 PreToolUse。

CODEX / POWERSHELL
codex plugin marketplace add lennney/stop-that-shit --ref 0.1.0
codex plugin add stop-that-shit@stop-that-shit

需要 Node.js 18+。完成 Hook 检查后,新任务里用 $stop-that-shit review 或 $stop-that-shit change 写明授权。

阅读完整安装与信任说明

同一套任务边界,四种 Host 接入

  1. 01CodexPlugin + UserPromptSubmit / PreToolUse
  2. 02Claude CodePlugin + native lifecycle Hooks
  3. 03OpenCodeGitHub plugin + before-action denial
  4. 04Hermes Agent CLINative plugin callbacks

05 / FIELD NOTES

三个角度,把问题说透。

先认出无人消费的 SHA-256,再判断防御性工程什么时候必要,最后把 Skill、Guard 和任务模式接进真实工作流。

06 / FAQ

八个常见问题。

01Stop That Shit 是什么?

它是一套面向 AI coding agent 的任务边界 Skill + Hook Guard。Skill 用 Stop Ladder 做语义判断;Guard 在受覆盖的 Host 动作路径上检查明确的模式、依赖、hash、文件和 subagent 边界。

02Stop That Shit 是 Skill 还是插件?

两者都是。独立 Skill 提供 Stop Ladder 和 review/change 等任务模式,属于建议性指导;完整插件还包含 Guard 与 Host Adapter,能在受支持的 Hook 路径上检查明确边界。

03Stop That Shit 插件怎么安装?

Codex 安装时先把 marketplace 固定到公开的 0.1.0,再安装 stop-that-shit 插件。需要 Node.js 18+;重启后在 CLI TUI 的 /hooks 中检查 UserPromptSubmit 与 PreToolUse,然后在新任务中显式使用 review 或 change。

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

AGENTS.md 适合记录仓库长期有效的架构、命令和约定。Stop That Shit 不替代这些上下文;它让用户为当前任务声明 review/change、文件、依赖、hash 和 subagent 边界,并在受支持的 Hook 路径上检查明确动作。

05Stop That Shit 的 SHIT 模式是什么?

SHIT 不是单独的执行模式,而是四类任务漂移的缩写:Scope creep(范围膨胀)、Hashing and hypothetical hardening(无消费者的摘要与假设性防御)、Intent violation(意图越界)和 Task thrashing(任务打转)。真正的任务模式是 review、answer、monitor 和 change 等。

06Stop That Shit 有哪些局限性?

它只能检查 Host 已提供、并且输入足够明确的 Hook 事件,不是安全沙箱,也不会看到 migration、retry 或 cache 就自动判定多余。Guard 返回拒绝只说明它发出了拒绝响应,不证明已观察到 Host 的最终执行结果。

07它会禁止所有 Hash 或 checksum 吗?

不会。发布验证、跳过大文件重复读取等有明确消费者的摘要应该保留。0.1.0 对可识别的新 hash 动作要求明确授权,可用 hash=allow 放行。

08当前支持哪些 AI coding agent?

0.1.0 提供 Codex、Claude Code、OpenCode 和 Hermes Agent CLI 四套 Adapter。每个 Host 的安装、信任、重启和事件覆盖范围并不完全相同。

SOURCE / CASES

少做一步,也要有证据。

检查源码和 0.1.0 证据;如果规则放过了多余工作,提交 Bad Case。如果规则拦住了真正必要的工作,提交 Good Case。