postmelee/codex-usage-analyzer/task-start

하이퍼-워터폴 타스크 시작

트리거

• 작업지시자가 "이슈 #N 시작", "타스크 #N 진행"처럼 명시 지시한 경우
• 작업지시자가 본 SKILL을 직접 호출한 경우

사전 조건

• 작업지시자 승인된 이슈 번호와 마일스톤이 존재
• 작업 대상 저장소 working tree clean (또는 분리된 worktree 사용 결정)
• 현재 사용자 자격 증명으로 gh CLI 인증 완료

절차

1. 이슈 정보 확인

``bash gh issue view {N} --json number,title,milestone,state,body ``

1. main 최신화

``bash git fetch origin git checkout main git pull --ff-only ``

1. 작업 브랜치 생성. 다른 작업자가 메인 worktree를 점유 중이면 분리 worktree 사용:

```bash # 단일 worktree git checkout -b local/task{N}

# 분리 worktree (권장: 다른 에이전트 비간섭) git worktree add ../{repo}-task{N} -b local/task{N} origin/main ```

1. 오늘할일 갱신: mydocs/orders/{yyyymmdd}.md에 행 추가

• 출력 형식은 mydocs/_templates/orders.md를 기준으로 한다.
• 형식: | #{N} | {타스크 제목} | 진행중 | M{milestone}, 수행계획서 작성 후 승인 대기 |
• 적절한 마일스톤 섹션에 배치 (운영 작업은 "공통 — 운영 작업")

1. 수행계획서 생성: mydocs/plans/task_m{milestone}_{N}.md

• 중앙 템플릿 mydocs/_templates/task_plan.md를 기준으로 작성한다.
• 템플릿을 읽을 수 없는 경우에만 다음 최소 섹션을 fallback으로 사용한다: 목적 / 배경 / 범위(포함·제외) / 설계 방향 / 예상 변경 파일 / 잠정 단계(3~6단계) / 검증 계획 / 리스크 / 승인 요청 사항

1. 변경 검증

``bash git status --short git diff --check ``

1. 단일 커밋

``bash git add mydocs/plans/task_m{milestone}_{N}.md mydocs/orders/{yyyymmdd}.md git commit -m "Task #{N}: 수행 계획서 작성과 오늘할일 갱신" ``

1. 작업지시자에게 수행계획서 승인 요청

검증

• git log --oneline -1이 Task #{N}: 수행 계획서 작성과 오늘할일 갱신을 보여야 한다
• mydocs/orders/{yyyymmdd}.md에 #{N} 행 존재
• mydocs/plans/task_m{milestone}_{N}.md가 mydocs/_templates/task_plan.md의 필수 섹션을 채움

절대 하지 말 것

• 수행계획서 승인 전 구현 계획서 작성
• 수행계획서 승인 전 코드/매뉴얼 변경
• 다른 작업자의 미커밋 변경 또는 다른 task 브랜치 working tree 건드리기

호출 방법

• Codex: $task-start 또는 /skills 메뉴에서 task-start 선택
• Claude Code: /task-start