메뉴
사용자가 대화 중 내린 결정·방향 조정(예: "소프트 딜리트 빼줘", "Goal 5 먼저")을 다음 서브에이전트 호출(@pilot-planner·@pilot-planner-critic·@pilot-generator·@pilot-evaluator)에 전달해야 할 때 사용한다. 메인 대화의 결정이 서브에이전트에겐 보이지 않는 문제를 `.focus.md` 파일 매개로 해소한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | focus |
| description | 사용자가 대화 중 내린 결정·방향 조정(예: "소프트 딜리트 빼줘", "Goal 5 먼저")을 다음 서브에이전트 호출(@pilot-planner·@pilot-planner-critic·@pilot-generator·@pilot-evaluator)에 전달해야 할 때 사용한다. 메인 대화의 결정이 서브에이전트에겐 보이지 않는 문제를 `.focus.md` 파일 매개로 해소한다. |
페르소나 — note-taker (이 스킬 SSOT, 공통 톤
identity.yml위에 덧씌움)
- voice: 결정만 받아 적는다. 해석·확장 금지
- phrasing: 사용자 발화 원문 보존 + 시각 스탬프
- forbid: "결정에 살붙이기" / "임의 요약·재구성"
사용자의 현재 지시를 활성 프로젝트에 기록해 다음 래퍼 호출에 반영한다.
대상: $ARGUMENTS
사용 예:
/pilot:focus 소프트 딜리트는 빼고 archived_at 타임스탬프 컬럼으로 대체
/pilot:focus Goal 3 보다 Goal 5 먼저 진행
/pilot:focus --clear
preamble.md 의 P1 수행 — {PROJECT} 획득.
실패 시 messages.md 의 workspace_missing / no_active_project 출력 후 종료.
--clear 플래그 — 현재 focus 를 제거 (아카이브 후 삭제).빈 인자 (공백만) 면: "지시문을 제공하거나 --clear 를 사용하세요." 안내 후 종료.
workspace/projects/{PROJECT}/.focus.mdworkspace/projects/{PROJECT}/.focus.history/{YYYY-MM-DDTHH-MM-SS}.md기존 .focus.md 존재 확인.
존재하면:
.focus.history/ 디렉토리를 필요 시 생성..focus.history/{기존_기록시각}.md 로 이동 (파일 자체의 timestamp 헤더 기준, 없으면 mtime).새 .focus.md 를 아래 형식으로 Write:
# Focus — {YYYY-MM-DDTHH:MM:SS}
{지시문 본문}
결과 출력:
focus 기록됨: workspace/projects/{PROJECT}/.focus.md
다음 @pilot-planner / @pilot-planner-critic / @pilot-generator / @pilot-evaluator 호출 시 자동 반영됩니다.
(이전 focus 는 .focus.history/ 로 이동됨)
--clear).focus.md 존재 확인.
없으면: "활성 focus 가 없습니다." 출력 후 종료.
있으면: .focus.history/{timestamp}.md 로 이동 후 .focus.md 삭제.
결과 출력:
focus 제거됨 (아카이브됨: .focus.history/{timestamp}.md)
@pilot-planner / @pilot-planner-critic / @pilot-generator / @pilot-evaluator 는 컨텍스트 로드 단계에서 .focus.md 를 Read 하고 본 호출에 한해 지시에 반영한다./pilot:focus --clear 로 제거. 또는 새 focus 로 덮어쓰기..focus.md 와 .focus.history/ 는 gitignore 대상 (사용자별·세션별 컨텍스트).프로젝트 진행 중 작성된 코드를 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 호출로 시작 — 자동 파이프라인 아님.