fast-track Skill

🔔 시스템 메시지: 이 Skill이 호출되면 [SEMO] Skill: fast-track 호출 - {작업 유형} 시스템 메시지를 첫 줄에 출력하세요.

fast-track Skill

개발자 주도의 경미한 수정사항을 Epic→Task 프로세스 없이 빠르게 처리

Purpose

PO의 Epic→Task 생성 프로세스를 거치지 않고, 개발자가 발견한 경미한 수정사항을 즉시 처리하고 사후 보고하는 워크플로우를 제공합니다.

대상 작업

📖 상세 적격성 기준: references/​eligibility-check.md

Workflow

Step 1: 적격성 확인

[SEMO] Skill 호출: fast-track (적격성 확인)

작업 내용: {사용자가 설명한 작업}

🔍 적격성 체크:
- [ ] 영향 범위 3개 파일 이하
- [ ] 기능 변경 없음 (동작 유지)
- [ ] 테스트 변경 불필요
- [ ] 30분 이내 완료 가능

✅ 패스트트랙 적격 / ❌ 일반 프로세스 필요

적격 판정 시: Step 2로 진행 부적격 판정 시: 일반 Epic→Task 프로세스 안내

Step 2: 즉시 수정 실행

[SEMO] fast-track 실행: {작업 설명}

📝 변경 사항:
- {파일1}: {변경 내용}
- {파일2}: {변경 내용}

⏱️ 예상 소요: {n}분

수정 작업 완료 후 Step 3으로 진행

Step 3: 사후 이슈 생성

작업 완료 후 반드시 GitHub Issue 생성:

[SEMO] fast-track 완료 → 이슈 생성

📋 생성할 이슈:
- 제목: [Fast-Track] {작업 요약}
- 라벨: fast-track, {카테고리}
- 본문: (템플릿 기반)

이슈를 생성할까요? (Y/​n)

📖 이슈 템플릿: references/​issue-template.md

Step 4: 프로젝트 보드 연동

이슈 생성 후 반드시 프로젝트 보드에 연동하고 상태 설정:

[SEMO] fast-track → 프로젝트 보드 연동

📋 생성된 이슈: {repo}#{issue_number}
📊 프로젝트: 이슈관리 (#1)

🔄 작업 진행 중...
1. ✅ 프로젝트 보드에 이슈 추가
2. ✅ 상태를 "리뷰요청"으로 설정

✅ 완료: {repo}#{issue_number} → 리뷰요청

자동 실행 명령:

# 1. 프로젝트에 이슈 추가
gh project item-add 1 --owner semicolon-devteam --url "https://github.com/​semicolon-devteam/​{repo}/​issues/​{issue_number}"

# 2. 상태를 "리뷰요청"으로 변경
# skill: project-board 호출

📖 상세 API: ../​project-board/​references/​api-commands.md

Issue Template

## Fast-Track 수정 보고

### 카테고리
- [ ] 오타/문구 수정
- [ ] 스타일 미세조정
- [ ] 버그 핫픽스
- [ ] 코드 정리
- [ ] 기타: ___

### 변경 내용
{변경 사항 요약}

### 수정 파일
- `{파일 경로}`: {변경 내용}

### 스크린샷 (해당시)
{변경 전/후 스크린샷}

### 관련 커밋
{커밋 해시 또는 PR 링크}

---
> 🏃 이 이슈는 Fast-Track 프로세스로 사후 생성되었습니다.
> Epic 연결 없이 개발자 주도로 처리된 경미한 수정입니다.

Routing Integration

Orchestrator 라우팅 조건

triggers:
  keywords:
    - 패스트트랙
    - fast-track
    - 빠른수정
    - 긴급수정
    - 핫픽스
    - hotfix
    - 간단한 수정
    - 오타 수정
  patterns:
    - "{경미한|간단한|사소한} {수정|변경|고침}"
    - "빠르게 {고치|수정}"
    - "바로 {처리|수정}"

일반 작업과의 구분

🔄 테스트 정책: Fast-Track 예외

Fast-Track은 테스트 작성 의무에서 제외됩니다.

테스트 생략 허용 조건

Fast-Track 작업은 다음 조건을 만족하므로 Unit Test 생략 허용:

필수 검증

테스트 작성은 생략하되, 다음은 필수 확인:

# 기존 테스트 통과 확인
npm test

# Lint 확인
npm run lint

# TypeScript 확인
npx tsc --noEmit

테스트 생략 출력

[SEMO] 테스트 정책: Unit Test 생략 (Fast-Track)

**사유**: 경미한 수정 (기능 변경 없음)
**검증**: 기존 테스트 통과 ✅

⚠️ 기능 변경이 포함된 경우 일반 프로세스 사용

📖 전체 테스트 정책: _shared/​test-policy.md

---

Constraints

필수 조건

1. 적격성 확인 필수: Step 1 생략 불가
2. 이슈 생성 필수: Step 3 생략 불가 (PO 가시성 확보)
3. 프로젝트 보드 연동 필수: Step 4 생략 불가 (상태 추적)
4. 라벨 필수: fast-track 라벨 반드시 포함
5. 커밋 메시지: 🏃 [Fast-Track] 접두사 사용
6. 기존 테스트 통과 필수: 새 테스트 작성은 생략 가능

금지 사항

• ❌ 적격성 체크 없이 바로 수정
• ❌ 이슈 생성 없이 작업 종료
• ❌ 프로젝트 보드 연동 없이 작업 종료
• ❌ 부적격 작업을 패스트트랙으로 처리
• ❌ 3개 파일 초과 수정
• ❌ 기존 테스트 실패 상태로 커밋

Examples

Example 1: 오타 수정

사용자: "버튼에 오타가 있어서 수정하고 싶어"

[SEMO] Skill 호출: fast-track (적격성 확인)

작업 내용: 버튼 텍스트 오타 수정

🔍 적격성 체크:
- [x] 영향 범위 3개 파일 이하 (1개)
- [x] 기능 변경 없음
- [x] 테스트 변경 불필요
- [x] 30분 이내 완료 가능

✅ 패스트트랙 적격

---

[SEMO] fast-track 실행: 버튼 오타 수정

📝 변경 사항:
- components/​Button.tsx: "제출하기" → "제출하기" (오타 없음 확인)
  실제: "제출 하기" → "제출하기" (띄어쓰기 수정)

⏱️ 예상 소요: 5분

Example 2: 부적격 케이스

사용자: "새 페이지 추가 빠르게 해줘"

[SEMO] Skill 호출: fast-track (적격성 확인)

작업 내용: 새 페이지 추가

🔍 적격성 체크:
- [ ] 영향 범위 3개 파일 이하 → ❌ 5+ 파일 예상
- [ ] 기능 변경 없음 → ❌ 새 기능 추가
- [ ] 테스트 변경 불필요 → ❌ 새 테스트 필요
- [ ] 30분 이내 완료 가능 → ❌ 2시간+ 예상

❌ 패스트트랙 부적격

💡 권장: PO에게 Epic 생성 요청 후 일반 프로세스 진행
   → "새 페이지 Epic 요청" 또는 task-progress로 기존 Epic 확인

References

• 적격성 체크 가이드
• 이슈 템플릿
• 카테고리 가이드
• SEMO Core - Message Rules