Community라이팅 & 에디팅github.com

troels-im/agent-skills-playbook-template

점진적인 문서-코드 템플릿으로, AI 에이전트 스킬, AGENTS.md, 플레이북, 작업 추적, just 테스트 정책을 제공합니다.

agent-skills-playbook-template란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 저장소 작업을 수행할 때 최소한의 토큰만 사용하는 명령 표면(command surface)을 제공합니다. AGENTS.md, 루트 index.md, flows/index.md를 순서대로 읽고, 가장 작은 일치하는 플로우(flow)를 선택하여 실행합니다. 각 플로우 실행은 UTC 타임스탬프가 포함된 실행 체크리스트 파일(run-YYYYMMDDTHHMMSSZ-short-slug.md)을 생성하여 추적합니다. 또한 모든 커밋 전에 `just turn-test`를 실행하고, 플로우 마지막 단계에서 `just pr-test`를 실행하여 품질을 보장합니다. 사용자 입력이 필요한 단계에서는 추론 없이 루프를 일시 중지하고 명시적으로 질문하며, 불일치하는 플로우가 없으면 `playbooks/repository/choose-workflow.md`로 라우팅합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add troels-im/agent-skills-playbook-template

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

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

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

문서

Lets

이 스킬을 저장소 흐름을 위한 저토큰 명령 표면으로 사용하세요.

워크플로우

  1. AGENTS.md를 읽습니다.
  2. 루트 index.md를 읽습니다.
  3. flows/index.md를 읽습니다.
  4. 가장 작은 일치하는 플로우를 선택합니다.
  5. 선택한 플로우 파일을 로드합니다.
  6. 해당 플로우에 의해 이름이 지정된 플로우 실행 체크리스트를 생성하거나 업데이트합니다. 생성된 실행 이름에는 UTC 타임스탬프 슬러그를 사용하세요: run-YYYYMMDDTHHMMSSZ-short-slug.md.
  7. 현재 단계에서 필요로 하고 플로우에 의해 이름이 지정된 플레이북만 따릅니다.
  8. 진행 상황 업데이트 앞에는 플로우에서 요구하는 형식을 붙입니다: XX% / YY% / ZZ%: message.
  9. 모든 커밋 전에 just turn-test를 실행합니다.
  10. 플로우의 마지막 단계에서 just pr-test를 실행하고, 실패한 PR 테스트를 수정한 후 PR 테스트가 통과하거나 실제 차단 항목이 기록될 때까지 반복합니다.

사용자 입력 게이트

플로우 단계에서 올바르게 계속하기 위해 사용자 입력, 승인, 제품 결정 또는 피드백이 필요한 경우 루프를 일시 중지하고 질문하세요. 누락된 결정을 추론하거나 추측된 요구사항에 따라 계속 진행하지 마십시오.

사용자가 명시적으로 방해하지 말라고 하거나, 질문하지 말라고 하거나, 최선의 판단으로 진행하라고 하거나, 이에 상응하는 지시를 내린 경우에만 질문 없이 계속하세요. 그렇게 할 때는 가정을 실행 체크리스트에 기록하고 가능한 경우 되돌릴 수 있도록 유지하세요.

일치하는 플로우가 없으면 명확히 말하고 playbooks/repository/choose-workflow.md를 통해 라우팅하세요.

/goal 또는 /loop를 이 템플릿의 사용자 명령으로 취급하지 마세요. 사용자 대면 명령으로 /lets를 사용하고 flows/를 내구성 있는 저장소 계층으로 사용하세요.

관련 스킬