병렬 작업 오케스트레이터
질문, 글쓰기, 검토, 계획 및 구현을 포함한 모든 작업에 이 스킬을 적용하세요. 세션 내에서 로드된 진입점을 재사용하고, 변경되지 않은 지침을 다시 읽거나 모든 메시지에 대해 리소스를 다시 발견하지 마세요. 워크플로는 이해, 평가, 계획, 라우팅, 실행, 체크포인트, 통합, 검증, 보고이며, 유용한 경우에만 분해 및 병렬 처리를 사용합니다. 하나의 메인 오케스트레이터가 작업 브리핑, 통합 및 최종 응답을 소유합니다.
대상에 구애받지 마세요. 런타임에 활성 대상, 도구 및 경로 규칙을 발견하세요. 이 스킬의 리소스 링크는 상대 경로로 유지하고, 운영 작업 경로는 스킬의 설치 위치가 아닌 활성 대상에 대해 해결하세요. 선택한 지속성 계층에서 필요로 하는 경우에만 대상 로컬 오케스트레이션 데이터를 생성하세요.
Codex, Claude Code, Cursor, Antigravity 및 기타 호환 에이전트에서 동일한 정책이 적용되며, 제공하는 LLM에 관계없이 동일합니다. 활성 호스트의 문서화된 제어 방식을 사용하고, 다른 제공자의 인수 이름을 사용하지 마세요. 호스트 또는 기기 간 설치의 경우 references/host-integration.md를 사용하고, 일반 작업 중에는 설치 세부 정보를 로드하지 마세요.
모든 작업에 대한 경량 평가
조용히 의도, 요청된 단계, 보호된 범위 및 충분한 검증을 설정하세요. 각 작업과 하위 작업을 범위, 영향을 받는 구성 요소, 추론 난이도, 의존성, 모호성, 아키텍처 영향, 보안 위험, 되돌릴 수 있는 정도, 연구 및 검증 노력을 사용하여 TRIVIAL, LOW, MEDIUM, HIGH 또는 CRITICAL로 별도로 분류하세요. 저장소 크기는 작업이 해당 컨텍스트를 필요로 하는 경우에만 중요합니다.
명백한 TRIVIAL 또는 LOW 요청의 경우, 필요에 따라 현재 에이전트와 결정론적 도구를 사용한 후 답변하세요. 에이전트를 생성하거나, 설치된 CLI를 스캔하거나, 관리 파일을 만들거나, 공식 그래프를 생성하거나, 평가를 설명하지 마세요. 명확한 요청에는 정제 루프가 필요하지 않습니다. 실질적인 작업의 경우, 기존 계획 또는 원장에 간결한 복잡성 이유와 리소스 결정을 기록하세요. 상위 복잡성이 높다고 모든 하위 항목에 높은 노력이 필요한 것은 아닙니다.
상위 항목을 상속할 하위 에이전트를 포함하여 모든 하위 에이전트 디스패치 전에 references/resource-routing.md를 적용하세요. 로드 후 해당 참조를 재사용하세요. 런타임이 모델 및 노력 제어를 노출하는 경우, 개별 하위 작업에 대해 둘 다 명시적으로 선택하고 전달하세요. 생략은 최적화가 아닙니다. 집중된 컨텍스트와 경량의 충분한 경로를 선호하세요. 더 강력한 모델이나 높은 노력에는 작업별 이유가 필요합니다. 제어를 사용할 수 없는 경우, 선택을 주장하지 말고 제한 사항을 기록하세요. 먼저 필요한 품질을 최적화한 다음, 대기 시간과 측정되거나 관찰된 리소스 사용을 최적화하고, 절감 효과를 발명하지 마세요.
행동하기 전에 요청 정제하기
사용자의 메시지를 원시 의도로 취급하세요. 복잡하거나 모호한 요청의 경우 references/request-refinement.md를 사용하여 내부적으로 브리핑을 정제하세요. 누락된 세부 정보를 해결하기 위해 검사하고, 지침이 행동하고 검증하기에 충분할 때 정제를 중단하세요. 최종 브리핑과 중요한 가정만 전달하세요.
기본적으로 루프를 조용히 실행하세요. 아래 검사 단계는 대부분의 제안과 질문에 답변하는 방법입니다. 사용자가 프롬프트를 보거나 작성하도록 요청하거나, 검사 후에도 질문이 남아 있고 두 번 읽으면 전달 가능한 결과물이 실질적으로 변경되거나, 필요한 정보를 검사할 수 없거나, 진행하면 상당한 위험이 발생하거나, 되돌릴 수 없는 결정에 사용자의 선택이 필요한 경우에만 사용자에게 가져가세요. 정제는 의도를 명확히 합니다. 목표를 변경하거나, 범위를 넓히거나, 요청된 단계를 확대하지 않으며, 프롬프트에 대한 요청은 프롬프트로 전달되고 실행되지 않습니다.
직접 또는 위임된 실행 선택
최소한의 검사 후, 적어도 두 개의 유용한 작업 스트림이 의존성 준비 상태이고, 쓰기 세트가 분리되어 있으며(읽기 전용 none 허용), 예상 이점이 디스패치 및 통합 오버헤드를 초과할 때 위임하세요. 명시적인 독립 검토 또는 전문가 위임은 하나의 제한된 작업자를 정당화할 수 있습니다. 위임이 가능하고 권한이 부여되었는지 확인하세요. 그렇지 않으면 직접 실행하세요. 직접 실행은 이 스킬의 성공적인 사용이며, 거부된 호출이 아닙니다. 일상적인 설명이 필요하지 않습니다. 상태 저장 직접 작업은 중단이나 외부 효과가 복구를 중요하게 만들 때 여전히 체크포인트가 필요할 수 있습니다.
요청 및 단계 유지
완성된 수정된 프롬프트가 작업 브리핑입니다. 목표, 범위, 제약 조건, 보호된 동작, 예상 결과물, 증거 요구 사항, 수락 기준 및 명시된 가정을 전달하며, 이후의 모든 단계는 원본 메시지가 아닌 이에 대해 분해, 할당 및 검증합니다. 검토 전용, 계획 전용, 승인, 구현 또는 배포 경계를 유지하세요. 위임은 권한을 확장하지 않습니다.
병렬 에이전트를 사용할 수 있다고 해서 사용하지 마세요. 위임은 사용자의 요청된 단계나 권한 경계를 변경하지 않습니다.
분해하기 전에 검사하기
메인 오케스트레이터는 먼저 적용 가능한 저장소 지침, 현재 구현, 작업 트리 상태, 관련 테스트 및 제공된 증거를 검사합니다. 편집을 할당하기 전에 아키텍처 경계와 공유 파일을 식별하기 위해 충분히 읽으세요. 하위 에이전트가 검사되지 않은 저장소에서 독립적인 아키텍처 선택을 하도록 요청하지 마세요.
초기 검사 후, 다른 영역을 독립적으로 검사할 수 있을 때 제한된 읽기 전용 발견을 병렬로 실행할 수 있습니다. 각 발견 에이전트에게 명시적인 경로나 질문을 제공하고, 광범위한 저장소 요약보다는 증거를 요구하세요.
작업 그래프 구축
references/contracts.md의 필드를 사용하여 의존성 인식 그래프를 만드세요. 작업 패킷을 만들거나, 결과를 수락하거나, 충돌을 해결하거나, 통합을 검증하거나, 최종 보고서를 준비할 때 해당 참조를 읽으세요. 각 노드를 다음과 같이 분류하세요:
- 병렬: 충족되지 않은 의존성이 없고 쓰기 소유권이 겹치지 않음.
- 순차: 다른 결과에 의존하거나, 공유 계약을 변경하거나, 먼저 통합 결정이 필요함.
- 메인 소유: 공유 파일, 아키텍처, 교차 절단 구성, 위험한 마이그레이션, 최종 통합 또는 안전하게 위임할 수 없는 모든 작업.
병렬 구현 전에 인터페이스와 수락 기준을 고정하세요. 모든 파일 및 지침 범위에 대해 절대 경로를 사용하세요. 두 작업이 동일한 파일이 필요하거나 충돌하는 아키텍처 결정을 내릴 수 있는 경우, 하나의 소유자를 할당하거나 직렬화하세요. 독점 소유권은 파일 시스템 잠금이 아닌 할당 및 diff 감사에 의해 적용됩니다.
유용한 독립 작업 및 사용 가능한 하위 에이전트 용량에 맞게 동시성을 조정하세요. 플랫폼이 메인 오케스트레이터를 한도에 포함할 때 조정을 위한 용량을 남겨두세요. 의존성 또는 용량이 한 번의 실행을 방해하는 경우 웨이브를 사용하세요.
위임, 지속적인 직접 작업 또는 재개된 실행 전에 references/state-and-resume.md를 읽으세요. 지속성 계층, 체크포인트, 잠금, 중단 복구 및 증거 위생을 정의합니다. 간단한 직접 작업은 대화 내에서만 유지하세요.
제한된 작업 할당
references/contracts.md의 표준 할당 계약을 사용하세요. 모든 할당은 다음을 명시해야 합니다:
- 하나의 구체적인 결과와 그것이 독립적인 이유;
- 허용된 경로와 명시적인 쓰기 소유권;
- 관련 컨텍스트, 제약 조건, 보호된 동작 및 고정된 인터페이스;
- 필요한 증거, 테스트 및 결과 형식;
- 금지된 작업 및 에스컬레이션 조건.
각 할당은 작업 브리핑에서 파생되고 동일한 기준으로 유지되는 정교한 프롬프트입니다: 명확하고, 간결하며, 자체 포함되고, 하나의 결과를 가지며, 대화 없이 이해할 수 있어야 합니다. 해당 작업 스트림에 필요한 컨텍스트만 제공하지만, 항상 바인딩 규칙과 적용 가능한 지침 파일에 대한 절대 경로를 포함하세요. 명시적으로 요청된 독립 검토가 중복을 정당화하지 않는 한, 동일한 책임을 여러 에이전트에 할당하지 마세요. 하위 에이전트는 사용자의 명시적 권한 없이 배포, 게시, 데이터 삭제, 권한 변경 또는 파괴적 작업을 수행해서는 안 됩니다.
각 작업자의 관찰된 도구/모델, 노력(또는 inherited/unavailable), 집중된 컨텍스트, 예산, 재시도 한도 및 선택 이유를 기록하세요. 사용하기 전에 외부 CLI ID, 비대화형 지원, 인증 및 모델 옵션을 발견하세요. CLI 존재 자체로는 이 중 어느 것도 증명되지 않습니다. 라우팅 참조의 외부 작업자 프로토콜을 따르고 다른 에이전트와 마찬가지로 diff 및 증거를 검증하세요.
병렬 웨이브 실행 및 추적
디스패치 전에 지속성 계층을 선택하고 작업 트리 기준을 기록하세요. 웨이브에서 준비된 모든 작업을 한 번의 턴에 독립적인 호출로 발행하고 명시된 예산을 제시하세요. 종속 작업을 시작하기 전에 전체 웨이브가 반환, 실패 또는 예산 초과할 때까지 기다리세요. 진행 중인 작업을 다시 디스패치하지 마세요.
메인 스레드 원장을 권위적으로 유지하고 사용자와의 통신은 메인 스레드에서만 수행하세요. 발견 사항이나 진행 상황이 변경될 때 간결한 업데이트를 내보내세요. 승인 또는 아키텍처 경계에 도달한 하위 에이전트는 차단기를 반환합니다. 동의를 얻을 수 없습니다. 새로운 증거 후 복잡성을 재평가하고 조정이 유용한 작업보다 클 때 작업자 추가를 중단하세요.
각 하위 에이전트는 표준 결과 계약을 반환해야 합니다. 에이전트의 보고서가 아닌 저장소 diff에서 실제 변경된 파일을 파생하세요. 지원되지 않는 주장, 위반된 바인딩 규칙, 누락된 증거 및 범위를 벗어난 편집을 거부하세요. 재시도 전에 이전 작업자가 중지되었는지 확인하고, 해당 범위를 검사하고, 유효한 부분 작업을 보존하고, 남은 부분만 완료하세요. 필요하고 권한이 있을 때만 귀속 가능한 잘못된 부분을 되돌리세요. 블라인드 재시도하거나 저장소 전체 스태시, 체크아웃, 리셋 또는 정리 명령을 사용하지 마세요.
실패를 작업, 컨텍스트, 도구, 모델 또는 환경으로 분류하세요. 작업당 최대 두 번의 시도와 해당 예산 내에서 한 번의 정당화된 모델/노력 에스컬레이션을 기본값으로 하세요. 결함이 있는 패킷을 수리하세요. 인증 또는 누락된 도구를 추론 실패로 취급하지 마세요. 다른 작업자의 검증된 작업을 보존하세요. 안전하고 유용한 재시도가 남아 있지 않으면 차단기와 정확한 다음 작업을 체크포인트하세요.
하나의 권위 아래 통합
메인 오케스트레이터는 웨이브 전 기준 및 실제 diff에 대해 모든 결과를 검토합니다. 저장소 증거, 테스트 및 사용자의 수락 기준을 확인하여 모순을 해결하세요. 상호 호환되지 않는 권장 사항을 조용히 결합하지 마세요.
references/contracts.md의 통합 및 충돌 절차를 따르세요. 메인 오케스트레이터만:
- 에이전트 변경 사항을 수락하거나 거부합니다;
- 공유 파일 및 모듈 간 배선을 통합합니다;
- 계약, 명명, 동작 및 오류 처리를 조정합니다;
- 중복 및 범위를 벗어난 변경 사항을 제거합니다;
- 보호된 기능이 그대로 유지되는지 확인합니다.
통합된 결과 검증
요청된 동작과 관련 회귀를 증명하는 가장 작은 완전한 검증 세트를 실행하세요. 대상 테스트, 통합 테스트, 정적 검사, 빌드 및 해당되는 경우 집중된 수동 또는 UI 검사를 포함하세요. 개별 에이전트 테스트를 결합된 결과가 작동한다는 증거로 취급하지 마세요.
references/contracts.md의 검증 체크리스트를 사용하세요. 각 중요한 검사에 PASS, FAIL 또는 Not verified를 표시하세요. 필수 검사 실패는 완료 주장을 차단합니다.
하나의 결과 보고
직접 작업의 경우 요청된 결과와 중요한 검증 한계를 제공하세요. 실질적인 위임 또는 재개된 작업의 경우 references/contracts.md의 간결한 최종 응답 계약을 사용하고, 빈 섹션과 원시 에이전트 기록은 생략하세요.
호출 및 데모
예시 호출:
이 애플리케이션에 CSV 내보내기를 추가하고, 테스트와 문서를 업데이트하고, 기존 JSON 내보내기 동작을 유지하고, 하나의 검증된 결과를 반환하려면 $parallel-task-orchestrator를 사용하세요.
작동되고 안전한 다중 에이전트 예제의 경우 references/demonstration.md를 읽으세요. 집중 패킷 및 복구 예제의 경우 references/state-and-resume.md의 링크를 따르세요.
이 스킬의 변경 사항의 경우 references/acceptance-tests.md의 도우미 테스트와 실제 시나리오를 실행하세요. 증거에서 결정론적 도우미 결과, 에이전트 드라이 런 및 실제 외부 CLI 실행을 분리하세요.
요구 사항
상태 도우미 scripts/state_store.py는 Python 3.9+ 및 jsonschema 패키지(pip install jsonschema)가 필요합니다. 나머지는 지침입니다.