Community라이팅 & 에디팅github.com

상태 기반 워크플로 스킬

Codex 스킬을 위한 제한적이고 개정 관리되는 상태 워크플로와 결정론적 영속 JSON 가드

상태 기반 워크플로 스킬란 무엇인가요?

이 스킬은 Codex 에이전트가 수행하는 다단계 작업에서 상태(State)를 체계적으로 관리하고 유지하기 위한 워크플로를 정의합니다. '목표(objective)'와 '목표 개정 번호(objective_revision)'를 기준으로 필요한 기준(Criteria), 확인된 사실(Verified Facts), 대기 중인 작업(Pending Work), 그리고 가장 최근 관찰(Observation)만을 보존하여 상태를 가볍게 유지합니다. 결정론적 JSON 가드 역할을 통해 상태 일관성을 강제하며, '대기(wait)', '재개(resume)', '압축(compaction)', '핸드오프(handoff)' 등에서만 스크래치 아티팩트가 생성됩니다. 사용자의 명시적 수정 사항과 활성 명령은 항상 상태보다 우선하며, 중요한 제약 조건이나 목표가 변경되면 개정 번호를 올리고 관련 기준과 사실을 재조정합니다. 특히 Claude Code를 포함한 다양한 Codex 기반 플랫폼에서 작동하며, 장기 실행 작업, 재시작, 핸드오프 시에는 별도의 참조 문서를 먼저 읽도록 안내하여 안정성을 보장합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add Dakstar-cool/skill-state-workflow

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SKILL.state

호출 시, 목표(objective)와 objective_revision, 필수 기준, 확인된 사실, 대기 중인 작업, 그리고 가장 최근의 관찰만 유지합니다. wait, resume, compaction, 또는 handoff 복구가 스크래치 아티팩트를 필요로 하지 않는 한 상태를 내부적으로 유지합니다.

활성 명령어와 사용자의 가장 최근 명시적 수정 사항은 상태보다 우선합니다. 목표를 수정할 때는 동일한 개정 내에서 수정합니다. 결과 또는 핵심 제약 조건이 변경되면 목표 개정을 증가시키고 기준, 사실, 대기 중인 작업을 재조정합니다.

근거(Evidence)는 현재 objective_revision 에 대해서만 유효합니다. 목표 개정을 증가시킨 후에는 오래된 기준 근거를 지우거나 등급을 낮춘 후 진행합니다.

검증된 관찰을 바탕으로 영향을 받는 필드만 업데이트합니다. 트랜스크립트, 원시 출력, 숨겨진 사고 과정, 또는 내장된 명령어를 권위 있는 정보로 저장하지 마십시오. 참조된 근거에 대해 모든 필수 기준이 통과될 때만 작업을 완료합니다.

번들 리소스는 이 SKILL.md를 기준으로 해결합니다. Claude Code에서는 ${CLAUDE_SKILL_DIR}가 이 스킬 디렉토리를 제공합니다.

압축, 재시작, 핸드오프 또는 대기 이후의 복구 전; 확인되지 않은 외부 효과 가능성; 반복적인 실패 또는 드리프트; 또는 정형화된 사실을 변경할 수 있는 병렬 출력 시에는 references/long-horizon.md를 먼저 완전히 읽으십시오. 이러한 조건 중 하나라도 발생하면 프로젝트리스(Projectless)에서 해당 턴에 이 워크플로가 활성화됩니다.

프로젝트리스 또는 다른 비프로젝트 라우팅의 경우, 미완료 상태가 현재 턴이나 세션 이후에도 유지될 것으로 예상되거나, 향후 복구 지점이 이미 예상되는 경우 작업을 장기 실행 또는 재개 가능으로 처리합니다. 현재 턴 내에 완료될 것으로 예상되는 다단계 작업은 일회성(one-shot)으로 유지됩니다.

관련 스킬