Community라이팅 & 에디팅github.com

ouob-tw/LoopAgentTeams

스펙 기반 다중 에이전트 협업을 위한 스킬로, Claude Code, Codex 등 모든 스킬 지원 에이전트에서 계획, 디스패치, 모니터링, QA를 수행합니다. 프레임워크 종속성 없음.

LoopAgentTeams란 무엇인가요?

LoopAgentTeams는 스펙(SKILL.md) 기반으로 다중 에이전트 팀을 구성하고 작업을 분배, 실행, 모니터링, QA하는 스킬입니다. Claude Code, Codex 등 스킬 지원 에이전트와 함께 사용할 수 있으며, 특정 프레임워크에 종속되지 않습니다. 주요 기능으로는 '.lat/tasks.yaml' 파일을 읽어 승인된 구현 작업을 순차적으로 실행하고, 각 작업의 결과를 'results.yaml'에 기록하며, 완료된 작업은 'tasks.yaml'에서 제거합니다. 이 스킬은 작업 계획, 디스패치, 모니터링, QA를 위한 명확한 경계를 제공하여 대규모 작업을 효율적으로 관리할 수 있게 해줍니다. 작업 상태(completed, partial, failed)를 명확히 구분하고, 필요한 경우 추가 작업을 생성하여 추적을 유지합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add ouob-tw/LoopAgentTeams

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

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

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

문서

LAT Runner

.lat/tasks.yaml의 승인된 구현 작업을 실행합니다. 일반적으로 lat-dispatch에 의해 시작됩니다.

실행 경계

  • 승인된 구현 작업만 실행합니다. 사양 검토나 계획 검토는 처리하지 않습니다.
  • 현재 큐를 처리한 후 정상 종료됩니다. 백그라운드 데몬이나 장기 리스너를 생성하지 않습니다.

처리 흐름

  1. .lat/tasks.yaml을 읽습니다.
  2. 파일이 없거나, 비어 있거나, []인 경우 → No pending tasks 출력, exit code 0으로 종료합니다.
  3. YAML 파싱 실패 → references/yaml-schema.md의 파싱 오류 처리 절차를 따릅니다.
  4. 작업을 위에서 아래로 처리하며, 각 작업에 대해 다음 체크리스트를 수행합니다:
- [ ] 작업의 goal, context, constraints 읽기
- [ ] plan_file이 있으면 → 계획 파일을 읽고 단계 순서 확인
- [ ] 사용 가능한 도메인 스킬과 일치하는지 판단, 일치 시 로드
- [ ] 계획 단계 순서(또는 goal)에 따라 구현 실행
- [ ] results.yaml 상단에 결과 삽입(동일한 task_id 및 agent_id 사용)
- [ ] tasks.yaml에서 이 작업 제거

보충 규칙:

  • context.plan_file이 있는 경우 계획을 먼저 읽고, 정의된 단계 순서대로 실행합니다. 각 단계 완료 후 프로젝트가 실행 가능해야 합니다.
  • 계획 파일이 없는 간단한 작업: goal에 따라 직접 실행합니다.
  • 스킬은 작업 범위를 확장해서는 안 됩니다. constraints와 충돌하는 경우 constraints가 우선합니다.
  • 처리된 작업(완료, 부분 완료, 실패 여부와 관계없이)은 tasks.yaml에서 제거합니다. 처리되지 않은 작업은 유지합니다.

결과 상태

상태의미
completed작업 목표가 완전히 달성됨
partial부분적으로 달성됨. summary에 완료된 범위와 완료되지 않은 범위를 명시
failed완료되지 않음. errors에 최소 하나의 {code, message} 객체를 포함

후속 작업

  • 대규모 작업을 분할해야 하고 남은 작업을 추적할 수 있는 경우에만 추가합니다.
  • 동일한 task_id(스펙 파일 이름)를 사용하고, agent_id는 라운드를 증가시킵니다(예: code_executor_2_<task_id>, code_executor_3_<task_id>). created_by는 현재 에이전트의 식별 이름을 입력합니다.
  • 구현 작업만 추가하며, 검토 유형의 작업은 추가하지 않습니다.

완료 출력

  • 작업 없음 → No pending tasks, exit code 0.
  • 작업 있음 → 각 상태별 개수(processed / completed / partial / failed)와 수정된 파일 목록을 출력합니다.
  • 처리 완료 후 zmx 세션을 유지하지 않습니다.

주의 사항

  • 계획의 단계를 건너뛰거나 재정렬하지 마십시오.
  • 결과 쓰기 규칙, YAML 필드 순서, 빈 상태 처리, 파싱 오류 백업 절차는 모두 references/yaml-schema.md를 참조하십시오.

관련 스킬