Stop That Shit:为 AI 编码 Agent 设任务边界的 Skill 与 Guard 工具
Stop That Shit 是一个面向 AI 编码 Agent 的开源工具,由 Skill 和 Guard 组成,用于减少无用防御和任务越界。Skill 负责工程判断,Guard 在受支持的工具调用前检查明确边界。文档说明其 SHIT 分类、判定顺序、各宿主安装与指令用法,并说明拦截能力的边界。
工具定位
Stop That Shit(简称 STS)是一个面向 AI 编码 Agent 的开源工具,由两部分组成:Skill 负责工程判断,Guard 在受支持的工具调用前检查明确边界。它要解决的行为被归为 SHIT 四类:
- S — 范围膨胀:修一个问题时顺手重构无关模块。必要的调用方、数据迁移和测试仍应一起处理。
- H — 无用防御:例如没人读取的 checksum,或为想象中的未来搭建的兼容层。有效防御应保留;吞错报成功或制造重复副作用的做法应修正。
- I — 意图越界:例如要求只读审查,文件仍被修改。审查只报告问题,修改需要授权。
- T — 任务打转:没有新问题或变化,却重复读过、测过、审过的内容;证据足够回答当前问题时就应复用。
判断顺序
原文给出的判定流程是:先明确当前交付物、授权和已有支持承诺;优先使用已有代码、标准库、平台原生能力和已安装依赖;再有具体缺口才补机制;对防御逐层判断保留、省略或修正;最后确认范围内没有阻塞即结束。原文强调代码行数、文件数量和检查次数不能代替判断。
Guard 的默认边界
Guard 启用后,在 review、answer 或 monitor 中写文件会被停止;添加依赖会询问,deps=allow 可放行;启动 subagent 超出 agents=N 预算时停止;可识别的 hash 操作默认停止,hash=allow 可放行;写入 files= 之外的路径会被停止。原文明确 Guard 不会仅凭 cache、retry 或 migration 等字样就判定其多余。
安装与使用
工具宣称支持 Claude Code、Codex、OpenCode、Hermes Agent CLI、Pi 和 Oh My Pi,各宿主安装命令不同,一般宿主需要 Node.js 18+,Pi 0.84.4 要求 Node.js 22.19+。安装后默认处于 OBSERVING / unconfirmed,需显式使用 review、answer、monitor 或 change 等指令才进入 ARMED;watch 始终只观察。只安装 Skill 则没有执行拦截。
在 Codex 等宿主中,把 $stop-that-shit review -- ... 这类指令放在消息首个非空行,用 -- 分隔任务正文。参数可用于锁定文件范围、放行依赖或校验和、限制 subagent 数量。
能力边界与验证
原文说明:拒绝响应由 Guard 返回,宿主最终是否执行需单独观测,Runtime 记为 hostEffect: unobserved,安全隔离由宿主 sandbox 负责。Runtime 事件不保存代码或对话正文,但会话状态另存显式路径、关联 ID 等控制信息。
公开验证方面,原文称有 18 个 Bad/Good 判定用例,覆盖只读审查、必要调用方、已发布数据迁移、发布校验和,以及文件、依赖和 subagent 边界,用于检查规则能否停下多余动作并保留必要工作;模型在真实任务中的表现另看对照运行。
另有一个可选组件 STSS(Stop That Shit Slop),用于删去文本中的无用辩护和重复犹豫,同时保留影响理解与决定的条件,可单独安装,提供 rewrite 与 audit 两种模式。
来源与核对说明
- lennney/stop-that-shit ↗https://github.com/lennney/stop-that-shit
本文经 AI 整理及独立自动校对,未做运行验证;自动校对仍可能遗漏问题,请以原始资料为准。
这篇内容对你有帮助吗?
点赞人数由服务器记录,收藏保存在当前浏览器。
继续阅读
Pro Workflow:为 Claude Code 等编码代理提供基于 SQLite 的记忆与知识库工具 →
TeaQL Agent Kit:用一句提示词接入 TeaQL 工作流的编码代理工具包 →