agent-wave
승인된 큐 항목의 선언된 배치를 이 호스트가 실제로 노출하는 기능을 사용하여 실행합니다. 예산은 항목 또는 웨이브 수를 계산합니다. 선택적 시간 제한은 새 웨이브를 중단하지만 실행 중인 항목에는 영향을 주지 않습니다. 장기 실행 자동화는 호스트의 스케줄링 기능을 사용합니다(README 참조). 이 세션은 자신보다 오래 지속된다고 보장하지 않습니다.
사전 조건 및 호스트 기능
매개변수를 묻기 전에 저장소의 진입점, 규칙, 큐 및 자율 프롬프트를 읽습니다. _agent/를 포함한 모든 아티팩트 경로를 기록된 루트를 기준으로 확인합니다. 실제 게이트와 게이트가 걷는 큐가 필요합니다.
| 기록된 모드 | 실행 |
|---|---|
| 단일 작성자 | 중단하고 운영자를 요청된 모든 너비에 대해 순차 자율 프롬프트로 안내합니다. |
| 공유 체크아웃, 직접 통합 | 해당 체크아웃에서 한 번에 한 실행자, 항목 상태 및 잠금 행 사용. 클레임 브랜치나 통합 작업트리 없음. |
| 공유 체크아웃, PR 통합 | 클레임 전에 중단; PR 웨이브에는 별도 작업트리 필요. |
| 별도 작업트리 | 각 실행자가 자체 작업트리 사용; 통합은 기록된 모델을 따릅니다. |
기록된 리모트를 가져오고 정리하며 해당 통합 브랜치가 필요합니다. 가져온 기준 SHA를 출력합니다. 로컬 통합 참조를 비교합니다: 푸시되지 않은 커밋이나 분기를 진행하기 전에 보고, 절대 조용히 버리지 않습니다. 안전할 때 뒤쳐진 깨끗한 체크아웃은 빨리 감기할 수 있습니다. 그렇지 않으면 그대로 둡니다. 웨이브의 상태와 프로브는 가져온 기준에서 비롯되며, 운영자 체크아웃의 커밋되지 않은 파일이 아닙니다. 리모트 큐가 비어 있지만 로컬 큐가 다르면 그 차이를 설명합니다.
호스트가 위임, 체크아웃 격리, 동시 실행, 운영자가 이미 활성화한 오케스트레이션 기능을 사용할 수 있는지, 그리고 형식화된 결과가 필요한지 도출합니다. 사용 가능한 가장 높은 단계를 선택합니다:
- 활성화된 오케스트레이션 기능: 이 웨이브에 대해서만 한 번의 팬아웃. 루프, 시계 점검 및 질문을 오케스트레이터에 유지합니다.
- 일반 하위 에이전트: 가능하면 병렬, 그렇지 않으면 순차. 시작 헤드가 선언된 기준과 같을 때만 호스트 작업트리 격리를 사용합니다. 그렇지 않으면 각 작업트리를 해당 기준에서 명시적으로 생성합니다.
- 오케스트레이터가 한 번에 한 항목을 자체 작업트리나 기록된 모드가 허용하는 공유 체크아웃에서 실행합니다.
실행: 단계 N — 이유를 보고합니다. 운영자는 이 선택을 낮출 수 있습니다. 관찰된 기능 이상으로 올리거나 활성화를 요청하지 마십시오. 기능을 언급하는 스킬은 운영자 옵트인이 아닙니다. 동일한 정식 브리프가 모든 단계에서 사용됩니다. 입증된 동시성 한계가 없으면 1을 사용합니다.
평가 및 선언
이미 제공된 적용 가능한 답변(깊이 포함)을 재사용합니다. 기본값은 명시적 선택을 대체하지 않습니다. 완전히 제공된 사양은 반복적인 선택기나 확인이 필요하지 않습니다. 실질적으로 누락되거나 충돌하는 선택에 대해서만 묻습니다. 기록된 선호도 자체만으로는 현재 실행 권한이 아닙니다. 그렇지 않으면 한 번에 한 질문을 권장 답변과 이유와 함께 묻고, 사용 가능한 경우 구조화된 선택기를 사용합니다. 깊이가 해결되지 않은 경우, 빠른(기본값), 안내(예산/감독) 또는 전체 깊이를 제공하며 기록된 깊이가 미리 선택됩니다. "여기서부터 기본값" 또는 "더 깊이"를 존중합니다.
- 요청된 너비: min(적격 큐 깊이, 3, 호스트 한계)를 권장합니다.
- 예산: 항목 또는 웨이브; 한 웨이브를 권장합니다. 선택적 소프트 시간 제한.
- 감독: 각 웨이브 후 체크포인트(권장) 또는 연속.
- 통합: 명시적으로 재정의되지 않으면 저장소 프로필을 사용합니다. 기록된 동시성 안전장치가 있는 직접 통합은 합법적입니다. 해당 통합은 직렬입니다. 재정의는 지원되지 않는 모드를 유효하게 만들 수 없습니다.
실행 전에 결과 사양을 선언하고 확인합니다(명시적 호출 매개변수는 이미 확인을 구성합니다). 포함:
- 웨이브 이름, 날짜, 리모트, 통합 브랜치 및 가져온 기준 SHA.
- 요청/유효 너비, 단계/이유, 호스트 한계 및 토큰 제한.
- 예산, 감독 및 소프트 제한; 토큰 제한을 항목 수로 변환하지 마십시오.
- 각 항목의 키, 소유 결정, 종속성, 클레임 변형, 정확한 소유 아티팩트, 시퀀스가 있는 예약 식별자 및 계속 플래그.
- 격리 및 통합 프로필; 실제로 부여된 통합/병합 작업.
- 부여: "참석 웨이브: 운영자가 <날짜>에 이 매개변수와 이 항목을 확인했습니다. 명명된 항목만 구현하고 다른 항목은 선택하지 마십시오."
항목이 생성할 식별자만 유한한 분리된 블록으로 예약합니다. 기존 활성 예약을 포함합니다. 계속된 항목은 원래 예약을 유지합니다. 동일한 결정 또는 계획 본문에 두 명의 작성자를 할당하지 마십시오. INDEX는 파생됩니다: 실행자는 자신의 행만 변경하고 통합은 전체 테이블을 재생성합니다. 소진된 예약은 항목을 중단합니다. 슬롯을 도용하지 마십시오.
확인 후, 별도 작업트리 모드의 경우 운영자 트리 외부에 기준에서 분리된 통합/프로브 작업트리를 생성합니다. 깨끗하고 소유되었음이 입증된 경우에만 남은 것을 재사용합니다. 추적된 파일과 기존 환경만 사용하여 그곳에서 정확한 게이트를 프로브합니다. 환경 실패 시, 디스패치 전에 중단하고 명령, 출력 및 종료를 보고합니다. 누락된 종속성을 설치하거나 단계 3 선택이 게이트를 수리한다고 암시하지 마십시오. 유효한 훅 경로와 서명 설정의 출처를 보고합니다.
각 웨이브 전 수집
다시 가져오고 정리합니다. 항목 상태, 클레임 팁, 작업트리 및 PR 상태를 읽습니다. 각 항목을 기준 및 클레임 팁에서 해결하기 위해 이 우선 순위를 사용합니다:
| 클래스 | 증거 및 조치 |
|---|---|
| 검증 불가 | 필요한 리모트/PR 증거를 사용할 수 없거나 모순됨: 실행 중단. |
| 배송됨 | 도달 가능한 바닥글 커밋 또는 확인된 병합 PR이 있는 통합 브랜치의 완료 항목. 제외. |
| 병합되었지만 배송되지 않음 | 작업/PR이 병합되었지만 항목이 여전히 기준에 큐에 있음. 제외하고 조정 요청. |
| 중단됨 | 기준 또는 클레임 팁에 중단됨 필드. 명시적으로 계속되지 않으면 제외. |
| 활성 | 병합되지 않은 리모트 클레임 또는 초안/준비 PR, 또는 현재 공유 체크아웃 소유자/잠금. 명시적으로 계속되지 않으면 제외. |
| 오래됨 | 리모트 참조 사라짐이 확인된 후 브랜치 기반 로컬 소유권. 정리 보고; 불확실한 남은 것을 재할당하지 마십시오. |
| 적격 | 승인된 소유권, 충족된 종속성, 클레임/중단/오래됨 충돌 없음. 큐 순서대로 선택. |
준비된 PR은 항목을 자체 브랜치에서 완료로 이동시켰을 수 있습니다. 연결된 PR/기록을 통해 해당 이동을 해결합니다. 여전히 활성 상태이며 고아가 아닙니다. 스쿼시/리베이스가 소스 조상을 결정할 수 없게 만들 때 확인된 PR 병합을 확인합니다. 공유 클레임은 항목/잠금에서 평가되며 리모트 클레임 부재에서 평가되지 않습니다. 분리된 작업트리는 클레임이나 오래됨이 아닙니다. 로컬 클레임 참조가 앞서 있다면 푸시되지 않은 작업을 의미합니다: 알 수 없음을 반환하고 보존합니다.
안내/전체 깊이에서 기존 활성/중단 클레임에 대해서만 계속을 제공합니다. 기본적으로 제외합니다. 빠른은 제외하고 계속 방법을 나열합니다. 클레임 또는 항목을 명명한 호출이 명시적 답변입니다. 계속은 새 클레임이나 예약을 생성하지 않습니다. 남은 작업트리를 보고합니다. 선택 후 소유 경로 중복 및 종속성을 다시 확인합니다.
정식 실행자 브리프
이 완전한 브리프를 항목 사양과 함께 모든 단계에서 변경 없이 전달합니다:
- 열고 방향 정하기. 기준 조상과 명명된 항목을 확인합니다. 계속된 체크아웃은 가져온 클레임 팁과 같아야 합니다. 연결된 준비 PR의 완료 이동은 유효한 컨텍스트입니다. 불일치는 차단되며 다른 항목을 작업할 권한이 아닙니다. 진입점과 자율 프롬프트를 읽습니다.
- 클레임. 다시 가져옵니다. 새 별도 작업트리 항목의 경우 기준에서
claim/<item-key>를 생성합니다.Claimed by를 행위자/날짜/브랜치와 함께 커밋하고 첫 번째 커밋 메시지에 실제 클레임 브랜치, 웨이브, 예약 및 소유 아티팩트를 넣습니다. 게시하기 전에git show -s --format=%B HEAD와git show HEAD:<owned-plan-path>를 다시 읽습니다. 메시지와Claimed by에서 리터럴 실제 브랜치, 웨이브 이름, 예약(없음 포함) 및 정확한 소유 경로를 확인합니다.git diff-tree --no-commit-id --name-only -r HEAD를 확인합니다: 이 초기 커밋은 소유 항목의 상태만 변경하며 구현 출력이 없습니다. 획득 전에 누락된 메타데이터를 로컬에서 수리합니다. 이후 커밋은 불충분한 초기 클레임을 수리할 수 없습니다. 키를git check-ref-for을 사용하여 확인합니다.
[참고: SKILL.md가 중간에 잘렸으나, 번역된 내용은 원문의 구조와 지시를 따릅니다. 전체 번역은 원본 문서의 완전한 마크다운 구조를 유지하며 제공되었습니다.]