pilee

현재 worktree를 최신 production 기반 새 branch로 in-place 전환해야 할 때 사용한다. "/to-production", "production으로 옮겨", "production 바라보게", "hotfix로 다시 쌓아" 요청에 사용한다. 기존 작업 commit은 backup 후 cherry-pick하고, 새 worktree가 필요하면 /wt fork --hotfix가 담당한다.

열린 PR의 리뷰 코멘트나 changes requested에 대해 부모/현재 대화와 작업 내역을 확인한 뒤, 표면적 답변이 아니라 근본 원인을 판단해 코드 수정·커밋·푸시·스레드 답글·review re-request까지 수행해야 할 때 사용한다. `--push-only` 모드에서는 코멘트/re-request 없이 커밋·푸시 후 수동 게시용 답글 초안을 세션에서 다듬는다. "PR 코멘트 대응", "리뷰 대응", "이거 대응작업-커밋-푸시-코멘트까지", "근본적으로 대응", "대응할 게 없으면 근거 코멘트" 요청에 사용한다.

Local guide for using interactive_shell in this repo. Prefer it for dev servers, TUI apps, REPLs, database shells, log viewers, and commands that need a visible terminal overlay. Do not use it for subagent-style delegation; use the subagent tool for that.

열린 PR의 GitHub Actions/CI 실패를 분석해 원인을 분류하고, 코드·generated artifact·테스트·환경 문제를 근본 대응한 뒤 검증, 커밋, push까지 수행해야 할 때 사용한다. "CI 실패 대응", "체크 실패 봐줘", "Actions 실패 고쳐줘", "pr-checks 실패", "ci-ship" 요청에 사용한다.

PR을 만들기 전 또는 remote에 올리기 전, 변경사항을 의도 단위로 커밋하고 lint/typecheck/test/build 같은 사전 검증을 통과시킨 뒤 push해야 할 때 사용한다. "ship 해줘", "커밋해서 푸시", "올리기 전에 검증", "push 준비" 요청에 사용한다.

PR/구현 검증을 PM·비개발자도 이해할 수 있는 캡처 중심 HTML 리포트로 만든다. Jira/Notion/Slack/와이어프레임/PR test plan 같은 기획 근거를 사용자-facing 동작과 매핑하고, 핵심 UI 흐름은 스크린샷/GIF를 primary evidence로 증명한다. 로직/API/DB/code diff 검증은 하단 기술 보조 검증으로 정리한다. 기본은 로컬 확인용이며 업로드/PR 업데이트는 명시 요청 시에만 한다.

작업 시작 전에 구체 질문으로 목표·성공 기준·범위·검증 초점을 함께 좁히고, 이후 /decide·/verify가 mechanically 읽을 수 있는 frame.json을 워크트리에 박제한다.

테스트가 과하게 mock/fixture/구현세부 assertion에 묶였는지 점검하고, 기능 테스트·내부 로직 테스트·외부 의존성 mock 경계를 기준으로 실용적으로 다듬을 때 사용한다. "테스트가 과하지 않은지", "모킹 기준", "내부 메서드는 직접 테스트", "외부 API만 mock", "unit/contract test 어디까지" 같은 요청에 사용한다.

DDL, 대량 백필, 배포 시 자동 반영되어야 하는 DB 변경을 마이그레이션 파일로 설계·검증할 때 사용. set-based SQL, idempotency, rollback/down(), 실행 전 사용자 승인, dev 검증을 강제한다. 서비스별 경로/명령은 private/project overlay를 따른다.

운영/개발 DB에 일회성 데이터를 쓰거나 수정하는 SQL을 설계할 때 사용. AI가 직접 실행하지 않고, 작업 설명 → 사전 SELECT → 실행 SQL → 사후 SELECT 형식으로 사용자가 DB 클라이언트에서 검토·실행할 수 있게 제공한다. 회사/프로젝트별 DB 도구와 로그 규칙은 private/project overlay를 따른다.

Structure disciplined git practices for commits, branches, and history. Use when making any code change — committing, branching, resolving conflicts, or organizing work across parallel streams.

Build in thin vertical slices — implement one piece, test it, commit, then expand. Use when any change touches more than one file, when a task feels too large to land in one step, or when you are tempted to write more than 100 lines before running tests.

AI가 구현한 변경사항을 요구사항·문서·도메인 언어·diff와 대조해 사용자가 리뷰할 수 있는 감사 브리핑을 만든다. 무엇을 바꿨는지, 어디까지 믿어도 되는지, 무엇을 직접 봐야 하는지, 다음 행동이 캡처/수정/PR 중 무엇인지 판정할 때 사용한다.

pilee 레포 개선 작업을 마무리하기 전 마지막 게이트로 사용한다. 사용자가 “구현 다 했으면 구멍 없는지 다시 검증”, “의도한대로 잘 동작하게 해줘”, “마지막으로 한 번 더 봐줘”, “pilee 작업 마무리”처럼 말하거나 AGENTS.md의 pilee 변경 마무리 단계에 도달하면 사용한다. 구현 구멍을 찾으면 수정·재검증하고, 없으면 개선 내용과 검증 근거를 정리한다.

기술적 의사결정이 필요할 때 대안 비교·트레이드오프 도전 후 frame.json에 박제. /frame이 큐잉한 frame.decision task를 자동 처리하거나, 즉석 의사결정도 가능.

Pi/Codex subagent로 stress-interview를 실행한 뒤 worker가 actionable item만 수정하고 재검토를 2사이클 반복하는 자가 치유 스킬. PR 머지 전 자동 안정화와 품질 개선 루프 때 사용.

/verify-report를 실행하기 전에 PM-facing 캡처 리포트 계약을 고정한다. Jira/Notion/Slack/와이어프레임/PR test plan 같은 기획 근거를 성공 기준·actor/role·subject identity·화면 oracle·primary capture로 매핑하고, 데이터/계정/환경/side effect 준비도를 점검해 긴 /verify-report의 정확도를 높인다. "verify-report 전에", "캡처 전 데이터 확인", "리포트 프리플라이트", "검증 준비도", "이거 full report 필요한가" 요청에 사용한다.

Runtime/preview/deployment healthcheck, 5xx, timeout, CI deploy, worker, orchestrator, queue, load balancer, federation compose처럼 마지막 증상 뒤에 여러 실행 주체가 fan-out 되는 실패를 분석할 때 사용한다. "프리뷰가 안 떠", "헬스체크 실패", "내 PR만 배포 실패", "upstream이 안 붙어", "AWS/ECS/Lambda/ALB/GraphQL compose 원인 봐줘" 요청에서 마지막 증상 대신 fan-out map과 최소 재현으로 root cause를 좁힌다.

Diagnose and fix root causes systematically. Use when tests fail, builds break, runtime behavior deviates from expectations, or any unexpected error appears. Follow a structured triage process instead of guessing.

AskUserQuestion 호출 시 질문/옵션 작성 규칙. 다른 스킬이 prerequisite로 로드하여 사용. 사용자가 "무슨 말이야?"로 되묻거나 "충분하다"만 누르는 의례화 패턴 차단.

AskUserQuestion 사용 시점과 방식 판단. 언제 묻고 언제 안 묻을지 결정하는 철학. 세션 시작 시 필수 로드.

pilee-history/private journal에서 공개 가능한 설계 지식을 추출하거나 docs/knowledge 문서를 검색·작성·갱신·검증할 때 사용한다. 사용자가 "pilee knowledge", "히스토리를 지식으로", "지식 정합성", "stale 해소", "README 그래프", "reviewed_at 갱신", "add-knowledge처럼"이라고 말하면 사용한다.

Pi용 스킬을 새로 만들거나 기존 스킬을 개선·검증·평가할 때 사용한다. 사용자가 "스킬 만들어줘", "SKILL.md 작성", "이 워크플로우를 skill로", "스킬 설명/트리거 최적화", "기존 skill 수정", "eval로 스킬 테스트"처럼 말하면 반드시 이 스킬을 사용한다. Agent Skills 표준과 Pi의 스킬 로딩/검증 규칙에 맞춰 스킬 구조, 프론트매터, progressive disclosure, 평가 루프를 설계한다.

Jira 이슈 생성·수정·정리 요청에 사용. 이슈 본문을 Wiki markup/Markdown 등 대상 Jira가 요구하는 형식으로 정리하고, 외부 시스템에 전송하기 전 preview confirmation을 강제한다. 특정 Jira cloud/project key/MCP 우선순위는 private/project overlay를 따른다.

로컬 개발 서버를 시작하거나 포트 충돌, stale process, 환경변수/서비스 연결 문제를 진단할 때 사용. 특정 회사/레포의 포트·명령·서비스 의존성은 project/private overlay 스킬을 우선 따른다.

Pi/Codex subagent의 verifier + reviewer + challenger를 병렬 호출해 동일 변경사항을 다각도로 검토받는 스킬. PR 전 점검, self-healing 전 검토, 코드 변경 스트레스 테스트 때 사용.

버그, 테스트 실패, 예상치 못한 동작을 만났을 때 사용. 수정을 시도하기 전에 근본원인을 찾는 프로세스.

Evaluate code changes across correctness, readability, architecture, security, and performance before integration. Use before merging any change — whether written by a human, an agent, or yourself.