claude-plugins

프로젝트 진행 중 작성된 코드를 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 호출로 시작 — 자동 파이프라인 아님.

pilot 워크스페이스·프로젝트의 정합성을 검사한다. 상태 이상·드리프트· 부분 설정이 의심될 때, 또는 정기 점검·진단을 원할 때 사용한다. STATE.md·MANIFEST.md·config.md 존재 여부, `.agent-state.yml` 스키마, `analyzed`·`tdd` 플래그가 실제 파일 상태와 일치하는지 검사해 STATE corrupt 같은 조용한 문제를 조기 감지한다.

새 워크스페이스 셋업 — `workspace/` 구조를 초기화한다. `workspace/STATE.md` 와 `workspace/context/` 하위의 `MANIFEST.md`·`config.md` 스켈레톤을 일괄 생성한다. 처음 pilot 을 도입·셋업할 때 사용한다.

운영 이슈 처리 모드 활성화. `workspace/issues/{이슈명}/` 폴더를 생성 또는 로드하고, STATE.md를 갱신하며, 도메인 컨텍스트를 로드한다. 버그 대응, 장애 분석, 핫픽스 등 단발성 이슈 단위 작업을 시작할 때 사용한다. 지속적인 기능 개발·feature 단위 작업은 `/pilot:project` 를 사용한다.

기존 소스 코드에서 진입점(컨트롤러·서비스 파일 또는 폴더)을 받아 `workspace/context/` 의 도메인 문서를 부트스트랩한다. `/pilot:analyze` 가 docs/ 기획서를 features/ 로 가공하는 짝이라면, 이 스킬은 코드를 읽어 컨텍스트를 만든다. 의존성을 N 단계까지 따라가며 파일 분류·정적 추출(메서드·라우트·상태값·검증 규칙) 후 코드의 자연스러운 모양에 맞춘 `{domain}.md` 또는 `{domain}/` 폴더를 생성하고 MANIFEST.md 색인을 갱신한다. `--boundary B --from A` 는 외부 도메인 B 전체 대신 A 가 호출하는 표면만 `boundaries/{A}--{B}.md` 로 포착한다 (cross-domain 경량 학습). 추측 금지 — 코드에 적힌 것만 file:line 인용으로 정리한다.

새 프로젝트를 시작하거나 기존 프로젝트를 재개할 때 사용한다. `workspace/projects/{PROJECT}/` 폴더를 생성·로드하고 STATE.md 를 갱신한 뒤 도메인 컨텍스트를 적재한다. 인자로 Confluence URL 이 오면 내부적으로 confl·analyze 를 위임 호출하고, `--tdd` 플래그로 TDD 모드를 켤 수 있다. 단발 이슈는 `/pilot:issue` 를 사용한다.

현재 진행중인 프로젝트의 Slack 알림을 설정·테스트·확인·해제할 때 사용한다. 활성화 시 작업 완료·사용자 승인 이벤트가 해당 프로젝트 채널로 전송된다. 설정은 `workspace/projects/{PROJECT}/.slack.env` 를 SSOT 로 관리한다.

TDD 모드를 사후 활성화·비활성화·정합성 보정·상태 보고한다. `/pilot:tdd on` — 활성화, `/pilot:tdd off` — 비활성화, `/pilot:tdd --fix` — 3-way 정합성 보정, `/pilot:tdd` (인자 없음) — 상태 보고. 신규 프로젝트를 TDD로 시작할 때는 `/pilot:project --tdd`를 사용한다.

Characterization test 모드로 전환/복귀한다. 기존 레거시 코드의 현재 동작을 테스트로 포착하기 위한 모드. 구현 변경 없음 (`{source_root}` 수정 금지). 리팩터는 별도 사이클.

이미 생성된 단일 feature 를 planner→critic→generator→evaluator 로 자동 순차 진행하는 감독형 자율 모드. hard-stop 신호(plan-validate 실패· critic blocking·재시도 소진·신호 파싱 실패)에 걸리면 즉시 사람에게 제어를 반환한다. 모든 자동 결정은 features/NN-{slug}.auto.md 에 기록한다. feature 생성·명세 작업은 `/pilot:create-feature`·`/pilot:analyze` 가 담당한다.

샘플 스킬 — docs_build 변환 검증용.

워크스페이스에 언어별 코드 리뷰 룰 파일 (`workspace/context/review/{lang}.md`) 을 셋업한다. `@pilot-code-review` 가 변경 언어의 룰 파일 부재를 인지하면 본 스킬로 1 회성 생성. 3 가지 시작 전략 (예시 복사 / 빈 템플릿 / AI 생성) 중 사용자가 선택. 생성 후 사용자가 본문 편집해 팀 컨벤션 반영.

사용자가 대화 중 내린 결정·방향 조정(예: "소프트 딜리트 빼줘", "Goal 5 먼저")을 다음 서브에이전트 호출(@pilot-planner·@pilot-planner-critic·@pilot-generator·@pilot-evaluator)에 전달해야 할 때 사용한다. 메인 대화의 결정이 서브에이전트에겐 보이지 않는 문제를 `.focus.md` 파일 매개로 해소한다.