stop-that-shit

拦住 Codex 乱加依赖，让 AI 改动保持精简。

stop-that-shit 是一个针对 Codex CLI 的轻量级本地守卫工具，用 JavaScript 编写。它解决的是 AI 编程助手在完成小任务时过度工程化的问题，比如自动添加不必要的模块、子代理、依赖和哈希值。核心能力是拦截 Codex 的生成结果，通过规则检测并阻止这些冗余操作，确保代码变更保持最小化和聚焦。它采用本地优先的设计，不依赖云服务，配置简单，开发者可以自定义拦截规则。该项目适合希望严格控制 AI 生成代码质量、避免项目膨胀的开发者。

开源 free 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2358

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开发框架

开发团队lennney

所属国家

官网地址https://take-a-deep-breath0.com/zh/stop-that-shit

GitHubhttps://github.com/lennney/stop-that-shit

定价模式free

价格说明开源项目，免费使用

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型agent-skills,ai-agents,ai-coding,claude-code,codex,codex-cli,codex-plugin,developer-tools,guardrails,hermes-agent,local-first,opencode,overengineering,scope-control,yagni

GitHub 星标★ 2358

30天Star增速

HF 下载量

上线时间2026-08-11 00:00:00

最近更新2026-09-28 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-16

浏览次数10

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 18+（一般宿主通用要求）
Pi Coding Agent 0.84.4 自身要求 Node.js 22.19+
OpenCode 需 1.18.18 或更高版本
已安装目标宿主之一：Codex / Claude Code / OpenCode / Hermes Agent CLI / Pi

安装与启动步骤

1确认 Node 版本

安装前先确认本机 Node.js 版本符合要求：一般宿主需 18+，Pi 宿主需 22.19+。
```
node -v
```
2添加插件市场

以 Codex 为例添加插件市场，--ref 0.2.2 把安装固定到版本 tag，不跟随可变的 main 分支。
```
codex plugin marketplace add lennney/stop-that-shit --ref 0.2.2
```
3安装插件

从刚添加的市场安装 stop-that-shit 插件，包名格式为插件名@市场名。
```
codex plugin add stop-that-shit@stop-that-shit
```
4重启并信任 Hook

重启 Codex，在新的 CLI TUI 中输入 /hooks，对照打包的 Hook 清单检查并信任其中的命令。
```
/hooks
```
5发送首条指令

指令放在消息首个非空行、不要包在引用或代码块里，用 -- 分隔任务正文。
```
$stop-that-shit review -- Review 这个 diff，只报告问题，不要修改。
```
6按需收紧边界

需要更具体的边界时追加参数，例如锁定可改文件范围或放开依赖、哈希、子代理。
```
$stop-that-shit lock change files=src/config.cjs|test/config.test.cjs -- 修复这个行为。
```

关键配置

配置项	必填	说明	示例
`--ref`	是	安装时固定到版本 tag，避免跟随可变的 main 分支	`0.2.2`
`files=`	否	锁定本次允许修改的文件范围	`src/config.cjs\|test/config.test.cjs`
`deps=`	否	是否允许添加你要求的依赖	`allow`
`hash=`	否	是否允许生成发布流程需要的校验和	`allow`
`agents=`	否	允许使用的独立 subagent 数量	`1`

如何确认成功

重启 Codex 后在 TUI 输入 /hooks 能看到 stop-that-shit 的 Hook 清单；再发送 $stop-that-shit review -- … 能得到审查结果而非普通执行。

常见问题

Q：安装后为什么不生效？

A：Codex 安装后需要重启；Claude Code 需重启或执行 /reload-plugins；Hermes CLI 用户要启动新的进程或会话，Gateway 用户需执行 hermes gateway restart。

Q：只想用规则，不想装执行拦截怎么办？

A：README 说明可以只装 Skill，具体做法见 INSTALL.md 的 optional-skill-only 小节。

Q：OpenCode 装完找不到 Skill 或 /sts 别名？

A：opencode plugin github:lennney/stop-that-shit -g 只安装 Guard，内置 Skill 和可选 /sts 别名不会自动注册。

Q：不想每次都验证一遍，需要重复重启吗？

A：不需要。只有启用、禁用、更新、回滚或重装插件后，才需要重启对应的宿主进程。

Q：怎么把安装固定在某个版本？

A：安装时带上 --ref 0.2.2 之类的版本 tag，例如 codex plugin marketplace add lennney/stop-that-shit --ref 0.2.2。

注意事项

以上步骤基于 README 的 Codex 安装路径；Claude Code、OpenCode、Hermes、Pi 的安装命令各不同，完整说明见 INSTALL.md。
宿主无关的指令必须放在消息首个非空行，不能包在引用或代码块里，任务正文用 -- 分隔。
还不知道全部受影响文件时，先沿调用链查清楚，不要急着锁 files=。
本项目为本地优先设计，不依赖云服务，命令中无需配置密钥。

核心亮点

精准拦截 Codex 的过度工程化行为，如多余模块和依赖
本地优先，无云依赖，保护代码隐私
规则可配置，适配不同项目的精简需求

不足之处

仅针对 Codex CLI，适用范围有限
文档/社区待观察

适用场景

使用 Codex 进行小任务开发时防止代码膨胀
团队统一 AI 代码生成规范，减少审查负担
维护精简依赖的库或框架项目

替代项目

codex-guardrails、aider、continue

项目介绍

stop-that-shit 是开发框架领域的开源项目，由 lennney 开发，是 2026 年新上线的项目。

在全站 13,276 个收录项目中，它的 GitHub 星标数（2,358）位列前 30%，在开发框架分类中处于中上游。

近 44 天，它的 GitHub 星标从 110 增加到 2,358，净增 2,248。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-28。免费使用。

它主要面向的使用场景是：使用Codex进行小任务开发时防止代码膨胀。同类可对比的替代方案包括 codex-guardrails、aider、continue。

上一篇：torchdistill

下一篇：SimplerLLM