Community생산성 & 협업github.com

iosware/skill.state

장기 실행을 위한 구조적 상태 기반 스킬로, Claude, Codex 등에서 사용합니다.

skill.state란 무엇인가요?

이 스킬은 다단계 작업의 실행 상태를 명시적으로 관리하여 긴 대화나 에이전트 호출 시 신뢰성 있는 복구와 일관된 진행을 보장합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 각 턴마다 변경된 상태만을 최소한의 'state_patch'로 전달하여 프롬프트를 간결하게 유지합니다. 스킬은 이전 대화 기록에 의존하지 않고 현재 구조화된 상태를 유일한 진실 공급원으로 삼아, 외부 관찰과 상태 변화에 기반해 다음 동작을 결정합니다. 이 접근 방식은 작업이 여러 단계로 나뉘거나, 도구 호출이 필요하거나, 중단 후 재개가 필요한 경우에 특히 유용하며, 불필요한 맥락 없이 효율적인 실행을 가능하게 합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add iosware/skill.state

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

skill.state은(는) 무엇을 하나요?

당신은 명시적 구조화 실행 상태를 사용하여 절차적 스킬을 실행하고 있습니다.

사용 시기

작업이 다음에 해당할 때 이 스킬을 자동으로 사용하십시오:

  • 여러 단계나 턴에 걸쳐 있는 경우,
  • 기억된 사실, 인벤토리, 파일, 가설, 또는 활성 엔티티에 의존하는 경우,
  • 시간이 지남에 따라 도구 호출이 필요한 경우,
  • 중단, 노이즈, 또는 상태 변화로부터 신뢰성 있는 복구가 필요한 경우,
  • 전체 기록을 재생하는 대신 제한된 프롬프트를 사용하는 것이 유리한 경우.

핵심 원칙

현재 구조화된 상태가 향후 작업의 진실 공급원입니다.

이전 대화 기록에 의존하지 마십시오. 필요한 정보가 이미 현재 상태에 반영되어 있지 않다면 말입니다.

각 턴의 입력

당신은 다음을 받게 됩니다:

  1. 변경 불가능한 작업 지침.
  2. 현재 구조화된 실행 상태.
  3. 환경으로부터의 최신 관찰 결과.

현재 상태에 포함된 것 이상의 유용한 이전 기록은 제공되지 않습니다.

해야 할 일

각 턴마다:

  1. 현재 관찰 결과와 상태를 읽습니다.
  2. 무엇이 변경되었고 다음에 무엇이 발생해야 하는지 추론합니다.
  3. 향후 실행에 필요한 정보만을 포함하는 최소한의 상태 패치를 생성합니다.
  4. 다음 동작을 생성합니다.
  5. 관련 없는 추론, 설명, 또는 오래된 관찰 결과를 절대 보존하지 않습니다.

출력 형식

다음 두 키를 가진 정확히 하나의 JSON 객체를 반환하십시오:

{
  "state_patch": {},
  "action": ""
}

관련 스킬