Communitygithub.com

jaidetree/gracieanimator

사용자가 /afk를 호출하거나 Gracie 포트폴리오 사이트가 사람의 개입 없이 완료될 때까지 자동으로 작업을 처리하는 스킬입니다. 준비된 티켓을 하나씩 순차적으로(독립적인 것은 병렬로) 처리하여 배송할 것이 없을 때까지 반복합니다.

gracieanimator란 무엇인가요?

이 스킬은 Gracie 포트폴리오 사이트를 단일 세션에서 완료 상태로 이끌기 위해 설계된 자동화 에이전트입니다. 'ready-for-agent' 태그가 있고 모든 의존성이 해결된 '프론티어' 티켓만을 찾아 사람의 입력 없이 구현합니다. 각 티켓은 격리된 작업 트리에서 `/slice` 명령어로 처리되며, 모든 수락 기준이 통과되면 `Done` 상태로 이동됩니다. 병렬 처리는 프론티어 티켓이 서로 블로킹하지 않는다는 점을 활용하여 안전하게 수행되며, 이후 통합 브랜치에서 충돌을 해결하고 빌드/린트/테스트를 다시 실행합니다. 모든 티켓이 완료되면 최종 수동 테스트 가이드를 작성하여 사람이 한 번만 테스트할 수 있도록 합니다. Cursor, Claude Code, Codex 등 다양한 AI 에이전트 플랫폼과 호환됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jaidetree/gracieanimator/tree/HEAD/.claude/skills/afk

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

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

문서

AFK

Gracie 포트폴리오 사이트를 한 세션에서 완성으로 이끕니다: 사람의 입력 없이 구현할 준비가 된 모든 티켓을 반복적으로 찾아 각각을 Done까지 배송하고 결과를 통합합니다 — 더 이상 남은 티켓이 없을 때까지 라운드별로 반복합니다. 수동 테스트는 맨 마지막에, 단일 프로젝트 전체 가이드에 대해 한 번만 수행되며 티켓별로 수행되지 않습니다.

프론티어

티켓이 ready-for-agent 태그를 가지고 있으며 모든 blocked_by 의존성이 이제 .../Done/에 있는 파일로 해결될 때 해당 티켓은 프론티어입니다. .gracie-vault/Projects/gracie-portfolio/issues/Ready/에서 계산합니다. Ready/에 프론티어 자격 티켓이 없는 경우에만 Backlog/에서 계산합니다. 프론티어 티켓은 사람에게 필요한 것이 없습니다 — 서로를 블로킹하지 않기 때문에 서브에이전트에게 병렬로 안전하게 전달할 수 있는 티켓입니다.

단계

  1. 지식 요약을 읽습니다: scan-knowledge.sh .gracie-vault/Knowledge (knowledge 스킬에서 제공); 가장 관련성 높은 요점을 표면화합니다.
  2. 프론티어를 계산합니다(위 참조): Ready/를 먼저, Ready/에 프론티어 자격 티켓이 없으면 Backlog/를 사용합니다.
  3. 프론티어가 비어 있습니까?
    • Backlog/에 ready-for-agent 태그가 없는 티켓이 있습니다: 작업 가능 상태가 되려면 /triage가 필요합니다. 개수를 보고하고 중단합니다.
    • Backlog/도 비어 있거나(또는 남아 있는 모든 티켓이 블로킹됨) 프로젝트가 완료되었습니다 — 8단계로 건너뜁니다.
  4. 전체 프론티어를 한 메시지로 디스패치 — 티켓당 하나의 서브에이전트, 각각 isolation: worktree. 프론티어 티켓이 서로를 블로킹하지 않기 때문에 병렬 디스패치가 안전합니다. 각 서브에이전트에게 격리된 복사본에서 다음을 수행하도록 지시합니다:
    1. /slice <ticket>을 종단간 실행 — 티켓을 Review를 통해 진행하고 이제 해당하는 수락 기준을 확인합니다.
    2. /slice가 사람을 위해 멈추는 곳에서 대신 루프를 닫습니다: diff에 대해 티켓의 수락 기준을 다시 읽습니다. 모든 항목이 체크되고 make build/make lint, make test가 통과하는 것이 여기서 사람의 리뷰를 대신합니다 — 티켓을 Review → Done으로 이동하고 해당 이동을 커밋합니다.
    3. 티켓 이름, 최종 상태(Done 또는 항목이 확인되지 않으면 이유와 함께 Review에 남김), 그리고 /slice가 생성한 수동 테스트 단계를 반환합니다.
  5. 각 서브에이전트가 보고할 때 디스패치 순서대로 한 번에 하나씩 통합: 작업 트리 브랜치를 병합합니다(커밋 포함, Done 이동 포함) — 그런 다음 통합 브랜치에서 make build/make lint, make test를 다시 실행하여 결합될 때만 나타나는 문제를 잡습니다. 충돌은 resolving-merge-conflicts 스킬로 해결하며, 절대 --abort 하지 않습니다. 병합 후 작업 트리를 삭제합니다. 보고된 수동 테스트 단계를 티켓별로 실행 중인 프로젝트 전체 목록에 추가합니다.
  6. 지연자. Review에 남아 있는 티켓 — 확인되지 않은 수락 기준, 서브에이전트가 수정할 수 없는 실패한 검증, 또는 슬라이스 중간에 발생한 HITL 블로커 — 은 지연자입니다. 이번 라운드에서 재시도 대상이 아닙니다. 이유와 함께 실행 중인 지연자 목록에 추가하고 계속 진행합니다. 여전히 병합(5단계)되므로 diff가 손실되지 않습니다.
  7. 프론티어를 다시 계산합니다 — Done/에 있는 병합된 티켓이 다른 티켓을 차단 해제할 수 있음 — 4단계로 이동합니다.
  8. 수동 테스트 가이드 작성. 하나의 파일, .gracie-vault/Projects/gracie-portfolio/MANUAL-TESTING.md: 각 Done 티켓별 섹션(이름, 링크, 수집된 단계)과 티켓이 관련 표면을 다루는 경우 프로젝트 전체에 대한 짧은 종단간 패스를 포함합니다. 이것이 사람의 유일한 수동 테스트 진입점입니다 — 티켓별 테스트는 없습니다. 커밋한 다음 보고합니다: Done으로 배송된 모든 것, 지연자 목록, 가이드에 대한 포인터.

관련 스킬