From vibe-check-mate
dev 서버를 로그 캡처 모드로 실행하고, 최신 .check-runtime 상태를 기준으로 런타임 에러를 분석 및 최소 수정한다.
How this skill is triggered — by the user, by Claude, or both
Slash command
/vibe-check-mate:runtime-auto-fixThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
개발 서버 실행 중 발생한 런타임 에러를 `.check-runtime/`에 최신 상태로 기록하고,
개발 서버 실행 중 발생한 런타임 에러를 .check-runtime/에 최신 상태로 기록하고,
이 폴더를 기준으로 원인 분석 및 최소 수정을 수행한다.
.check-runtime/는 항상 최신 dev 세션의 로그만 의미한다.pnpm run dev는 scripts/dev-runtime.sh를 통해 실행된다.scripts.dev가 bash ./scripts/dev-runtime.sh인지 확인한다.dev 값을 dev:raw로 이동한다.dev를 bash ./scripts/dev-runtime.sh로 교체한다.dev:raw가 이미 존재하면 덮어쓰지 않는다.scripts/dev-runtime.sh 존재 여부를 확인한다.chmod +x scripts/dev-runtime.sh
pnpm run dev를 실행한다..check-runtime/ 폴더가 최신 상태로 생성되는지 확인한다.Next.js, Vite, Remix 등 HMR 기반 dev server는 런타임 에러가 나도 프로세스가 종료되지 않는다. .check-runtime/runtime.log는 실시간으로 기록되지만 error-files.txt와 meta.txt의 ended_at/exit_code는 프로세스가 종료될 때만 갱신된다.
Ctrl+C로 dev server를 종료해 주세요"라고 안내..check-runtime/ 3파일 모두 준비된 것을 확인한 뒤에만 다음 분석 단계로 진행..check-runtime/runtime.log를 읽는다..check-runtime/error-files.txt를 우선 참조한다..check-runtime/를 단일 source of truth로 사용한다..check-runtime/error-files.txt에 등장한 파일만 우선 수정 대상으로 삼는다.meta.txt의 ended_at 없음, 로그 finalize 전) → 수정 X → 케이스 4 리포트 후 대기 (사용자가 Ctrl+C 후 재호출 필요).원인이 "코드 버그"로 분류돼 실제 수정이 반영된 경우에만 커밋을 제안한다. 자동 커밋은 하지 않는다.
git config user.name, git config user.email 둘 다 비어있지 않아야 한다. 비면 안내 후 제안 중단..git/MERGE_HEAD, .git/REBASE_HEAD, .git/CHERRY_PICK_HEAD, .git/REVERT_HEAD 중 하나라도 존재하면 제안 중단.git diff --cached --name-only가 비어있지 않으면 제안 중단하고 사용자에게 정리 요청..check-runtime/error-files.txt에 포함git diff --name-only HEAD 결과에 포함 (실제 수정됨)fix: <한 줄로 런타임 에러 설명> (예: fix: guard null config before accessing port)git add <좁혀진 파일 목록> → git commit -m "<제안 메시지>"fix: (런타임 에러 수정), 부수적 리팩터가 섞이면 refactor: 허용git push는 절대 자동 실행하지 않는다git add -A나 git add . 금지 — 좁혀진 파일 목록만 명시적으로 스테이징error-files.txt 밖 파일이 수정됐다면 이유 보고 후 종료.check-runtime/만 사용한다.;로 여러 개 chain 금지 — 마지막 명령의 exit code만 반환되므로 검증 실패/성공을 오판하게 됨. 필요하면 조건부 실행(if cmd; then ... fi) 또는 개별 tool call로 분리.모든 종료 지점에서 반드시 케이스 1~5 중 정확히 하나의 리포트를 출력한다. 침묵 exit 절대 금지. 코드 버그 수정 성공 후 커밋 제안 단계에서 Pre-flight가 실패하면 케이스 1 + 케이스 5 리포트 2개를 모두 출력한다.
케이스별 정해진 구조로 보고한다. 장황함 금지.
제목: ## ✅ 런타임 에러 수정 적용
본문 항목:
`<에러 메시지>` @ `<path>:<line>`<path> — <1줄 요약>pnpm run dev로 재검증 필요 (스킬은 자동 재실행 안 함)<제안 메시지> — (Y/수정/n)제목: ## ⚠️ 코드 수정 아님
본문 항목:
.check-runtime/runtime.log의 관련 라인 요약제목: ## ⏸ 분석 불명확, 수정 보류
본문 항목:
.check-runtime/runtime.log의 시그니처 + 주변 context제목: ## ⏸ dev server 종료 필요
본문 항목:
.check-runtime/이 아직 finalize되지 않음 (meta.txt의 ended_at 없음)Ctrl+C로 dev server 종료 후 스킬 재호출제목: ## ⏸ 커밋 제안 생략
본문 항목:
.check-runtime/ 없이 수정 시작 금지git commit 실행 금지git push 자동 실행 금지npx claudepluginhub letyuchan/vibe-check-mate --plugin vibe-check-mateProvides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.