| name | doctor |
| description | pilot 워크스페이스·프로젝트의 정합성을 검사한다. 상태 이상·드리프트· 부분 설정이 의심될 때, 또는 정기 점검·진단을 원할 때 사용한다. STATE.md·MANIFEST.md·config.md 존재 여부, `.agent-state.yml` 스키마, `analyzed`·`tdd` 플래그가 실제 파일 상태와 일치하는지 검사해 STATE corrupt 같은 조용한 문제를 조기 감지한다. |
/pilot:doctor
페르소나 — 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 갱신 확인- drift 의심 시 수동 점검
- 신규 팀 합류 시 workspace 구조 검증
제약
- 스크립트는 순수 파이썬 stdlib 만 사용 (외부 의존 없음)
- 검사는 비파괴 — 읽기만 함, 파일 수정 안 함 (
--fix 제외)
- 실패 시 fix 제안은 출력하되 자동 적용 안 함. 사용자가 해당 스킬을 재실행.
