kangraemin /bouncer-status
ai-bouncer 설치 상태와 설정을 보여주는 스킬. 빠르게 동작해야 한다.
2단계 출력
Step 1: 설정 즉시 출력 (config.json 읽기만)
먼저 config.json을 읽어서 설정을 즉시 보여준다. python 스크립트 쓰지 말고 cat이나 jq로 빠르게.
# 로컬 우선, 없으면 전역
LOCAL_CONFIG="$(git rev-parse --show-toplevel 2>/dev/null)/.claude/ai-bouncer/config.json"
GLOBAL_CONFIG="$HOME/.claude/ai-bouncer/config.json"
출력:
📋 ai-bouncer 설정
범위: global (~/.claude)
커밋 전략: per-step
커밋 스킬: true
실행 모드: hooks
에이전트 모드: team
docs git 추적: false
건강 진단 중...
config.json이 없으면:
📋 ai-bouncer: ❌ 미설치
로컬/전역 모두 config.json 없음.
설치: bash <(curl -fsSL https://raw.githubusercontent.com/kangraemin/ai-bouncer/main/install.sh)
→ 여기서 종료.
Step 2: 건강 진단 (설정 출력 후)
"건강 진단 중..." 출력한 뒤 아래 항목을 확인한다.
2-1. 업데이트 확인
bouncer-update-check.sh를 사용해서 업데이트 필요 여부를 확인한다.
# 로컬 또는 전역에서 bouncer-update-check.sh 찾기
UPDATE_CHECK="$TARGET_DIR/scripts/bouncer-update-check.sh"
[ -f "$UPDATE_CHECK" ] || UPDATE_CHECK="$HOME/.claude/scripts/bouncer-update-check.sh"
bash "$UPDATE_CHECK" --check-only 2>/dev/null
결과에 따라:
up-to-date→✅ 최신 버전update-available→⚠️ 업데이트 있음 (현재: xxx → 최신: yyy)- 실패 →
❓ 확인 불가
업데이트가 있으면 진단 결과 출력 후 "업데이트할까요?" 라고 물어본다. 사용자가 동의하면 /update-bouncer 스킬을 실행한다.
2-2. Hook 등록 상태
매번 GitHub remote에서 최신 hooks.json을 fetch해서 required hooks 목록을 동적으로 구성한다.
REPO="${AI_BOUNCER_REPO:-kangraemin/ai-bouncer}"
RAW_BASE="https://raw.githubusercontent.com/$REPO/main"
REMOTE_HOOKS_JSON=$(curl -sf --max-time 5 "$RAW_BASE/hooks/hooks.json" 2>/dev/null)
# fetch 실패 시 로컬 설치본 fallback
[ -z "$REMOTE_HOOKS_JSON" ] && REMOTE_HOOKS_JSON=$(cat "$BOUNCER_DATA_DIR/hooks/hooks.json" 2>/dev/null || echo "{}")
REMOTE_HOOKS_JSON에서 {event: [{matcher, file}]} 구조를 파싱해 hook 목록을 추출한다.
각 hook에 대해 3단계 판정:
# a. settings.json 등록 여부
# b. 파일 존재 여부 ($BOUNCER_DATA_DIR/hooks/<file>)
# c. 파일 내용 일치 여부:
REMOTE_FILE=$(curl -sf --max-time 3 "$RAW_BASE/hooks/<file>" 2>/dev/null)
LOCAL_FILE=$(cat "$BOUNCER_DATA_DIR/hooks/<file>" 2>/dev/null)
# md5 또는 sha256 비교
판정 기준:
- ✅ 등록됨 + 파일 존재 + 내용 최신 (remote와 일치)
- ⚠️ 등록됨 + 파일 존재 + 내용 구버전 (remote와 다름)
- ⚠️ 등록됨 + 파일 없음
- ❌ 미등록
- ❓ curl 실패로 확인 불가 (로컬 기준으로 fallback)
2-3. CLAUDE.md 규칙
grep -q 'ai-bouncer-rule' "$TARGET_DIR/CLAUDE.md"
2-4. 파일 무결성
앞서 2-2에서 fetch한 REMOTE_HOOKS_JSON의 모든 file 값을 추출해,
해당 hook 파일이 $BOUNCER_DATA_DIR/hooks/ 하위에 실제 존재하고
내용이 remote와 일치하는지 확인한다. (2-2 fetch 데이터 재활용)
manifest.json은 보조 참고용 — remote hooks.json에 없는 파일은 체크 불필요.
2-5. 활성 태스크
find .ai-bouncer-tasks -name ".active" 2>/dev/null
진단 결과 출력
건강 진단 결과
업데이트: ✅ 최신 버전
Hook: ✅ 8/8 정상
CLAUDE.md: ✅ 규칙 주입됨
파일 무결성: ✅ 20/20
활성 태스크: 없음
문제가 있을 때만 상세 표시:
건강 진단 결과
업데이트: ⚠️ 업데이트 있음 (현재: abc1234 → 최신: def5678)
Hook: ⚠️ 6/8
❌ subagent-track.sh — 미등록
⚠️ bash-gate.sh — 등록됨, 파일 없음
CLAUDE.md: ❌ 규칙 없음
파일 무결성: ⚠️ 18/20
누락: agents/dev.md, agents/qa.md
활성 태스크: my-task (development/normal)
수정 방법: bash install.sh --config 또는 재설치
업데이트할까요?
규칙
- 읽기 전용 — 파일을 수정하지 않는다
- Step 1 (설정)을 먼저 출력한 뒤 Step 2 (진단)를 실행한다. 한번에 모으지 않는다.
- python 대신 jq/grep/bash를 써서 빠르게 동작한다
- 전역/로컬 둘 다 있으면 양쪽 다 보여준다