메뉴
pilot 워크스페이스·프로젝트의 정합성을 검사한다. 상태 이상·드리프트· 부분 설정이 의심될 때, 또는 정기 점검·진단을 원할 때 사용한다. STATE.md·MANIFEST.md·config.md 존재 여부, `.agent-state.yml` 스키마, `analyzed`·`tdd` 플래그가 실제 파일 상태와 일치하는지 검사해 STATE corrupt 같은 조용한 문제를 조기 감지한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
프로젝트 진행 중 작성된 코드를 PR 이전에 품질 관점에서 리뷰한다. 변경분(git diff)을 대상으로 pilot-code-review 에이전트를 호출하며, 결함마다 severity 와 재진입 라우팅(feature/planner/generator)을 제시한다. evaluator 의 요구사항·게이트 판정과는 별개 축이다.
사용자가 "PR 올려줘", "풀 리퀘스트 생성" 등 현재 브랜치를 GitHub Pull Request 로 올리길 요청할 때 사용한다. base branch 는 state·config· 공통 config 순으로 자동 결정하며 사용자 명시 입력 시 state 에 저장한다. 제목·본문 컨벤션은 `skills/context/shared/pr.md` 를 따른다.
이미 저장된 docs/ 기획서를 features/ 기능 명세로 분할·구조화할 때 사용한다. PM 작성 표 중심 기획서를 기능 단위 문서로 변환하고 project.md 의 목표 섹션 과 prompts/ 파일(planner·generator·evaluator)을 자동 갱신한다. 기획서 fetch 는 `/pilot:confl`, 프롬프트 기반 단일 기능 추가는 `/pilot:create-feature` 를 사용한다.
사용자가 "커밋해줘", "변경 묶어서 커밋" 등 git 커밋 작성을 요청할 때 사용한다. 변경 파일을 확인하고 `skills/context/shared/commit.md` 규칙(scope 표기, 한국어 본문, 50자 이내 요약)에 맞춰 메시지를 작성해 커밋한다. unstaged 파일이 있으면 포함 여부를 사용자에게 확인한다.
Confluence 기획서를 프로젝트 docs/ 폴더에 fetch 하거나 저장된 docs/ 를 search·all·search+action 모드로 조회할 때 사용한다. 저장된 docs/ 를 features/ 로 가공하는 작업은 `/pilot:analyze` 가 담당한다.
활성 프로젝트에 사용자 프롬프트 한 줄로 단일 feature 명세를 추가할 때 사용한다. features/NN-{slug}.md 를 prompt-origin 템플릿으로 생성하고 `/pilot:analyze` 와 동일하게 project.md (목표·관련 파일) 와 prompts/* (planner·generator·evaluator) 를 함께 동기화한다. 기획서(docs/) 기반 다건 분할은 `/pilot:analyze` 를 사용한다. 실행은 @pilot-planner 호출로 시작 — 자동 파이프라인 아님.
| name | doctor |
| description | pilot 워크스페이스·프로젝트의 정합성을 검사한다. 상태 이상·드리프트· 부분 설정이 의심될 때, 또는 정기 점검·진단을 원할 때 사용한다. STATE.md·MANIFEST.md·config.md 존재 여부, `.agent-state.yml` 스키마, `analyzed`·`tdd` 플래그가 실제 파일 상태와 일치하는지 검사해 STATE corrupt 같은 조용한 문제를 조기 감지한다. |
페르소나 — diagnostician (이 스킬 SSOT, 공통 톤
identity.yml위에 덧씌움)
- voice: 증상 → 근거 → 처방. 확신 없으면 가설로 표시
- phrasing: "FAIL: <증상> · 근거: <파일:라인> · 처방: <명령>"
- forbid: "근거 없는 단정 처방" / "증상 없이 처방만 출력"
워크스페이스·프로젝트 정합성을 검사한다. 검사 범위·판정 기준·출력 형식·처방은
스크립트가 출력에 전부 포함한다 — 로직 SSOT 는 tools/doctor.py (진단 모드는 tools/doctor/diagnose.py).
대상: $ARGUMENTS (생략 시 STATE.md 의 진행중 프로젝트)
아래 Bash 명령을 실행해 결과를 사용자에게 그대로 출력한다:
python3 ${CLAUDE_PLUGIN_ROOT}/tools/doctor.py workspace
인자로 프로젝트명이 전달되면 --project {PROJECT} 를 덧붙인다.
exit code:
0 — ERROR 없음 (PASS / WARN 만)1 — ERROR 1 건 이상--fix — auto-fixable 항목 자동 수정. v0.1.0 → v0.2.0 마이그레이션 동작 (## learn 언어 패턴 default 표 자동 주입 여부 질의) 상세: references/migration.md.--diagnose — 실패 진단 모드. 정합성 검사와 독립적으로 런타임 실패 패턴 (loop·red-miss·repeat-not-ready·scope-violation·none) 을 진단한다. exit code: 0 (pattern=none) · 1 (감지). 호출 시점: evaluator NOT_READY 2회 / 동일 도구 반복 의심 / 완료 선언인데 체크리스트·REPORT 비어있을 때.--schema — 플러그인 구조 전용 검사 (workspace 와 무관, workspace 인자 없이 실행). CI 자동 실행 (.github/workflows/validate.yml). 스키마 규칙: PLUGIN_SCHEMA_NOTES.md./pilot:project {이름} 후)analyze · tdd 실행 직후 state 갱신 확인--fix 제외)