Community라이팅 & 에디팅github.com

Pit-Stop

코드베이스의 F1 피트 스톱: 한 번의 명령으로 읽기, 찾기, 수정, 검증, 보고를 실행합니다.

Pit-Stop란 무엇인가요?

Pit-Stop은 코드베이스의 F1 피트 스톱과 같은 역할을 수행하는 AI 에이전트 스킬입니다. 한 번의 명령으로 **읽기 → 찾기 → 제안 → 수정 → 검증 → 보고**의 전체 워크플로우를 중간 질문 없이 자동으로 실행합니다. 사용자는 단순히 "시작" 명령만 내리면, AI가 독립적으로 코드를 분석하고 문제점을 식별하며 수정까지 진행한 후 최종 보고서를 제공합니다. 이 스킬은 Claude Code, Cursor와 같은 AI 코딩 에이전트 플랫폼에서 사용하도록 설계되었으며, 특히 증거 기반 접근법과 강력한 가드레일(예: 비용 한도, 수동 커밋 필요, 하위 에이전트 결과 검증)을 통해 안전하고 신뢰할 수 있는 자동 리팩토링을 보장합니다. 주요 강점은 반복적인 수정-검증 루프, 독립적인 검토자 도입, 그리고 발견된 모든 항목의 강도(강함/가치 있음/추측)에 따른 체계적인 분류 및 처리입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Finn763/pit-stop

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Pit-Stop은(는) 무엇을 하나요?

코드베이스의 F1 피트 스톱: 들어가서 수정받고, 더 빠르게 나옵니다. 한 번의 명령으로 읽기 → 찾기 → 수정 → 검증 → 보고를 중간 질문 없이 실행합니다. 사용자는 "시작"만 말하면 되고, AI는 보고서와 함께 한 번만 응답합니다.

실행 순서 (순서대로, 건너뛰기 없음)

  1. 로드: README/AGENTS.md(또는 이에 상응하는 파일) + git status + 최근 커밋 핫스팟을 읽습니다. 먼저 한 줄을 작성합니다: MODE = 여기서 무엇을 발견으로 간주하고, 무엇을 즉시 거부할지. 핵심 정보가 누락되었나요? 한 번만 질문하고, 가장 엄격한 기본값으로 진행합니다.
  2. 찾기: 스캔 전에 범위를 설정합니다 (명명된 대상 > git 핫스팟 > 전체 트리). 모든 발견에는 path:line 증거가 필요합니다. 기록된 결정은 마찰이 재검토를 정당화하지 않는 한 건너뜁니다. 각각에 태그를 지정합니다: delete/stdlib/native/yagni/shrink/security/obs, 강도 Strong/Worth/Speculative. Speculative = 보고만 하고 절대 수정하지 않습니다. 발견된 것이 없으면 Lean already. Ship.이라고 말합니다. 절대 부풀리지 않습니다.
  3. 제안: Strong 항목만 해당합니다. 각각 = 증상 + 증거 + 영향 + 최소 수정 + 비용. 더불어 트리거 조건을 포함한 NOT-doing 목록도 포함합니다.
  4. 수정: 검토→수정 루프를 독립적인 검토자와 함께 진행합니다 (다른 각도가 같은 눈보다 좋습니다); 깨끗해지거나 --max-rounds(기본값 3)에 도달하면 중단합니다. 라운드 간 원장을 유지하고, 반복 수정을 하지 않습니다. 두 번 연속 정체 라운드 → "사람 필요"로 에스컬레이션하고 중단합니다. references/guardrails.md를 참조하세요.
  5. 보고서: 헤더 Generated fully automatically by pit-stop. 네 개의 블록 — 변경됨 / 검증됨(도구 출력) / 검증되지 않음 / 나머지. 새로운 도구 출력 없이 주장하지 않습니다. 붙여넣는 모든 내용에서 비밀/토큰/PII를 삭제합니다. templates/report.md를 참조하세요.

철칙

  • 항상 주장보다 증거가 먼저입니다. 이번 턴에 검증 실행이 없으면 성공 주장을 할 수 없습니다.
  • 하위 에이전트의 "완료"는 완료가 아닙니다. 보고하기 전에 하위 에이전트의 diff를 읽으세요.
  • 모호한 부분은 평가를 낮추고, 추측하지 마세요. "사람 필요"라고 쓰고 계속 진행하세요.
  • 푸시/커밋은 절대 자동으로 하지 않습니다. 변경 사항은 명시적인 한 마디 명령이 있을 때까지 작업 디렉토리에 남아 있습니다.
  • 단일 지출 퓨즈: 한 단계가 $20를 초과하면 해당 단계를 중단하고 보고서를 작성합니다.

세부 사항: references/phases.md, references/guardrails.md, references/verification.md.

관련 스킬