lennney/stop-that-shit

Stop That Shit（别再造史了）｜面向 Codex/GPT 场景的多平台 Hook + Skill Guard：拦截 AI coding agent 无需求的哈希、校验和与任务范围膨胀。 A multi-platform Hook + Skill Guard for AI coding agents in Codex/GPT workflows: stop unrequested hashes, checksums, and task-scope creep.

무엇인가요

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) – 에이전트의 텍스트 출력에서 불필요한 방어적 언어를 제거하는 별도의 스킬

이들 기능은 에이전트의 집중을 유지하고 토큰 낭비를 줄이며, 자동화된 코드 파이프라인에서 의도치 않은 '스코프 확장'을 방지합니다.

사용 방법

설치: 사용 중인 에이전트용 플러그인을 설치합니다 (대부분의 경우 Node ≥ 18, Pi는 Node ≥ 22 필요). README에는 각 호스트용 단일 명령어가 제공됩니다.

실행: 호스트의 CLI를 통해 스킬을 실행합니다. 예:

$stop-that-shit review -- 이 차이를 검토하세요. 수정하지 마세요.
$stop-that-shit change hash=allow -- 제가 명시적으로 요청한 체크섬을 생성하세요.

필요 시 계약을 지정합니다. 예: files=src/config.cjs|test/config.test.cjs 는 에이전트가 접근할 수 있는 경로를 제한하거나, deps=allow 는 종속성 설치를 자동 승인합니다.
가드는 관찰 모드 로 시작합니다 (행동은 기록하지만 차단하지 않음). review, answer, monitor, change 로 전환하면 활성화되며, 허용되지 않은 행동은 명확한 STOP 응답을 트리거합니다:
```
STOP / INTENT
가드는 권한 거부를 반환했습니다.
이유: MODE_FORBIDS_MUTATION
```
텍스트만 정리가 필요한 경우, 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에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.