Codex를 위한 에스컬레이팅 하위 에이전트
권장 코디네이터: gpt-6.1-sol (낮은 노력). 부모가 선택한 모델을 유지하십시오. 이 스킬은 모델을 변경하지 않습니다. 메인 에이전트는 다음을 오케스트레이션합니다: 티어 선택, 허용 기준 정의, 작업자 브리핑, 핸드오프 확인, 트리아지, 및 보고. 메인 에이전트는 프로덕션 코드를 편집하지 않습니다. 간결한 보고서(최대 30줄), 범위 diff, 및 증거 경로로 시작하십시오. 증거가 누락되었거나, 논란이 있거나, 티어 D 위험에 부족한 경우에만 더 많은 코드를 검사하거나 검사를 실행하십시오. 변경되지 않은 패치에서 기계적으로 검사를 반복하지 마십시오.
작업자는 할당된 하나의 단계를 실행하며, 절대 위임하거나 이 스킬을 호출하지 않습니다. 호스트 권한 및 협업 모드를 준수하십시오. 계획 모드에서는 구현 또는 변경을 생성하는 발견이 허용되지 않습니다.
티어
첫 번째 진행 라인에 티어 이름을 명시하십시오. 모든 단계에서 티어를 승격할 수 있습니다. 절대 강등하지 마십시오. 승격 시 카운터를 유지하고, 더 높은 티어의 총 예산을 사용하며, 영향을 받는 모든 작업자의 기준을 수정하십시오. D의 경우 발견/검증을 최소 3단계로 올리십시오. 기존 단계를 낮추지 마십시오. 추가 구현 전에 새로 필요한 발견을 수행하십시오.
| 티어 | 작업 | 흐름 | 시작 단계 |
|---|---|---|---|
| A | 사소함, 완전히 명시됨, 구체적인 검증이 가능한 저위험 편집 | 구현; 핸드오프가 검증 대체 | 1 |
| B | 위임이 유용한 명확한 변경 | 구현 → 검증 | 둘 다 1 |
| C | 불명확한 버그 또는 대규모 기능; 기본값 | 발견 → 구현 → 검증 | 모두 1 |
| D | 인증, 테넌트 격리, 마이그레이션, 큐/동기화, 프로덕션 데이터 변경 | 발견 → 구현 → 검증 | 발견/검증 3; 구현 1 |
단계 및 검사
- 허용 기준 - 부모: 디스패치 전에 '완료의 의미'를 정의합니다. A/B는 요청에서 검사 및 예상 결과를 도출합니다. C/D는 발견 후 초안을 구체화합니다. 구현 및 검증은 동일한 기준과 원래 요청을 받습니다.
- 발견 - C/D: 범위를 확인하거나 문제를 재현합니다. 제품 편집 없음. 명시적으로 소유한 재현/테스트 파일은 허용됩니다. 위치, 증거, 제안된 기준, 및 미해결 질문과 함께 원인/범위를 보고합니다. 읽기 전용 발견의 경우 브리핑에서 리포지토리 편집을 금지하고 범위를 확인합니다. 작업자별 샌드박스 설정을 발명하지 마십시오.
- 구현: 소유한 파일만 변경합니다. 편집 내용, 명령어, 종료 상태, 및 완료되지 않은 작업을 보고합니다.
- 검증 - B/C/D: 구현하지 않은 새로운 에이전트가 요청, 사양 및 기준에 대해 통합된 패치를 확인합니다. 리포지토리 편집이나 새로운 회귀 테스트는 없습니다. 구현을 위해 누락된 테스트를 제안합니다. 스크래치 보고서 및 일반 테스트 아티팩트는 허용됩니다. 기준당 증거 및 테스트되지 않은 영역을 보고합니다.
명령어 실행 전에 사전 테스트 전제 조건을 확인합니다. 적용 범위가 동일한 경우에만 실현 가능한 대안을 선호합니다. 단지 PASS를 얻기 위해 필요한 통합, 엔드-투-엔드, 시각적 또는 장치 증거를 단위 테스트로 대체하지 마십시오. 차단된 필수 검사는 최종 결과에 포함하십시오. 특정 테스트 러너가 샌드박스에서 실행될 수 있다고 가정하지 마십시오. 구체적인 해결 조치 후에만 환경적 실패를 재시도하십시오.
발견/구현은 DONE, PARTIAL 또는 BLOCKED를 반환합니다. 검증은 PASS, FAIL, BLOCKED 또는 INCONCLUSIVE를 반환합니다. 호출당 시간 예산: A/B 10분; C/D 25분. 한도에 도달하면 완료된 작업, 증거, 미해결 검사 및 다음 단계와 함께 PARTIAL 또는 INCONCLUSIVE를 반환합니다.
사다리 및 디스패치
| 단계 | 모델 | reasoning_effort |
|---|---|---|
| 1 | gpt-6-luna | medium |
| 2 | gpt-6-luna | medium |
| 3 | gpt-6.1-sol | low |
| 4 | gpt-6.1-sol | medium |
| 5 | gpt-6.1-sol | high |
단계 2는 구체적인 수정 증거와 함께 새로운 Luna 재시도입니다. Sol low는 앱에서 Light이며 추가 단계가 아닙니다.
구체적인 누락 또는 잘못 읽은 브리핑의 경우 한 단계 전진합니다. 단계 2는 더 강력한 모델 이전의 단일 누락 재시도입니다. 단계 1 또는 2에서 확인된 추론 실패의 경우 직접 단계 3으로 점프합니다. 단계 3 이상에서는 한 단계 전진합니다. 아래 '에스컬레이트'는 이 규칙을 의미합니다. 부적절한 작업이 단계 5를 소진하면 중지합니다. 생산적인 연속 및 수정된 환경 실패는 단계를 전진시키지 않습니다. 구체적인 수정 없이 동일한 실패한 접근 방식을 재시도하지 말고 대신 에스컬레이션하십시오. 이것은 생산적인 연속을 금지하지 않습니다.
노출된 Codex 스키마를 사용하십시오: 고유한 task_name, 완전한 브리핑을 message에, 명시적 model, reasoning_effort, 및 지원되는 경우 fork_turns: "none"과 함께 spawn_agent를 사용하십시오. 전체 기록 포크를 재정의에 사용하지 마십시오. 전역 구성을 변경하거나 중첩된 CLI로 우회하는 대신 호환되지 않는 컨트롤을 보고하십시오. 동일한 단계 연속에는 followup_task를 사용하고 모델/노력 변경에는 새 spawn을 사용하십시오. 대기/수신/조종 호출은 무료 추가 할당을 생성하지 않습니다. 지연된 작업자를 중단하고 계속하기 전에 쓰기가 중지되었는지 확인하십시오.
요청 및 관찰 가능한 유효 설정을 기록하십시오. 유효 값이 노출되지 않는 경우 unavailable을 사용하십시오. 사용할 수 없는 모델이나 설정을 조용히 대체하지 마십시오. 기록을 복사하는 대신 브리핑에 증거 경로를 유지하십시오. 재시도 브리핑은 수정/가설의 이름을 지정하고 패치를 계속 또는 이 헝크들을 교체라고 말합니다.
회계 및 트리아지
총 호출 수, 단계별 호출 수, 단계별/작업 항목별 단계를 별도로 추적하십시오. 각각의 새로운 작업 할당, 재시도 또는 연속은 하나의 호출 비용이 듭니다. 상태 메시지 및 대기 비용은 없습니다. 병렬 작업자 및 기준 테스트 작업자는 개별적으로 계산됩니다. 지원되는 경우 디스패치된 각 할당 또는 연속에 대해 런타임 작업 목록 항목을 하나씩 생성합니다. 업데이트 비용은 없습니다. 올바른 검증 FAIL은 성공적인 검증이며, 검증자를 에스컬레이션하는 이유가 아닙니다. 행을 선택하기 전에 실패를 진단하십시오.
| 발견 | 다음 조치 | 계산 |
|---|---|---|
| 부적절한 작업 | 증거와 함께 책임 단계 에스컬레이션 | 호출 + 단계 전진/점프 |
| 올바른 접근 방식과 진행 상황이 있는 PARTIAL | 동일한 단계에서 계속 | 호출 |
| 동일한 단계에서 두 번째 PARTIAL 또는 진행 증거 없음 | 해당 단계 에스컬레이션 | 호출 + 단계 전진/점프 |
| 잘못된 진단 | 발견 에스컬레이션; 이후 구현 브리핑 수정 | 호출 + 단계 전진/점프 (발견) |
| 검증 FAIL이 잘못됨 | 부모가 기록된 증거로 수정하거나 검증 에스컬레이션; 구현 변경 안 함 | 수정의 경우 없음; 재검증의 경우 호출 + 단계 전진/점프 |
| 검증 FAIL이 부적절한 구현을 올바르게 식별 | 구현 에스컬레이션, 이후 현재 단계에서 새 검증 | 호출 + 단계 전진/점프 (구현), 호출 (검증) |
| 검증이 완료된 검사 목록과 함께 시간 초과 | 미해결 검사에 대해 현재 단계에서 계속 | 호출 |
| 환경 실패 또는 누락된 전제 조건 | 권한 내에서 해결 후 한 번 재시도; 해결되지 않으면 중지 | 재시도 호출; 단계 변경 없음 |
| 차단하는 모호성이 '완료' 또는 티어 D 위험을 변경 | 사용자에게 질문; 차단자 이름 지정 | 없음 |
부모 수정은 검사를 면제하지 않습니다. 허용은 모든 기준에 대한 증거를 필요로 합니다. 검증자가 구현하지 않았고 패치가 변경되지 않은 경우에만 동일한 에이전트에서 검증을 계속하십시오. 수리 후 새 검증자를 사용하십시오. 단계 5에서 올바른 FAIL은 검증자를 소진하지 않습니다. 구현을 트리아지하십시오.
예산: A 3회 호출; B 4회; C/D 8회. 디스패치 전에 확인: 남은 호출이 제안된 모든 작업자와 작업에 필요한 경우 최종 검증 하나를 포함할 수 있어야 합니다. 검증 자체는 자체 호출만 필요합니다. 하나 남음 + 최종 검증은 허용됩니다. 둘 남음 + 구현은 허용됩니다. 둘 남음 + 두 구현은 허용되지 않습니다. 필요한 모든 작업이 여전히 맞는 경우에만 배치를 줄이십시오. 발견 후 구현 및 검증을 예약하십시오. 승격 후 재확인하십시오.
마지막으로 허용된 호출은 작업을 성공적으로 완료할 수 있습니다. 그렇지 않으면 감당할 수 없는 작업 전에, 최종 단계 실패 시, 또는 해결되지 않은 차단자에 대해 중지하십시오. 필요한 작업을 조용히 생략하거나 필수 검증이 남아 있는 상태에서 완료를 주장하지 마십시오. 일반적인 구현 선택에는 사용자 질문이 필요하지 않습니다. 기록하십시오.
스냅샷 및 핸드오프
부모만이 아래 포함된 Bash/Git 스냅샷 스크립트를 실행합니다. 동반 파일은 필요하지 않습니다. umask 077로 ${TMPDIR:-/tmp}/escalating-subagents/를 만든 다음 mktemp -d를 사용하여 거기에 고유한 task.XXXXXX 디렉토리를 만듭니다. 다음 명령으로 표시된 블록을 추출하고, 다시 입력하지 마십시오 (SKILL은 이 문서의 절대 경로, TASK는 작업 디렉토리입니다):
sed -n '/^<!-- agent-snapshot:start -->$/,/^<!-- agent-snapshot:end -->$/p' SKILL | sed '1,/^```bash$/d;/^```$/,$d' > TASK/agent-snapshot.sh
SHA-256(shasum -a 256 또는 sha256sum)은 ddc6cd474ae00cb7fc7613deefb4a9f5ff959f6b641abf041f1a7e26d7d8ca95여야 합니다. 불일치는 차단자입니다. 스냅샷에는 <task>/state를 별도로 사용하십시오. 스크립트를 처음에 빈 상태 디렉토리 안에 두지 마십시오. Bash로 실행하고, source하지 마십시오.
절대 리포지토리, 헬퍼 및 상태 경로를 부모 원장에 기록하십시오. 모든 호출에서 명시적으로 전달하고, 명령어 간에 셸 상태에 의존하지 마십시오. 작업자는 헬퍼를 실행하거나 제어 경로를 수신하지 않습니다. 디스패치 전에 성공적으로 초기화하십시오. 초기화 오류를 보고하고 중지하며, 권한으로 인한 경우에만 샌드박스 차단자를 식별하십시오. 대문자 단어는 자리 표시자입니다. 실제 경로를 인용하십시오:
bash HELPER init REPO STATE
bash HELPER capture STATE base
bash HELPER capture STATE pre-1
bash HELPER capture STATE post-1
bash HELPER diff STATE pre-1 post-1 names0
bash HELPER diff STATE pre-1 post-1 stat
bash HELPER diff STATE base post-1 patch
base를 한 번, 각 디스패치/배치 직전에 pre-N을, 모든 작업자 및 쓰기가 완료된 후 post-N을 캡처하십시오. 통합 패치 출력을 스크래치 증거에 저장하십시오. 명명된 스냅샷은 변경할 수 없습니다. 상태는 트리 ID와 임시 인덱스/객체를 유지합니다. 실제 인덱스/객체 데이터베이스는 변경되지 않습니다. 추적된 무시된 파일 및 무시되지 않은 추적되지 않은 파일이 포함됩니다. git diff HEAD를 대체품으로 사용하지 마십시오.
헬퍼 실패는 차단자입니다. 동시 쓰기를 거부합니다. 기록된 프로세스가 중지된 것으로 확인되지 않는 한 잠금을 삭제하지 마십시오. 중단된 게시되지 않은 캡처는 명명된 스냅샷을 대체할 수 없습니다. 보고 및 의도된 후속 작업이 완료될 때까지 상태를 유지하십시오.
범위 검사에는 NUL로 구분된 변경된 경로를, 요약에는 stat을, 검증에는 통합 패치를 사용하십시오. 범위를 벗어난 편집은 부모가 합법적인 종속성에 대해 명시적으로 소유권을 확장하지 않는 한 거부됩니다. 관련 없는 작업을 보존하십시오. 자동으로 재설정, 정리, 스태시 또는 되돌리지 마십시오.
사용 가능한 용량 내에서 분리된 구현 작업자를 함께 디스패치하십시오. 각 배치에 대해 소유권의 합집합과 비교하십시오. 보고서는 개별 귀속을 제공하지만, 저자 증명은 아닙니다. 범위 확인 또는 검증 전에 전체 배치를 기다리십시오. 공유 파일/인프라 및 스냅샷을 오염시킬 관련 없는 동시 작성자를 직렬화하십시오.
핸드오프 시 명령 결과, 증거 경로, 인용된 위치 및 파일 상태 관련성을 확인하십시오. 새로운 편집은 영향을 받는 검사를 무효화합니다. 허용된 작업은 진행됩니다. 거부된 작업은 트리아지로 돌아갑니다. 장기 실행 명령어를 완료까지 추적하고 스냅샷 전에 미해결 쓰기를 중지하십시오. 백그라운드 시작은 완료가 아닙니다.
리포지토리 제약 조건 및 브리핑
해당 AGENTS.md, 범위 지침, 사양 및 설계 지침을 읽으십시오. 리포지토리의 패키지 관리자, 잠금, 종속성 버전, 마이그레이션 및 문서 정책을 사용하십시오. 프로덕션 데이터 제약 조건을 관련 작업자 브리핑에 명시적으로 포함시키고, 해당되는 경우 라이브 데이터 및 추가 전용 요구 사항을 포함하십시오. 작업자가 간접적으로 발견하는 것에 의존하지 마십시오.
작업자는 커밋, 푸시, 배포 또는 관련 없는 외부 쓰기를 절대 수행하지 않습니다. 부모는 리포지토리 및 호스트 규칙이 허용하는 경우에만 명시적으로 요청된 작업을 수행할 수 있습니다.
모든 브리핑에는 다음이 포함됩니다: 작업, 티어, 원래 요청, 절대 리포지토리/지침/증거 경로, 모델/노력, 기준을 그대로, 소유권, 명령 시간 제한, 벽시계 예산, 프로덕션 데이터 제약 조건, 및 "위임하지 말고, 이 스킬을 호출하지 말며, 스냅샷 헬퍼를 실행하지 마십시오."
- 발견: 관련 경로, 재시도하는 경우 이전 보고서; 명시적으로 승인된 재현/테스트 파일 외에는 아무것도 소유하지 않습니다. 제품 편집 또는 설치 금지. 결과, 원인/범위, 위치, 증거, 제안된 기준, 미해결 사항, 다음 단계를 보고합니다.
- 구현: 예상 결과, 소유권과 함께 변경 허용 범위: 명시된 파일 및 표준 리포지토리 위치가 명시적이지 않은 경우 해당 파일; 테스트 종속성. '완료'는 '기준당 통과'를 의미합니다.
- 검증: 절대 기준; '기준당 통과'가 '완료'를 의미함. 구현자 기록 제외. 증거당 관찰 내용, 전체 통합 패치(스크래치 디렉토리), 각 기준의 상태. 구현을 위한 제안된 누락 테스트.
문서 규칙
가독성을 위해 표 헤더를 정렬하십시오. 순서가 지정되지 않은 목록은 들여쓰기 및 마크다운 규칙을 따릅니다. 코드 블록 내부가 아닌 경우에만 사용자 입력을 현지화하십시오.