lennney/stop-that-shit

Stop That Shit（别再造史了）｜面向 Codex/GPT 场景的多平台 Hook + Skill Guard：拦截 AI coding agent 无需求的哈希、校验和与任务范围膨胀。 A multi-platform Hook + Skill Guard for AI coding agents in Codex/GPT workflows: stop unrequested hashes, checksums, and task-scope creep.

Stop That Shit（别再造屎了）——AI 编码代理的守护者

它是什么 —— 一个轻量级插件/技能，位于 AI 驱动的编码助手（Codex、Claude Code、OpenCode、Hermes CLI、Pi 等）之前，阻止它们做不必要的工作。它编码了一组简单的规则（SHIT 哲学），用于检测四种常见的浪费行为：

字母	浪费行为
S – 范围蔓延	当只请求单个修复时，添加无关的重构或文件。
H – 哈希和假设性加固	生成校验和、兼容层或其他永远不会被使用的工件。
I – 意图违规	更改仅用于读取/审查的文件。
T – 任务抖动	在没有新信息的情况下重新运行相同的审查/测试循环。

当守护者检测到这些模式中的任何一种时，它会拒绝该操作（或要求显式覆盖），而不是让代理浪费令牌、时间或引入意外错误。

工作原理

技能 – 分析当前差异/请求，遍历调用图，并决定真正的交付物是什么。
守护 – 挂钩到主机工具（Codex、Claude Code、OpenCode、Hermes、Pi、Oh-My-Pi）并拦截文件写入、依赖安装、子代理生成、哈希生成等。
如果操作匹配 SHIT 模式，守护者要么：
- 停止它，返回 permission_deny_returned 响应，或
- 当用户提供明确标志（例如 hash=allow、deps=allow）时允许它。
守护者还可以在监视模式下运行，仅报告它会阻止的内容。

决策流程记录在 skills/stop-that-shit/SKILL.md 中，并遵循五步检查清单（要交付什么、现有能力、缺失的差距、防御的有用性、验证）。

安装（快速开始）

需要 Node 18+（Pi 0.84.4 需要 Node 22.19+）。

主机	安装命令
Claude Code	```bash
claude plugin validate .
claude plugin marketplace add ./
claude plugin install stop-that-shit@stop-that-shit

| **Codex** | ```bash
codex plugin marketplace add lennney/stop-that-shit --ref 0.2.5
codex plugin add stop-that-shit@stop-that-shit
``` |
| **OpenCode** | ```bash
opencode plugin github:lennney/stop-that-shit -g
``` |
| **Hermes CLI** | ```bash
hermes plugins install lennney/stop-that-shit/.hermes-plugin --no-enable
hermes plugins enable stop-that-shit
``` |
| **Pi Coding Agent** | ```bash
pi install /path/to/stop-that-shit
``` |
| **Oh My Pi** | ```bash
omp -e /path/to/stop-that-shit/omp/stop-that-shit.ts --skills /path/to/stop-that-shit/skills
``` |

安装后，重启主机进程（或运行主机特定的重载命令），守护即可就绪。

---

### 基本用法
命令作为提示的第一行发出（无需引号）。插件添加了一个 `/stop-that-shit`（或 `$stop-that-shit`）命名空间。

```text
$stop-that-shit review -- 审查此差异，仅报告问题，不要修改。
$stop-that-shit change -- 修复配置读取失败并添加任何必需的调用者。
$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 -- 生成校验和，因为发布管道需要它。

命令	作用
`review`	分析差异并列出 SHIT 违规，不更改代码。
`answer`	回答问题，同时仍执行保护。
`monitor`	持续监视会话并报告违规。
`change`	允许满足任务所需的最小修改。
`watch`	观察操作但从不阻止。
`status` / `runtime`	显示守护者的当前状态和记录的事件。

生态系统支持

Codex – 作为注册一组钩子的插件工作。
Claude Code – 通过 Claude 插件市场安装；使用 /stop-that-shit:stop-that-shit 调用。
OpenCode – 从 GitHub 全局安装；命令为 $stop-that-shit …。
Hermes Agent CLI – 作为 Hermes 插件添加；为所有后续 CLI 会话启用守护。
Pi Coding Agent – 提供专用的 Adapter 和两个技能（stop-that-shit 和 stss）。
Oh My Pi – 作为独立扩展提供，可通过 omp 加载。

“Stop That Shit Slop”（STSS）

一个可选的配套技能，用于精简散文中的防御性、填充性语言。它可以单独安装（npx skills add ./skills/stss --global），并提供两个命令：

rewrite – 重写段落，只保留必要的条件。
audit – 指出不必要的含糊其辞。

证据与测试

仓库附带 18 个精选的好/坏案例 以及完整的评估套件（evals/codex-paired）。结果、日志和确切的测试工具记录在 EVIDENCE.md 中。

许可证

MIT – 免费用于个人、学术或商业用途。

底线 —— 如果你使用 AI 驱动的编码代理，发现它们过度工程化、添加多余的校验和或偏离任务，Stop That Shit 为你提供了一个可配置的守护者，让代理专注于真正的交付物，同时在确实需要额外工作时允许显式覆盖。