stop-that-shit

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 81 🐛 待处理 7 👀 关注 3

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3873

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，免费使用

项目预览

stop-that-shit 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类开发框架

开发团队lennney

官网地址https://lennney.com/zh/stop-that-shit

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议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 星标★ 3873

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

代码更新2026-11-10

仓库体积1.7 MB

本站数据更新2026-11-13

维护状态活跃

收录时间2026-08-16

浏览次数12

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-16 · 当前星标 ★ 3873

技术标签

agent-skills ai-agents ai-coding claude-code codex

使用教程

难度：入门约 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

上一篇：torchdistill

下一篇：SimplerLLM