К основному содержанию
плагин CX Codex

stop-that-shit — плагин для Claude Code: блокировка правок при ревью

Плагин stop-that-shit ограничивает действия ИИ-агента, пресекая лишний рефакторинг, фиктивные проверки и самовольное редактирование файлов при ревью.

MIT ★ 4 050 обновлён 2026-10-27

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add lennney/stop-that-shit
/plugin install stop-that-shit@stop-that-shit
Открыть на GitHub

Что делает stop-that-shit

Плагин объединяет инженерные правила (Skill) и программные перехватчики (Guard). Его логика построена вокруг четырёх нежелательных паттернов: разрастания рамок задачи, бесполезных защитных слоёв вроде нечитаемых контрольных сумм, нарушения изначальной цели пользователя и зацикливания проверок без реальных изменений в коде.

Слой Guard перехватывает команды прямо перед запуском инструментов. В режимах review, answer или monitor агент не сможет изменить ни одного файла. Для задач с правками предназначен режим change, где доступную область можно ограничить параметром files=. Без явного флага deps=allow плагин сразу заблокирует установку любых сторонних пакетов, даже если агент сочтёт их удобными.

Для запуска расширения в среде хоста требуется Node.js 18 или новее.

Какие задачи решает

  • заблокировать изменение файлов во время проверки кода
  • пресечь самовольное добавление новых библиотек
  • ограничить число запускаемых субагентов
  • отсечь генерацию неиспользуемых хешей и лишних обёрток

Примеры запросов агенту

  • /stop-that-shit:stop-that-shit review -- Проверь diff и только выведи список проблем, файлы не меняй.
  • /stop-that-shit:stop-that-shit change files=src/config.cjs -- Исправь чтение конфига без правок соседних файлов.
  • /stop-that-shit:stop-that-shit change deps=allow -- Установи нужный парсер и обнови тесты.

Как установить stop-that-shit

Через маркетплейс плагинов

/plugin marketplace add lennney/stop-that-shit
/plugin install stop-that-shit@stop-that-shit

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о stop-that-shit

Как установить stop-that-shit в Claude Code?

Сначала добавьте репозиторий в каталог командой /plugin marketplace add lennney/stop-that-shit, а затем выполните /plugin install stop-that-shit@stop-that-shit.

Что означает SHIT в названии?

Это четыре проблемы агентов: Scope creep (раздувание рамок), Hashing (фиктивные защитные механизмы), Intent violation (нарушение указаний) и Task thrashing (бесполезные повторные проверки).

Какие системные требования нужны для работы?

Окружению хоста требуется установленный Node.js версии 18 или выше.

Исходный текст

SKILL.md · MIT
<p align="center">
  <img src="assets/stop-stamp.svg" alt="Stop That Shit(别再造史了)AI Agent 任务边界 Guard 的红色 STOP 印章" width="240">
</p>

<h1 align="center">Stop That Shit(别再造史了)</h1>

<p align="center">
  <a href="https://github.com/lennney/stop-that-shit/releases"><img src="https://img.shields.io/github/v/release/lennney/stop-that-shit?include_prereleases&sort=semver&style=flat-square&color=111111&label=release" alt="最新版本"></a>
  <a href="https://github.com/lennney/stop-that-shit/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/lennney/stop-that-shit/ci.yml?branch=main&style=flat-square&label=build" alt="构建状态"></a>
  <img src="https://img.shields.io/github/license/lennney/stop-that-shit?style=flat-square&color=111111" alt="MIT 许可证">
</p>

<p align="center">
  <em>把活干完。把多余的停下。</em>
</p>

<p align="center">
  Skill + Guard,帮 AI coding agent 停止无用防御和任务越界。<br>
  Codex · Claude Code · OpenCode · Hermes Agent CLI · Pi<br>
  <a href="#shit-是哪四种">SHIT 哲学</a> ·
  <a href="#前后对比">看个例子</a> ·
  <a href="#快速安装">安装</a> ·
  <a href="cases/README_CN.md">案例库</a> ·
  <a href="README_EN.md">English</a> ·
  <a href="README_KO.md">한국어</a>
</p>

---

你只让 Agent 导出一个文件,它顺手算了份没人读取的 SHA-256,说是“以防万一”。

你让它 Review,它找到问题就开始改。你让它修一个点,它又想重构旁边的模块。检查已经回答了当前问题,它还想再拉一个 Agent,“最后确认一下”。

理由一个比一个严谨。东西还没交付,token 已经花了一截,你还得盯着它,别让任务继续跑偏。

**活还没拿到,我先当上了 Agent 的监工。**

我也试过往 `AGENTS.md` 里补规则:“不要乱改”“别过度设计”“没让我做的先别做”。每气一次就补一条,写着写着,`AGENTS.md` 自己也开始造史了。

**Stop That Shit。别再造史了。** 该干的干完整,没用的别往上堆。

## SHIT 是哪四种

我们把这些行为叫作 SHIT:

- **S — Scope creep,范围膨胀。** 修一个问题,顺手重构无关模块。必要的调用方、数据迁移和测试要一起处理;没有当前用途的扩展就停下。
- **H — Hashing & hypothetical hardening,无用防御。** 没人读取的 checksum、为想象中的未来搭的兼容层。防御要能发现问题,并触发拒绝、恢复或诊断。有效的保留,无用的省掉,吞错报成功或制造重复副作用的修好。
- **I — Intent violation,意图越界。** 说了只读 Review,文件还是被改了。审查就报告问题,修改需要授权。用户划的边界必须算数。
- **T — Task thrashing,任务打转。** 没有新问题或变化,读过、测过、审过的又来一遍。能回答当前问题的证据就复用;代码或验收条件变了,再补相关验证。做完、验证充分,就结束。

**把当前责任承担完整,让复杂度随真实需要增长。** 需要多改几个文件、补齐迁移或跑跨组件测试,就做完整。

## 前后对比

下游只读取 `report.csv`,没有发布校验,摘要也没有其他用途。导出逻辑却写成了这样:

```js
await writeFile("report.csv", csv);
await writeFile("report.csv.sha256", createHash("sha256").update(csv).digest("hex"));
```

按 STS 的判断,保留:

```js
await writeFile("report.csv", csv);
```

这个简化示例省掉了无用校验和,文件照常交付。更多场景见[案例库](cases/README_CN.md)。

如果发布流程会读取 checksum,并在不一致时拒绝使用文件,就保留,用 `hash=allow` 放行。

**必要的工作要做全。** 修复配置迁移时,旧数据已经发布且仍需支持,就把迁移、读写双方和兼容性测试一起补齐。哪怕 diff 更大,也不能留下坏掉的调用方。

## 验证到了什么

公开的 18 个 Bad/Good 判定用例,检查规则能否停下多余动作、保留必要工作,覆盖只读审查、必要调用方、已发布数据迁移、发布校验和,以及文件、依赖和 subagent 边界。模型在真实任务中的表现另看对照运行。

[完整证据](EVIDENCE.md)记录测试、历史 Codex / GPT-5.6 运行和没有差异的结果;复现方法见[对照测试说明](evals/codex-paired/README.md)。

## 它怎么判断

遇到这些 SHIT,先读相关代码、查清调用链,再按顺序判断:

```text
1. 当前要交付什么?     → 明确结果、授权和已有支持承诺
2. 已有能力够用吗?     → 从直接可用的方案开始
3. 还有什么具体缺口?   → 补齐现在需要的行为和保障
4. 这层防御起什么作用? → 保留有效的,省掉无用的,修正有害的
5. 结果验证完成了吗?   → 没有范围内阻塞,就结束
```

先看已有代码、标准库、平台原生能力和已安装依赖。符合所需行为和状态生命周期的就用,有具体缺口再加机制。

新机制说不清用途,可以暂缓;已有保护用途不明,先查清再动。真实的信任边界和已有支持承诺,都足以说明保护的必要,不必等事故发生。

代码行数、文件数量和检查次数不能代替判断。[完整规则](skills/stop-that-shit/SKILL.md)。

## 快速安装

一般宿主需要 Node.js 18+;Pi 0.84.4 自身要求 Node.js 22.19+。完整安装说明见 [INSTALL.md](INSTALL.md)。

展开你使用的宿主。只想用规则、不需要执行拦截,可以[只装 Skill](INSTALL.md#optional-skill-only)。

<details>
<summary>Claude Code</summary>

下载并解压 [0.2.5 源码](https://github.com/lennney/stop-that-shit/archive/refs/tags/0.2.5.zip),在仓库根目录执行:

```bash
claude plugin validate .
claude plugin marketplace add ./
claude plugin install stop-that-shit@stop-that-shit
```

重启 Claude Code 或执行 `/reload-plugins`,然后使用:

```text
/stop-that-shit:stop-that-shit review -- Review 这个 diff,只报告问题,不要修改。
```

</details>

<details>
<summary>Codex</summary>

```bash
codex plugin marketplace add lennney/stop-that-shit --ref 0.2.5
codex plugin add stop-that-shit@stop-that-shit
```

`--ref` 把安装固定到版本 tag,不跟随可变的 `main`。重启 Codex。在新的 CLI TUI 中输入 `/hooks`,对照[该 tag 的 Hook 清单](INSTALL.md#review-the-packaged-hooks)检查并信任命令。也可以把 [`INSTALL_FOR_AGENTS.md`](INSTALL_FOR_AGENTS.md) 交给 Codex,让它完成非交互步骤。

</details>

<details>
<summary>OpenCode 从 GitHub 安装</summary>

OpenCode 1.18.18 或更高版本可以全局安装这个仓库,无需 clone:

```bash
opencode plugin github:lennney/stop-that-shit -g
```

重启 OpenCode 后用 `$stop-that-shit review -- ...` 设置契约。该命令安装 Guard;内置 Skill 和可选 `/sts` 别名不会自动注册。详见 [INSTALL.md](INSTALL.md#opencode-install-from-github)。

</details>

<details>
<summary>Hermes Agent CLI</summary>

需要 Node.js 18+。

```fish
hermes plugins install lennney/stop-that-shit/.hermes-plugin --no-enable
hermes plugins enable stop-that-shit
hermes plugins list
```

启用后,CLI 用户需要启动新的 Hermes CLI 进程或会话;Gateway 用户需要执行:

```fish
hermes gateway restart
```

这些操作不需要每次使用插件时重复。只有启用、禁用、更新、回滚或重装插件后,
才需要重启对应的 Hermes 进程。

</details>

<details>
<summary>Pi Coding Agent</summary>

当前适配固定验证 `@earendil-works/pi-coding-agent` `0.84.4`。从包含该
Adapter 的本地 checkout 安装:

```bash
pi install /absolute/path/to/stop-that-shit
```

启动新的 Pi 进程,或修改资源后在 TUI 执行 `/reload`。然后使用:

```text
/skill:stop-that-shit review -- Review 这个 diff,只报告问题,不要修改。
```

从上述固定 tag 安装即可获得 Pi Adapter 和两个 Skill。详见 [INSTALL.md](INSTALL.md#pi-coding-agent)。

</details>

<details>
<summary>Oh My Pi</summary>

已在 `@oh-my-pi/pi-coding-agent` `18.4.4` 验证独立 Extension。
0.2.5 包含 OMP 独立 Extension;从该版本源码或解压后的发布包启动:

```bash
omp -e /absolute/path/to/stop-that-shit/omp/stop-that-shit.ts --skills /absolute/path/to/stop-that-shit/skills --sts-contract "review agents=0 -- inspect"
```

确认扩展加载后,发送 `/sts change -- ...` 切换模式,`/sts status` 查看合同。
该原生命令也用于 RPC。TUI 还支持首行 `$stop-that-shit` 指令。
详见 [INSTALL.md](INSTALL.md#oh-my-pi)。

</details>

## 使用

在 Codex 或支持宿主无关指令的 prompt 中,把一条指令放在消息首个非空行,不要包在引用或代码块里。用 `--` 分隔任务正文:

```text
$stop-that-shit review -- Review 这个 diff,只报告问题,不要修改。
$stop-that-shit change -- 修复配置读取失败,补齐受影响的调用方和检查。
```

Claude Code 插件用 `/stop-that-shit:stop-that-shit`,Pi Skill 用 `/skill:stop-that-shit`。

| 指令 | 用途 |
| --- | --- |
| `review` | 审查并报告问题 |
| `answer` | 回答问题 |
| `monitor` | 持续检查和报告 |
| `change` | 允许完成任务需要的修改 |
| `watch` | 观察动作,不阻断 |
| `status` / `runtime` | 查看当前状态和本地记录 |

需要更具体的边界时,加上参数:

```text
$stop-that-shit lock change files=src/config.cjs|test/config.test.cjs -- 修复这个行为。
$stop-that-shit change deps=allow -- 添加我要求的解析器依赖。
$stop-that-shit change hash=allow -- 生成发布流程需要的校验和。
$stop-that-shit change agents=1 -- 使用一个独立测试 subagent。
```

还不知道全部受影响文件,就别急着锁 `files=`。先沿调用链查清楚。

### 红章管到哪里

Skill 负责工程判断。Guard 在受支持的工具调用前检查明确边界:

| 动作 | Guard 启用后的默认处理 |
| --- | --- |
| 在 `review`、`answer` 或 `monitor` 中写文件 | 停止 |
| 添加依赖 | 询问;`deps=allow` 放行 |
| 启动 subagent | 超出 `agents=N` 预算时停止 |
| 添加可识别的 hash 操作 | 停止;`hash=allow` 放行 |
| 写入 `files=` 之外的路径 | 停止 |

Guard 不会看到 `cache`、`retry` 或 `migration` 就替你断定它们多余。宿主事件如何接入,见 [Adapter 合同](HOST-ADAPTER-CONTRACT.md)。

## 可选:Stop That Shit Slop(别再废话)

Agent 活干完了,嘴还没停。STSS 删掉无用辩护、收紧重复犹豫,保留影响理解与决定的条件。它也用于文章和图注,处理起草时附加的防御性说明。这是固定离线案例中的一组:

```text
输入:我们也许大概有可能在六到八周内完成迁移,具体取决于访问审批。
输出:预计六到八周完成迁移,前提是获得访问审批。
```

时间范围和审批条件都保留。如果审批必须在工作开始前完成,就应明确写成“获得审批后,预计需要六到八周”。

完整插件包含 STSS;它也可以单独安装,不需要 Hook。在仓库根目录执行:

```bash
npx skills add ./skills/stss --global
```

`rewrite` 改写文本,也是贴出文本时的默认模式;`audit` 只报告问题和最小修改建议。

| 宿主 | 改写 | 审核 |
| --- | --- | --- |
| Codex | `$stss rewrite -- 把这个提案写直接。` | `$stss audit -- 找出防御性废话。` |
| Claude Code 插件 | `/stop-that-shit:stss rewrite -- ...` | `/stop-that-shit:stss audit -- ...` |
| Claude Code 单独 Skill | `/stss rewrite -- ...` | `/stss audit -- ...` |
| Pi | `/skill:stss rewrite -- ...` | `/skill:stss audit -- ...` |

完整方法见 [STSS Skill](skills/stss/SKILL.md),成对案例和必须保留的反例见 [STSS examples](skills/stss/references/examples.md)。

## FAQ

**所以 checksum 都该删?**

发布完整性校验、去重、跳过重复处理,都可以是实际用途。对照可信来源给出的预期摘要,发现文件不一致就拒绝使用,即使多算一次也值得。需要做就用 `hash=allow` 放行。Guard 检查授权,具体用途仍要根据任务判断。

**刚装上,为什么还没拦?**

安装后默认是 `OBSERVING / unconfirmed`。显式使用 `review`、`answer`、`monitor` 或 `change` 后,Guard 才进入 `ARMED`。`watch` 始终只观察。只装 Skill 则没有执行拦截。

**红章是不是说明动作绝对没执行?**

`permission_deny_returned`(OpenCode 为 `execution_denial_returned`)表示 Guard 返回了拒绝响应。宿主最终是否执行要单独观测,所以 Runtime 将其记为 `hostEffect: unobserved`。安全隔离由宿主 sandbox 负责。

**会保存我的代码和对话吗?**

Runtime 事件不保存代码或对话正文;会话状态另存显式路径、关联 ID 和指令错误等控制信息。分享插件数据前应先检查会话状态,详见 [PRIVACY.md](PRIVACY.md)。

**怎么更新、卸载或参与开发?**

见[更新检查](INSTALL.md#check-for-updates)、[停用与卸载](INSTALL.md#disable-or-uninstall)、[本地开发](INSTALL.md#local-guard-development)和[更新记录](CHANGELOG.md)。

## 把反例发过来

Agent 又造史了?[提交 Bad Case](https://github.com/lennney/stop-that-shit/issues/new?template=bad-case.yml)。

STS 拦住了真正必要的工作?[提交 Good Case](https://github.com/lennney/stop-that-shit/issues/new?template=good-case.yml)。这个同样重要。

说清你的请求、它多做或少做了什么,以及哪个事实会改变判断。参考[案例库](cases/README_CN.md),脱敏和复现方法见[贡献指南](CONTRIBUTING.md)。

我不想再往 `AGENTS.md` 里补一百条“不要”,只希望新案例能让下一次判断更准。

觉得有用,给个 [Star](https://github.com/lennney/stop-that-shit)。也欢迎在 [LINUX DO](https://linux.do) 交流。

## License

[MIT](LICENSE)

© Stop That Shit contributors · MIT · lennney/stop-that-shit

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
include-test-files-that-assert-on-behavior-being-changed-in-decl ZaxbyHub Скилл include-test-files-that-assert-on-behavior-being-changed-in-decl для Claude Code включает в scope задачи тесты изменяемого поведения, чтобы агент исправлял код вместе с проверками. CX Codex +1 ★ 539звёзд репо full-stop t3dotgg Запускается, когда в запросе звучит «full stop», даже как заключительное усиление. Он готовит pull request к слиянию, но оставляет его открытым. CX Codex +1 1 300установок claude-harness Chachamaru127 Плагин claude-harness для Claude Code ведёт задачу через план, выполнение и отдельную проверку. Он сохраняет спецификацию и список задач в файлах проекта. ★ 3 219звёзд репо update-or-delete-tests-that-assert-intentionally-removed-behavio ZaxbyHub Скилл update-or-delete-tests-that-assert-intentionally-removed-behavio для Claude Code обновляет или удаляет тесты на намеренно убранное поведение. Подключается к задачам, где меняют или удаляют код. CX Codex +1 ★ 539звёзд репо stop-slop Hardik Pandya (https://hvpandya.com) Скилл stop-slop убирает из прозы шаблонные признаки текста от ИИ. Он пригодится при написании, редактировании и проверке материалов. CX Codex +1 20 300установок harness-engineering официальный github Скилл harness-engineering для GitHub Copilot превращает повторяющиеся ошибки агентов в правила репозитория: инструкции, проверки и память о сбоях. Делает репозиторий надёжнее для агентов. CX Codex +1 366установок

Из того же набора3

Спонсоры проекта

Компании, которые помогают держать аналитику открытой