task-start - SKILL.md Agent Skill

name: task-start description: | 하이퍼-워터폴 타스크 시작 절차를 적용한다. 명시 호출 시에만 사용한다. GitHub 이슈 등록 확인, 통합 브랜치 최신화, local/task{N} 브랜치 생성, 오늘할일 항목 추가, 수행계획서 템플릿 생성을 수행한다. 새 코드/문서 변경을 시작하기 전 진행 단계 정렬 용도. allow_implicit_invocation: false

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

트리거

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

사전 조건

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

절차

이슈 정보 확인

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

기준 통합 브랜치 결정 후 최신화
- 첫 공개 배포, WKWebView-backed viewer/editor, Finder/Quick Look, PDF/공유/저장, Spotlight/mdimporter, 변환, 배포, 문서는 devel
- Swift native viewer/editor 작업은 native-viewer-editor
- 작업지시자가 명시한 base가 있으면 그 지시를 우선
```
BASE_BRANCH=devel # Swift native viewer/editor 작업이면 native-viewer-editor
git fetch origin
git checkout "$BASE_BRANCH"
git pull --ff-only
```

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

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

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

오늘할일 갱신: mydocs/orders/{yyyymmdd}.md에 행 추가
- 형식: | #{N} | {타스크 제목} | 진행중 | M{milestone}, 수행계획서 작성 후 승인 대기 |
- 적절한 마일스톤 섹션에 배치
- Release Operations milestone은 M900 — Release Operations 섹션을 사용
- 등록된 운영 milestone 문서 코드가 없는 운영 작업은 "공통 — 운영 작업"에 임시 배치하고, 문서 코드 확정 후 옮김
수행계획서 템플릿 생성: mydocs/plans/task_m{milestone}_{N}.md
- 섹션: 목적 / 배경 / 범위(포함·제외) / 설계 방향 / 예상 변경 파일 / 잠정 단계(3~6단계) / 검증 계획 / 리스크 / 승인 요청 사항
변경 검증
```
git status --short
git diff --check
```

단일 커밋

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

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

검증

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