--- name: workflow-init description: "워크플로우 초기화 스킬. prompt.txt 읽기, 시나리오 분기, 제목 생성, init-workflow.sh 통합 스크립트 실행을 수행합니다." disable-model-invocation: true --- # Init 사용자 요청을 전처리하여 워크플로우의 입력을 준비하는 스킬. > 이 스킬은 workflow-orchestration 스킬이 관리하는 워크플로우의 한 단계입니다. 전체 워크플로우 구조는 workflow-orchestration 스킬을 참조하세요. --- ## 터미널 출력 원칙 > 내부 분석\/사고 과정을 터미널에 출력하지 않는다. 결과만 출력한다. - **출력 허용**: 반환값 (6줄 규격), 에러 메시지, AskUserQuestion 호출 - **출력 금지**: 분석 과정, 판단 근거 설명, "~를 살펴보겠습니다" 류, 중간 진행 보고, 작업 계획 설명 - 파일 읽기\/쓰기 등 내부 작업은 묵묵히 수행하고 최종 반환값만 출력 - INIT 시작\/완료 배너는 오케스트레이터가 호출. init 에이전트는 배너를 직접 호출하지 않음 --- ## 절차 (3단계) ### Step 1: prompt.txt 읽기 및 시나리오 분기 Read 도구로 **프로젝트 루트의** `.prompt\/prompt.txt`를 읽습니다. (CWD가 프로젝트 루트가 아닐 수 있으므로 반드시 절대 경로를 사용) **분기 판단:** - 파일에 내용이 있으면 (공백\/줄바꿈 외 텍스트 존재) -> Step 2로 진행 - 파일이 없거나 내용이 비어있으면 -> 시나리오 분기: - **시나리오 1**: 이전 COMPLETED 워크플로우가 존재하는 경우 1. `.workflow\/` 하위에서 가장 최근 COMPLETED 상태의 워크플로우 탐색 2. 해당 워크플로우의 `report.md`를 읽어 분석 3. 후속 작업을 제안하고 AskUserQuestion으로 사용자에게 확인 4. 사용자가 승인하면 그 내용을 prompt로 사용하여 Step 2로 진행 5. 사용자가 거부하면 워크플로우 중지 - **시나리오 2**: 이전 워크플로우가 없는 경우 - 워크플로우 중지: "`<프로젝트루트>\/.prompt\/prompt.txt`에 요청 내용을 작성한 후 다시 실행해주세요." (절대 경로로 안내) ### Step 2: 작업 제목 생성 사용자 요청(promptContent)에서 작업 제목을 생성합니다. **규칙:** - 요청의 핵심을 20자 이내로 요약 - 한글 사용 가능 - 공백 -> 하이픈(-)으로 변환 - 특수문자(!, @, #, $, %, ^, &, *, (, ), \/, \, :, ;, <, >, ?, |, `, ~, " 등) 제거 - 마침표(.) -> 하이픈(-)으로 변환 - 연속 하이픈(--) -> 단일 하이픈(-)으로 - 20자 초과 시 절단 **예시:** - "로그인 기능 추가" -> "로그인기능추가" - "PR #123 리뷰" -> "PR-123-리뷰" - "src\/auth\/login.ts 버그 수정" -> "src-auth-login-ts-버그수정" (20자 절단) ### Step 3: workId 생성 및 init-workflow.sh 스크립트 실행 Bash 도구로 **정확한 KST 기반** 현재 시간을 가져옵니다: ```bash TZ=Asia\/Seoul date +"%Y%m%d-%H%M%S" ``` **반드시 Bash 실행 결과를 그대로 사용하세요. LLM이 자체 추정하지 마세요.** 출력 예: `20260205-204500` - date: 하이픈 앞 8자리 (예: 20260205) - workId: 하이픈 뒤 6자리 (예: 204500) 그 다음, Bash 도구로 통합 초기화 스크립트를 실행합니다: ```bash wf-init .workflow\/-\/\/ <제목> ``` > **workDir 형식:** > 두 번째 인자 `workDir`은 `.workflow\/-\/\/` 형식입니다. > - 올바른 예: `.workflow\/20260208-133900\/로그인기능추가\/implement` > - 잘못된 예: `.workflow\/20260208-133900` (구 플랫 형식) > - 잘못된 예: `.workflow\/20260208-133900-워크플로우-완료\/implement` (레거시 형식) > > ``은 Step 2에서 생성한 작업 제목 기반 하이픈 변환 값입니다. **인자:** | 순서 | 인자 | 설명 | |------|------|------| | 1 | command | 실행 명령어 (implement, refactor 등) | | 2 | workDir | 작업 디렉터리 경로 (`.workflow\/YYYYMMDD-HHMMSS\/\/`) | | 3 | workId | 작업 ID (HHMMSS) | | 4 | title | 작업 제목 | **스크립트가 수행하는 작업:** 1. `.prompt\/prompt.txt` 읽기 2. 작업 디렉터리 생성 (`mkdir -p`) 3. `prompt.txt` -> `\/user_prompt.txt` 복사 4. `.prompt\/prompt.txt` 클리어 5. `.prompt\/querys.txt` 갱신 6. `\/.context.json` 생성 7. `\/status.json` 생성 8. 좀비 정리 (TTL 만료 워크플로우 STALE 전환) 9. 전역 레지스트리 등록 **주의:** 스크립트 stdout 출력은 무시합니다. 에이전트는 Step 1에서 읽은 prompt.txt 내용만 사용합니다. --- ## 컨텍스트 용량 확인 절차를 시작하기 **전에** 현재 컨텍스트 사용량을 확인합니다. 워크플로우는 PLAN, WORK, REPORT 단계를 거치며 컨텍스트를 지속적으로 소비하므로, 시작 시점의 여유 공간이 중요합니다. ### 체크 기준 | 사용량 | 수준 | 대응 | |--------|------|------| | 70% 미만 | 정상 | 그대로 진행 | | 70% 이상 ~ 80% 미만 | 주의 | `\/compact` 권고 메시지 출력 후 진행 | | 80% 이상 | 위험 | `\/compact` 강력 권고 메시지 출력 후 진행 | ### 권고 메시지 **70% 이상 (주의):** [컨텍스트 주의] 현재 컨텍스트 사용량이 70%를 초과했습니다. 워크플로우 진행 중 컨텍스트가 부족해질 수 있습니다. 권고: \/compact 명령어로 컨텍스트를 정리한 후 다시 시도해주세요. **80% 이상 (위험):** [컨텍스트 경고] 현재 컨텍스트 사용량이 80%를 초과했습니다. 워크플로우 진행 시 자동 컴팩트가 발생할 가능성이 매우 높습니다. 자동 컴팩트 발생 시 작업 컨텍스트가 유실되어 작업 품질이 저하됩니다. 강력 권고: \/compact 명령어로 컨텍스트를 정리한 후 다시 시도해주세요. ### 체크 절차 1. 컨텍스트 사용량 확인 - 현재 컨텍스트 사용 비율 파악 2. 기준 평가 - 70% 미만: 정상 -> 절차 시작 - 70% 이상: 권고 메시지 출력 -> 절차 시작 - 80% 이상: 강력 권고 메시지 출력 -> 절차 시작 > **참고**: 컨텍스트 체크는 권고 사항이며, 워크플로우 진행을 차단하지 않습니다. 사용자가 권고를 무시하고 진행할 수 있습니다. --- ## 반환 형식 (필수) > **엄격 준수**: 아래 6줄 형식만 반환합니다. 추가 정보 금지. > **경고**: 반환값이 규격 줄 수(6줄)를 초과하면 메인 에이전트 컨텍스트가 폭증하여 시스템 장애가 발생합니다. ``` request: workDir: .workflow\/-\/\/ workId: date: title: <제목> workName: <작업이름> 근거: [1줄 요약] ``` **절대 포함하지 않을 항목:** - 요청 전문 - "다음 단계" 안내 - 판단 근거 상세 - 변경 파일 목록, 예상 작업 시간, 복잡도 등 상세 정보 - 마크다운 헤더, 부가 섹션 --- ## 에러 처리 | 에러 | 처리 | |------|------| | prompt.txt 없거나 비어있음 | 시나리오 분기 (Step 1 참조) | | init-workflow.sh 실행 실패 | 에러 반환 (워크플로우 중단) | | 파일 읽기 실패 | 경로 확인 후 재시도 (최대 3회) | ### 에러 시 반환 **스크립트 실행 실패:** ``` 에러: [에러 메시지] ``` ### 재시도 정책 - 최대 3회, 각 시도 간 1초 대기 - 재시도 대상: 파일 읽기 실패, 스크립트 실행 실패 - 3회 실패 시 에러 보고 --- ## 역할 경계 (Boundary) init은 **전처리**만 수행합니다. 다음 행위는 절대 금지: - 소스 코드 파일을 Read\/Grep으로 탐색하지 마라 - 소스 코드를 Write\/Edit하지 마라 - 코드 리뷰 의견을 제시하지 마라 - 이전 워크플로우의 report.md를 분석하지 마라 (**예외**: Step 1 시나리오 1 - prompt.txt 비어있고 이전 COMPLETED 워크플로우 존재 시 허용) - 후속 작업을 제안하지 마라 (**예외**: Step 1 시나리오 1 - prompt.txt 비어있고 이전 COMPLETED 워크플로우 존재 시 허용) - PLAN\/WORK\/REPORT 단계의 작업을 수행하지 마라 - 미완료 워크플로우를 확인하거나 상태 테이블을 출력하지 마라 (registry.json 조회 포함). 다중 워크플로우 동시 실행은 시스템 설계 사항이며, 새 워크플로우 시작에 영향을 주지 않는다. --- ## 동시성 안전성 (Concurrency Safety) 전역 `.workflow\/registry.json`은 **활성 워크플로우 레지스트리** 방식으로 운영됩니다: - **전역 파일 직접 쓰기 금지**: 모든 전역 레지스트리 접근은 `update-workflow-state.sh register\/unregister`를 통해 수행 - **파일 잠금 보호**: register\/unregister 시 파일 잠금으로 동시성 경합 방지 - **로컬 .context.json 독립성**: 각 워크플로우는 자체 `\/.context.json`을 독립적으로 관리 ## 주의사항 1. **Step 순서 엄수**: 반드시 Step 1 -> 2 -> 3 순서로 진행 2. **반환 형식 엄수**: 6줄 형식 외 추가 정보 금지 3. **workId는 Bash로 생성**: LLM이 자체 추정하지 않음 4. **전역 registry.json 직접 쓰기 금지**: init-workflow.sh가 레지스트리 등록을 처리함