lennney/stop-that-shit

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

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

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

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

---

工作原理

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

决策流程记录在 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 – 提供专用的适配器和两个技能（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 为你提供了一个可配置的守护者，让代理专注于真正的交付物，同时在确实需要额外工作时允许显式覆盖。