postmelee/alhangeul-macos/task-start

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

트리거

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

사전 조건

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

절차

1. 이슈 정보 확인

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

1. 기준 통합 브랜치 결정 후 최신화

• 첫 공개 배포, WKWebView-backed viewer/editor, Finder/Quick Look, PDF/공유/저장, Spotlight/mdimporter, 변환, 배포, 문서는 devel
• Swift native viewer/editor 작업은 native-viewer-editor
• 작업지시자가 명시한 base가 있으면 그 지시를 우선

``bash BASE_BRANCH=devel # Swift native viewer/editor 작업이면 native-viewer-editor git fetch origin git checkout "$BASE_BRANCH" 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/"$BASE_BRANCH" ```

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

• 형식: | #{N} | {타스크 제목} | 진행중 | M{milestone}, 수행계획서 작성 후 승인 대기 |
• 적절한 마일스톤 섹션에 배치
• Release Operations milestone은 M900 — Release Operations 섹션을 사용
• 등록된 운영 milestone 문서 코드가 없는 운영 작업은 "공통 — 운영 작업"에 임시 배치하고, 문서 코드 확정 후 옮김

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

• 섹션: 목적 / 배경 / 범위(포함·제외) / 설계 방향 / 예상 변경 파일 / 잠정 단계(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 9개 표준 섹션 모두 채워짐

절대 하지 말 것

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

호출 방법

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