lennney/stop-that-shit

何であるか

Stop That Shit (別再造史了) は、Codex、Claude Code、OpenCode、Hermes Agent CLI、および Pi などの AI コーディングエージェント向けのプラグイン／ガードシステムです。ユーザーが明示的に依頼していない作業（例：後続ステップで読み込まれない SHA‑256 チェックサムの生成、防御的コードの追加、同じチェックの繰り返し実行など）をエージェントが行わないように、明確なタスク境界を定義できます。

なぜ重要か

大規模言語モデルエージェントにコーディングタスクを提示すると、しばしば「余分な」ステップを追加し、トークン、時間、場合によってはリポジトリを無駄に変更してしまいます。このプロジェクトは以下の機能を提供します：

• スキル – 行動が本当に必要かどうかを判断するための意味的ルール（Stop Ladder）のセット。
• ガード – ファイル書き込み、依存関係のインストール、サブエージェントの起動、ハッシュ生成など、エージェントの行動を実行時フックでインターセプトし、許可、明示的な承認の要求、または赤色の STOP メッセージでブロックします。
• アダプタ – 5つの対応エージェント（Codex、Claude Code、OpenCode、Hermes Agent CLI、Pi）からのイベントを共通の意思決定インターフェースに変換する薄いレイヤー。
• Stop‑That‑Shit Slop (STSS) – エージェントのテキスト出力から不要な防御的表現を削除する別スキル。

これらはエージェントの集中を保ち、トークンの無駄遣いを減らし、自動化されたコーディングパイプラインにおける誤った「スコープ拡大」を防ぎます。

使い方

1. インストール：お使いのエージェント用のプラグインをインストールします（ほとんどの場合 Node ≥ 18、Pi 用は Node ≥ 22）。README に各ホスト向けのワンライナーインストールコマンドが記載されています。
2. 実行：ホストのCLI経由でスキルを実行します。例：

   $stop-that-shit review -- この差分をレビューしてください。変更しないでください。
   $stop-that-shit change hash=allow -- 私が明示的に依頼したチェックサムを生成してください。
   

3. 必要に応じて契約を指定します。例：files=src/config.cjs|test/config.test.cjs でエージェントが操作できるパスを制限、deps=allow で依存関係のインストールを自動承認。
4. ガードは 観察モード で開始（行動を記録するがブロックしない）。review、answer、monitor、change に切り替えるとアーム化され、許可されていない行動が発生すると明確な STOP 応答が返されます：

   STOP / INTENT
   ガードは許可を拒否しました。
   理由: MODE_FORBIDS_MUTATION
   

5. テキストのみのクリーンアップが必要な場合、STSS スキルをインストールし、$stss rewrite … または $stss audit … を実行して不要な曖昧表現を削除または厳しくします。

対象ユーザー

• LLM駆動のコーディングアシスタントを使用し、決定論的で監査可能なビルドを望む 開発者。
• エージェントがワークフローによって明示的に承認された行動のみを実行することを保証したい チームリード / CIパイプライン。
• 安全なガード付きAIエージェントを研究する 研究者。プロジェクトにはペア評価データとレグレッションテストが同梱されています。

内容物

コンポーネント	役割
スキル（Stop Ladder）	4つの質問による意思決定フロー（ユーザーの依頼か？結果に必要か？証拠はあるか？省略すると受容性が損なわれるか？）をエンコード。
ガード（フック）	ファイル書き込み、依存関係インストール、サブエージェント起動、ハッシュ生成などをインターセプトし、スキルの判断を強制。
アダプタ	Codex、Claude Code、OpenCode、Hermes Agent CLI、Pi からのイベントを共通のガードインターフェースに変換。
STSS スキル	同じ意思決定ロジックを文に適用し、防御的表現を DROP、CALIBRATE、RELOCATE、KEEP のいずれかに決定。
テストスイート	ユニットテスト、ペア評価スクリプト、オフラインフィクスチャ付きの6つの良い/悪いケースバンドル。
ドキュメント	各エージェント向けインストールガイド、契約構文（files=, deps=, hash=, agents=）、貢献者向けのケースライブラリ。

成熟度

• 最新の安定版リリース 0.2.1（ファイルパス境界処理のバグ修正）。
• CIビルド、自動テスト、文書化されたリリースプロセス。
• MITライセンス、GitHubの通常のワークフローで貢献を歓迎。

---

すべての詳細はリポジトリのREADMEから直接取得されており、追加機能は推測されていません。