slopsquat-guard

name	slopsquat-guard
description	패키지를 설치하거나 새 import/의존성을 추가하기 '직전'에 발동하라. "npm install", "pip install", "yarn add", "pnpm add", "poetry add", "cargo add", "gem install" 을 실행하려 할 때 / requirements.txt·package.json·pyproject.toml·Cargo.toml·Gemfile 을 고쳐 새 패키지를 넣으려 할 때 / 코드에 설치가 필요한 외부·서드파티 패키지의 import·require 를 새로 추가하려 할 때(표준 라이브러리·프로젝트 내부/상대 import 는 제외) / "module not found"·"No module named"·"Cannot find module" 오류를 설치로 해결하려 할 때, 먼저 이 스킬로 패키지의 실존·평판을 검증하라. 검증 전에는 어떤 설치 명령도 실행하지 마라. (triggers: install package, add dependency, add library, add third-party import, fix module-not-found, npm/pip/yarn/pnpm/poetry/cargo/gem install)
allowed-tools	Bash, Read

slopsquat-guard — 설치 직전 패키지 검증 게이트

AI가 생성한 코드의 약 20%는 존재하지 않는 패키지를 참조하고, 그렇게 지어낸 이름의 약 43%는 같은 이름으로 반복 등장한다. 반복된다는 건 공격자가 그 이름을 미리 악성 패키지로 선점해 둘 수 있다는 뜻이다(슬롭스쿼팅). 비개발자는 module not found 오류가 뜨면 의심 없이 시키는 대로 설치한다 — 이 스킬은 바로 그 순간을 가로채 막는다.

🛑 절대 규칙 (HARD RULES)

1. 검증되지 않은 패키지를 자동 설치하지 않는다. 항상 사람 승인 게이트를 거친다.
2. 설치 명령을 먼저 실행하지 않는다. 검증 → 리포트 → (필요시) 승인 순서를 지킨다.
3. 🔴(차단)/🟡(주의)가 하나라도 있으면 설치를 멈추고 사용자 승인을 먼저 받는다.
4. 🔴는 사용자가 **"위험을 이해했고 그래도 진행한다"**고 명시적으로 답하기 전엔 진행 불가.
5. 설치는 잠금파일 고정 + 해시 검증으로만 한다(package-lock.json / requirements 해시 / poetry.lock / pnpm-lock.yaml / Cargo.lock 등).
6. 코드엔 있는데 레지스트리엔 없는 이름이면 **"AI가 지어낸 이름일 수 있다"**고 먼저 알린다.
7. 🔴는 화이트리스트에 넣지 않는다. 사용자가 위험을 감수하고 강제 진행하더라도 그건 '이번 한 번'일 뿐이며, approve로 영구 등록하는 것은 🟢/🟡 승인에만 허용된다(🔴를 등록하면 슬롭스쿼팅 우회로가 된다).

동작 절차 (이 순서를 지킨다)

참고: 아래 명령의 scripts/·references/·assets/ 경로는 모두 이 SKILL.md 가 있는 스킬 폴더 기준이다. 사용자 프로젝트 루트에서 실행할 때는 스킬 폴더의 절대경로를 앞에 붙여라 (예: python "<스킬폴더>/scripts/verify_packages.py" ... — Windows 등 경로에 공백이 있으면 큰따옴표로 감싼다).

1. 개입 시점 — 패키지를 설치하거나 코드에 새 import/의존성을 추가하기 직전에 멈춘다. 설치 명령을 먼저 실행하지 않는다.
2. 추출 — 추가하려는 패키지 이름과 생태계(npm / pypi / crates / rubygems)를 모은다.
3. 검증 — scripts/verify_packages.py 를 실행한다.

   python scripts/verify_packages.py --report --ecosystem pypi  <패키지...>
   python scripts/verify_packages.py --json '[{"name":"react","ecosystem":"npm"}]'
   python scripts/verify_packages.py --report --manifest requirements.txt   # 매니페스트 전체 자동 추출
   

   (--report = 한국어 리포트 텍스트, 인자 없이 = JSON. 종료코드: 🔴=2, 🟡=1, 전부 🟢=0. 매니페스트 파일을 수정해 새 패키지를 넣으려 할 땐 --manifest <파일> 로 한 번에 검사한다.)
4. 리포트 — 결과를 references/REPORT_FORMAT.md 형식의 한국어로 사용자에게 보여준다.
5. 게이트 — 🔴 또는 🟡가 하나라도 있으면 설치를 멈추고 명시적 승인을 요청한다. 승인 전까지 어떤 설치 명령도 실행하지 않는다.
6. 승인 후 설치 — 잠금파일 + 해시로만 설치한다. 화이트리스트(approve) 등록은 🟢/🟡 판정을 사용자가 승인한 경우에만 한다. 🔴를 강제 진행하면 이번 한 번만 설치하고 등록하지 않는다(다음에 다시 검증받게 둔다 — 스크립트도 기본적으로 🔴 등록을 거부한다. 의도적 강제 옵션이 있으나 일반 절차에서는 쓰지 않는다).

   python scripts/verify_packages.py approve <패키지> <생태계>           # 🟢/🟡 승인 기록 (🔴엔 쓰지 않는다)
   python scripts/verify_packages.py install-cmd <패키지> <생태계> [버전]  # 안전 설치 명령(잠금+해시) 생성
   

   install-cmd 가 출력한 명령을 그대로 실행한다(직접 설치 명령을 지어내지 않는다).

승인 후 안전 설치 명령 (잠금파일 고정 + 해시 검증)

• pip : pip-compile --generate-hashes 로 해시 박힌 requirements 생성 → pip install --require-hashes -r requirements.txt
• npm : npm install <pkg>@<정확한버전> --save-exact → 이후 npm ci (lockfile 무결성 검증)
• pnpm : pnpm add <pkg>@<버전> --save-exact → pnpm install --frozen-lockfile
• yarn : yarn add <pkg>@<버전> --exact → yarn install --immutable
• poetry : poetry add <pkg>@<버전> (poetry.lock 에 해시 기록) → poetry install
• cargo : cargo add <pkg>@<버전> (Cargo.lock 에 체크섬 기록)

워크드 예시

사용자: "이미지 처리 기능 추가해줘" → AI가 pip install image-utils-pro 를 실행하려 함. → 스킬 발동: 설치를 멈추고 python scripts/verify_packages.py --report --ecosystem pypi image-utils-pro 실행. → PyPI에 image-utils-pro 없음. → 리포트(스크립트 실제 출력):

📦 패키지 안전 점검 결과

🔴 차단 — image-utils-pro : Python(pip) 공식 패키지 목록(앱을 받는 공식 앱스토어 같은 곳)에 이런 이름이 없습니다(AI가 이름을 지어냈을 가능성). → 설치를 멈췄습니다. 진행하려면 승인이 필요합니다.

※ 이 중 하나라도 🔴/🟡가 있으면 제가 임의로 설치하지 않습니다.

→ "정확한 이미지 라이브러리(예: Pillow)를 찾아드릴까요?"라고 묻고, 승인 없이는 설치하지 않는다.

동봉 파일

• scripts/verify_packages.py — 실존·평판·타이포스쿼팅·교차 레지스트리·보안경고 검증(결정적 로직).
• assets/allowlist.json — 사전 승인 패키지 화이트리스트(재검증 없이 통과, deprecated·보안 취약점이면 예외).
• assets/denylist.json — 알려진 악성·사칭 차단 목록(존재해도 항상 🔴).
• references/REPORT_FORMAT.md — 사용자에게 보여줄 한국어 리포트 포맷.