/insane-review

/insane-review

사용자의 요청($ARGUMENTS)을 GPT-5.5 Pro(구독 웹)에게 보내 분석/의견을 받아 반영한다.

원칙: 사용자에게 CLI 타이핑을 시키지 않는다. 환경이 안 갖춰졌으면 Claude가 --check-env로 감지하고, 필요한 결정은 AskUserQuestion 선택지로 물어본 뒤 Claude가 대신 실행한다. 초보자도 클릭만으로 따라올 수 있어야 한다. (AskUserQuestion은 frontmatter allowed-tools에 절대 넣지 않는다 — 넣으면 자동승인돼 UI가 안 뜬다.)

Step 0 — 첫 실행 셋업 (1회, 자동)

가장 먼저 실행한다 — 부트스트랩: 업데이트 알림 훅 설치 + Python 의존성(pyperclip·playwright) 자동 설치. (repomix는 npx -y로 실행되어 사전설치 불필요.)

bash "${CLAUDE_PLUGIN_ROOT}/setup/setup.sh" ask

출력이 STAR_ASK로 시작하면 즉시 AskUserQuestion을 1회 호출한다 — 질문·선택지는 사용자의 현재 대화 언어로 작성한다(대화 언어가 분명하면 그것을, 아니면 STAR_ASK 뒤 언어코드 ko/ja/en을 사용; 무조건 한국어 기본값 금지).

• header: 짧은 현지화된 "GitHub Star" 라벨
• question: 이 플러그인(과 gptaku-plugins 마켓플레이스)에 GitHub ⭐로 응원할지 — 선택 안 해도 모든 기능은 그대로 작동
• options: 정확히 2개 — (1) 응원/스타 → bash "${CLAUDE_PLUGIN_ROOT}/setup/setup.sh" star yes; (2) 괜찮아요 → bash "${CLAUDE_PLUGIN_ROOT}/setup/setup.sh" star no

출력이 비어 있으면 조용히 넘어간다. 질문 외에는 부연하지 않는다.

Step 0.5 — 환경 온보딩 (브라우저·로그인; 선택지 기반, 막힌 단계만)

먼저 Claude가 직접 실행한다(사용자에게 시키지 말 것):

python3 "${CLAUDE_PLUGIN_ROOT}/bin/pack_and_ask.py" --check-env

마지막 줄 STATUS node=… deps=… browser=… login=…을 파싱한다. 전부 ok가 아니면, 막힌 첫 단계를 아래처럼 AskUserQuestion으로 물어보고 → 선택대로 Claude가 실행 → --check-env를 다시 돌려 재확인한다(최대 3~4회 반복).

• deps=missing → AskUserQuestion(header 의존성):
  • "지금 자동 설치 (추천)" → Claude가 --check-env --install 실행
  • "직접 설치할게요" → pip install playwright pyperclip 안내만
  • "취소"
• browser=down → --check-env 출력의 BROWSERS …(설치된 크로미움 목록)와 os= 로 분기한다. 항상 전용 프로필로 실행되므로 사용자 주 브라우저 세션은 건드리지 않는다. 실행은 open -a가 아니라 python3 "${CLAUDE_PLUGIN_ROOT}/bin/pack_and_ask.py" --launch-browser "<이름>" (크로스플랫폼·전용 프로필·선택 자동 저장)로 한다.
  • 2개 이상 감지 → AskUserQuestion(header 브라우저): BROWSERS의 각 브라우저를 선택지로 준다. 사용자 주 브라우저로 추정되는 것(현재 실행 중일 가능성)엔 "메인 추정 — 가급적 다른 것" 주석. 선택 → --launch-browser "<이름>" → 재점검.
  • 정확히 1개 감지(그게 사용자 메인일 가능성↑) → AskUserQuestion(header 브라우저):
    • "전용 브라우저 하나 설치 (추천)" → 가벼운 크로미움(Chrome/Brave 등)을 자동화 전용으로 따로 설치하도록 안내 (ChatGPT Pro 로그인해두고 그 창은 안 건드림). 설치 후 --launch-browser "<이름>". (왜: 메인과 같은 앱을 2창으로 띄우면 빈 프로필·오조작·일부 앱의 멀티인스턴스 불안정으로 혼란이 생긴다.)
    • "지금 이 브라우저의 격리 프로필로 진행" → --launch-browser "<그 이름>". 전용 프로필이라 메인과 분리되지만, 같은 앱 2창이라 자동화 창은 실수로 건드리지 말 것을 한 줄 고지.
    • "취소"
  • 0개 감지 → AskUserQuestion(header 브라우저): "크로미움 계열 브라우저가 없습니다 — 설치할까요?" → ["Chrome 설치 안내"/"취소"]
• browser=wrong(포트 점유) → AskUserQuestion(header 포트충돌): "9222를 다른 프로세스가 쓰고 있어요. 종료하고 전용 브라우저를 다시 띄울까요?" → ["다시 띄우기"(점유 프로세스 종료 안내 후 --launch-browser)/"취소"]
• login=no → AskUserQuestion(header 로그인): "방금 띄운 전용 브라우저 창에서 chatgpt.com 로그인 + GPT-5.5 Pro 선택을 끝낸 뒤 계속하세요. (전용 프로필이라 이 로그인은 계속 유지됩니다.)"
  • "로그인 완료 — 계속" → --check-env 재확인
  • "취소"
• node=missing → AskUserQuestion(header Node): "Node.js가 필요합니다(repomix 자동설치에 사용). 설치를 도와드릴까요?" → ["brew로 설치"/"직접 설치할게요"/"취소"] (brew 선택 시 brew install node)

STATUS … login=ok까지 가면 Step 1로. 사용자가 "취소"하면 멈추고 무엇이 남았는지 한 줄로 알려준다.

Step 1~ — 리뷰 실행

1. 의도 파악 — $ARGUMENTS(또는 직전 대화 맥락)에서 GPT Pro에게 물을 핵심 질문을 한 문장으로 정한다. 타겟/범위가 애매하면 AskUserQuestion으로 선택지를 줘서 고르게 한다(타이핑 요구 금지). 예) header 리뷰 대상, options = 후보 디렉토리들 + "프로젝트 전체" + "질문만(코드 없이)".
2. 타겟 선별(완전한 집합은 네 판단) — 코드면 의도에 직결된 모듈/디렉토리를 통째로(--target <dir>, 풀코드). 더 넓으면 import·호출자·테스트·설정까지 닫는다. --compress 금지(본문 누락). 순수 질문이면 생략.
3. 실행 (정확성 리뷰는 풀코드 + 모델검증):

   python3 "${CLAUDE_PLUGIN_ROOT}/bin/pack_and_ask.py" \
     --target <repo_or_dir> --include "<관련 파일 글롭 또는 생략=전체>" \
     --model pro --require-model "GPT-5.5" \
     --prompt "<의도 담은 질문 — 판정마다 파일:라인·코드조각 인용 강제>"
   

   • 응답이 오래 걸려도 되면 그대로(완전추론). 시간을 bound하고 싶으면 --force-answer-after <초>로 "거기까지 추론한 내용으로" 답을 받는다. 단독 리뷰는 보통 끄고(완전추론), council은 켜서 cap.
4. 누락 확인 — 출력의 📦 패킹 포함 N개 파일이 의도한 완전한 집합을 담았는지 확인(빠지면 §3.5 원인 제거).
5. 회수·반영 — 현재 프로젝트의 **.insane-review/response_*.md**를 읽고, GPT-5.5 Pro의 의견임을 명시해 반영하고 너의 판단(동의/이견)을 덧붙인다.

채팅 정리(기본 on): 매 실행은 일반 채팅 목록 대신 현재 폴더명과 같은 ChatGPT 프로젝트 안에 정리된다(폴더당 프로젝트 1개, 캐시 재사용·자동 생성·실패 시 일반채팅 폴백). 채팅이 일반 목록에 쌓이는 걸 막는다. 이름은 --project "<이름>", 끄려면 --no-project.

세부 절차·가드는 skills/insane-review/SKILL.md 참고. (Read는 참고용; 이 커맨드가 실행 지시서다.)