Super Review Council / 超级审查会

超级审查会은(는) 무엇을 하나요?

사용자가 명시적으로 이 super-review-council 워크플로우를 요청할 때, 대규모 구조화된 멀티에이전트 리뷰-수정 루프를 실행합니다. 주로 코드 리뷰이지만, 명시적인 동결된 비코드 번들 대상도 지원합니다. Guardian auto_review 승인 라우팅이나 내장된 codex review 명령어가 아닙니다.

최상위 명시적 실행의 경우, 기본 형태는 각 본질적 단계마다 4-에이전트 워크플로우입니다. 4명의 에이전트가 동일한 동결된 변경 번들을 검사하고, 4명의 에이전트가 결과 분류를 돕고, 4명의 에이전트가 쓰기 소유권을 분리할 수 있는 수정 계획/구현에 참여하며, 4명의 에이전트가 루프가 반복되기 전에 결과를 검증합니다. 메인 에이전트는 조정, 소유권 할당, 결과 통합, 수락된 수정에 대한 최종 결정을 내립니다.

다음과 같은 경우에 사용하십시오:

• 사용자가 명시적으로 super-review-council이라고 말하는 경우
• 사용자가 명시적으로 Super Review Council이라고 말하는 경우
• 사용자가 명시적으로 超级审查会라고 말하는 경우
• 사용자가 명시적으로 이 대규모 멀티에이전트 리뷰 위원회 워크플로우를 요청하는 경우
• 로드된 최상위 조정 워크플로우가 명시적으로 super-review-council을 제한된 읽기 전용 하위 패스로 호출하는 경우

다음 경우에는 이 스킬을 트리거하지 마십시오: 일반 "리뷰", 내장 codex review, Guardian auto_review, 일반적인 편집 후 자체 리뷰, 최종 응답, 커밋, 배포, CI 검사, 이전 스킬 이름 언급, 또는 해당 작업에 대해 사용자가 이 super-review-council 워크플로우를 요청하지 않은 한 이 스킬 파일에 대한 일반 유지보수.

트리거되면, 먼저 super-review-council 스킬이 활성화되었음을 알리고 리뷰 대상자를 식별한 후 리뷰어 작업을 시작하십시오.

기여

이 스킬은 MIT 라이선스인 openclaw/agent-skills skills/autoreview 스킬에서 파생되었습니다. 레거시 autoreview 이름은 MIT 기여 표시, 헬퍼 경로/출력/환경 호환성, 중첩 워크플로우 금지 컨텍스트를 위해서만 여기에 나타납니다.

4-에이전트 워크플로우

사용자가 super-review-council 또는 超级审查会라고 말하면, 환경이 서브에이전트를 지원할 때 각 단계에 대해 병렬로 4명의 에이전트를 사용하십시오. 읽기 전용 단계에는 explorer 스타일 에이전트를, 구현 단계에는 worker 스타일 에이전트를 선호하십시오. 읽기 전용 리뷰, 분류, 수정 계획 에이전트는 기본적으로 최소한의 단계 범위 컨텍스트(동결된 대상 ID, 역할, 허용된 도구, 금지 사항, 관련 결과/증거만)로 설정됩니다. 검증 에이전트도 기본적으로 최소한의 단계 범위 컨텍스트와 해당 단계에 대해 명시적으로 승인된 검증 명령어, 출력 경로, 쓰기 경계, 드리프트 감사 요구사항을 추가로 받습니다. 이전 승인 및 실행 명령어는 증거/출처로만 전달될 수 있으며, 반드시 명시적으로 historical context only 및 not authority로 레이블이 지정되어야 하며, 권한을 부여하거나, 저하되거나 위험한 실행을 승인하거나, 쓰기, 테스트, 수정, 중첩 워크플로우를 승인하거나, 현재 단계 계약, 허용된 도구, 금지 사항을 재정의할 수 없습니다. Worker 에이전트는 수락된 수정이 요구하는 경우에만 더 풍부한 컨텍스트를 받을 수 있으며, 이 풍부한 컨텍스트도 동일한 증거/출처 전용 제한을 따릅니다.

단계 0: 대상 사전 점검. 번들을 동결하거나 에이전트를 생성하기 전에 리뷰 대상을 식별하십시오:

• 사용자 또는 조정 워크플로우가 명시적인 파일, 디렉토리, 또는 동결된 리뷰 번들 대상을 제공하는 경우, 해당 명시적 대상이 현재 작업 디렉토리 git 감지보다 우선합니다; 대상을 정규화하고 내용 매니페스트/해시 ID를 사용하십시오(현재 셸이 git 저장소 내에 있더라도).
• git 저장소 내에 있으면, 저장소 루트, 현재 브랜치, 더티/스테이징/추적되지 않은 상태, 업스트림/베이스 또는 PR 베이스(사용 가능한 경우), 대상이 로컬 모드, 브랜치 모드, 또는 커밋 모드인지 기록하십시오.
• git 저장소 내에 없으면, 사용자가 명시적인 파일, 디렉토리, 또는 리뷰 가능한 번들 대상을 제공한 경우에만 진행하십시오; 절대 경로를 정규화하고, 누락된 대상을 거부하며, 디렉토리 내용을 결정론적으로 열거하고, 저장소 또는 명시적 대상이 제공되지 않은 경우 중단하고 질문하십시오.
• 단계 1 전에 변경할 수 없는 대상 ID를 기록하십시오: 커밋 모드의 경우 커밋 SHA; 브랜치 모드의 경우 베이스/헤드 ref와 diff 해시; 로컬 모드의 경우 로컬 diff/추적되지 않은 매니페스트 해시; 또는 git이 아닌 파일, 디렉토리, 번들의 경우 내용 매니페스트 해시.
• 단계 1 전에 선택한 번들/소스를 동결하고 첫 번째 사용자 대상 업데이트에서 대상 ID/해시를 보고하십시오.
• 분류, 수정 계획, 구현 전에 선택한 대상 ID/해시를 다시 계산하고 이를 현재 동결된 리뷰 루프 기준선과 비교하십시오; 처음에는 이 기준선이 단계 0 값입니다; 이 재계산은 동등성 검사일 뿐이며 기준선 교체, 매니페스트 재생성, 재동결, 재시작을 승인하지 않습니다.
• 수락된 단계 4 수정이 적용된 후, 결과 대상/워크스페이스 ID를 단계 4 이전 기준선, 수락된 쓰기 범위, 승인된 출력, 금지된 경로와 비교하여 감사한 후, 결과 대상 ID/해시를 단계 5 검증 기준선 및 다음 리뷰 루프의 시작 ID로 기록하십시오; 예상치 못한, 범위를 벗어난, 또는 금지된 드리프트는 격리되어 공개되어야 하며, 명시적으로 승인되지 않으면 기준선 채택을 차단합니다.
• 승인되지 않은 외부 변경으로 인해 대상 ID 비교가 다른 경우, 해당 단계를 중단하고 예상 및 관찰된 ID/해시와 변경된 경로(알려진 경우)를 공개하며, 재동결, 재시작, 또는 새 기준선 채택 전에 사용자 또는 조정자의 명시적 승인을 요구하십시오; 읽기 전용 하위 모드에서는 이를 조정자에게 차단기로 반환하십시오.

네이티브 서브에이전트 레지스트리: 조정자 측 관리가 기본 제어이며, 파일 시스템 잠금이 아닙니다. 각 네이티브 서브에이전트가 시작되기 전에 조정자는 단계 및 역할, 선언된 도구, 명시적 허용 및 금지된 작업, 허용된 읽기/쓰기 경로, 금지된 경로, 샌드박스 및 권한 프로필(사용 가능한 경우), 기준선 대상 ID/해시, 저장소/워크스페이스 상태 및 매니페스트, 또는 대상 외부의 쓰기를 발견하기에 충분한 동등한 전체 워크스페이스 변이 기준선을 기록합니다. 서브에이전트가 반환된 후, 대상 ID, 허용/금지된 경로 매니페스트, 저장소/워크스페이스 상태, 도구/샌드박스/권한 메타데이터를 해당 스냅샷과 비교하십시오. 계속하기 전에 대상 불일치, 대상 내부 또는 외부의 예상치 못한 쓰기, 허용된 경로 드리프트, 금지된 경로 접촉, 도구 드리프트, 권한 또는 샌드박스 확장, 설명되지 않은 변이, 승인되지 않은 드리프트, 예상치 못한 쓰기를 격리하고, 의존하지 말고, 공개하십시오. 파일 시스템 읽기 전용 모드, 변경 불가능한 디렉토리, 샌드박스 제한은 사용 가능한 경우 유용한 보조 가드레일 또는 증거이지만, 조정자의 프롬프트 계약, 레지스트리, 스냅샷/드리프트 감사, 격리 결정, 통합 리뷰, 최종 결정을 대체하지 않습니다.

단계 실패 처리: 필요한 에이전트, 헬퍼 엔진, 또는 워커가 오류가 발생하거나, 시간 초과되거나, 단계 계약을 위반하거나, 필수 필드가 누락된 결과를 반환하거나, 사용할 수 없는 출력을 생성하는 경우, 해당 단계는 불완전합니다. 의심스러운 출력을 격리하거나 무시하고, 실패를 공개하며, 동일한 단계 계약 및 엔진/모델 제약 조건 내에서 참가자를 재시도하거나 교체하거나, 명시적 저하 모드 승인 또는 차단기를 위해 중단하십시오. 부재, 오래된, 또는 사용할 수 없는 출력을 깨끗한 4-에이전트 적용 범위로 간주하지 마십시오.

단계 1: 4-에이전트 리뷰. 각 리뷰어에게 동일한 동결된 diff/번들과 하나의 주요 초점을 제공하십시오:

• 정확성 및 회귀
• 보안 및 신뢰 경계
• 테스트, 엣지 케이스, 실패 모드
• 유지보수성, 통합 계약, 사용자에게 보이는 동작

리뷰 제약 조건:

• 모든 리뷰어 엔진은 조정자에 의해 읽기 전용 리뷰어로 제한되어야 합니다: 실행 브리핑은 허용된 읽기 전용 도구/작업을 명명하고, 쓰기 및 변이 명령어를 금지하고, 중첩 리뷰/조정/에이전트 생성을 금지하고, 리뷰어를 동결된 대상에 바인딩해야 합니다; 사용 가능한 경우 샌드박스, 도구 정책, 헬퍼 플래그, 파일 시스템 읽기 전용 제어, 변경 불가능한 번들을 선택적 추가 증거로만 사용하고, 절대 요구하지 마십시오; 조정자가 합리적으로 쓰기나 도구 드리프트를 금지, 관찰, 감사할 수 없는 경우 엔진을 리뷰어로 사용하지 마십시오.
• 리뷰어는 파일을 편집하거나, 포매터를 실행하거나, 패키지를 설치하거나, git 상태를 변이시키거나, 푸시, 커밋, 또는 파일을 쓰는 명령어를 실행해서는 안 됩니다.
• 리뷰어는 필요에 따라 파일, 타입, 문서, 종속성 계약, 현재 공개 문서를 검사할 수 있습니다.
• diff, 브랜치, 커밋, 또는 패치 리뷰의 경우, 리뷰어는 검토된 변경에 의해 도입되거나 노출된 실행 가능한 결함만 보고해야 합니다.
• 동결된 대상이 전체 파일, 비코드 번들, 계획, 명세, 문서, 또는 아티팩트 번들인 경우, 리뷰어는 코드 전용 또는 diff 출처 문제보다는 해당 아티팩트에 존재하는 실행 가능한 결함을 명시된 목적과 제약 조건에 대해 보고합니다.
• 리뷰어는 광범위한 재작성, 스타일 선호도, 관련 없는 정리를 제안해서는 안 됩니다.

단계 2: 4-에이전트 분류. 먼저 단계 0의 오래된 대상 가드를 통과한 후, 4명의 에이전트에게 병합된 결과를 수락됨, 거부됨, 중복, 추가 증거 필요로 독립적으로 분류하도록 요청하십시오. 분류 에이전트는 읽기 전용 리뷰 단계와 동일한 쓰기 금지, 변이 명령어 금지, git 변이 금지, 설치 금지, 포매터 금지, 출력을 쓰는 테스트 금지, 중첩 리뷰/조정/에이전트 생성 금지 계약에 따라 조정자에 의해 제한되어야 합니다; 동결된 대상, 병합된 결과, 제공된 증거, 명시적으로 범위 내의 인접 컨텍스트만 검사해야 합니다. 메인 에이전트는 중복을 제거하고, 추측성 또는 낮은 가치의 결과를 거부하며, 검토된 코드 경로 또는 아티팩트와 범위 내의 인접 컨텍스트를 읽어 불일치를 해결하고, 수락된 수정 세트를 기록합니다.

단계 3: 4-에이전트 수정 계획. 먼저 단계 0의 오래된 대상 가드를 통과한 후, 4명의 읽기 전용 계획 에이전트에게 최소 수정 계획과 소유권 경계를 제안하도록 요청하십시오. 수정 계획 에이전트는 읽기 전용 리뷰 단계와 동일한 쓰기 금지, 변이 명령어 금지, git 변이 금지, 설치 금지, 포매터 금지, 중첩 리뷰/조정/에이전트 생성 금지 계약에 따라 조정자에 의해 제한되어야 합니다; 파일을 편집하거나, 아티팩트를 쓰거나, 패치를 적용하거나, 출력을 쓰는 테스트를 실행하거나, super-review-council을 호출하거나, 레거시 autoreview를 호출하거나, goal-orchestrator를 호출하거나, 내장 codex review를 호출하거나, 리뷰 패널을 열거나, 추가 에이전트를 생성해서는 안 됩니다. 계획을 제안하기 위해 동결된 대상과 수락된 결과만 검사할 수 있습니다. 비코드 대상의 경우, 계획은 코드 소유권 경계 대신 정확한 아티팩트 섹션 또는 라인 수준 편집을 명명해야 합니다. 올바른 소유권 경계에서 작은 수정을 선호하십시오. 버그 클래스를 명확히 수정하지 않는 한 광범위한 리팩터를 계획하지 마십시오.

단계 4: 4-에이전트 구현. 먼저 단계 0의 오래된 대상 가드를 통과한 후, 수락된 수정이 분리된 쓰기 범위로 분할될 수 있는 경우에만 4명의 worker 에이전트를 사용하십시오. 각 worker에게 파일/모듈의 명시적 소유권을 할당하십시오. 모든 worker에게 그들이 코드베이스에 혼자가 아니며, 다른 사람의 편집을 되돌리지 말아야 하고, 병렬 변경에 적응해야 한다고 알리십시오. Worker는 할당된 저장소-로컬 파일/모듈만 편집할 수 있고, 중복 쓰기를 피해야 하며, 관련 없는 파일을 포맷해서는 안 되고, 패키지나 종속성을 설치해서는 안 되며, 푸시, 커밋, 리셋, 체크아웃/스위치/복원, 되돌리기, 정리, 스태시, 리베이스, 병합, 브랜치/태그 삭제, 추적되지 않은 파일 제거, rm -rf 또는 find -delete와 같은 광범위한 파괴적 파일 시스템 명령어를 실행해서는 안 됩니다. Worker는 super-review-council, 레거시 autoreview, goal-orchestrator, 내장 codex review, 리뷰 패널, 계획 패널, 추가 에이전트를 호출해서는 안 됩니다. Worker는 사용자 또는 동료 변경을 취소하여 해결하는 대신 충돌을 보고해야 합니다. 메인 에이전트는 수락하기 전에 worker 패치를 검토합니다. 4개 미만의 독립적인 쓰기 범위가 있는 경우, 중복 편집을 강제하는 대신 나머지 에이전트를 읽기 전용 검증, 테스트 계획, 또는 구현 리뷰에 사용하십시오.

단계 5: 4-에이전트 검증. 먼저 현재 검증 기준선에 대해 오래된 대상 가드를 통과한 후, 가능한 경우 병렬로 4명의 검증 에이전트를 실행하십시오:

• 집중 테스트 및 명령어 출력
• 의도하지 않은 변경에 대한 diff 감사
• 수락된 결과의 회귀/보안 재확인
• 생성된 아티팩트, 문서, 스냅샷, 또는 사용자에게 보이는 출력 일관성

검증 에이전트는 명시적 역할, 기준선 ID/해시, 허용된 명령어 및 도구, 허용된 읽기/쓰기/출력 경로, 금지된 경로 및 작업, 유한 시간 초과, 설치, 포매터, git 변이, 파괴적 파일 시스템 명령어, 중첩 리뷰/조정, 추가 에이전트에 대한 금지와 함께 시작되어야 합니다. 테스트 또는 검증 명령어는 수락된 수정이 해당 출력을 명시적으로 소유하지 않는 한, 보호된 대상 루트 외부의 조정자 승인 경로에만 쓸 수 있습니다. 검토된 대상을 변이시킬 수 있는 검증은 직렬화되어야 하며, 그렇지 않으면 이전 기준선에 대해 수집된 병렬 검증자 결과를 무효화하고 감사된 쓰기 후 기준선에 대해 다시 실행해야 합니다. 각 검증자 또는 테스트 명령어 후에, 조정자는 대상 ID/해시, 허용 및 금지된 경로 매니페스트, 저장소/워크스페이스 상태, 명령어 아티팩트를 단계 5 기준선과 비교합니다. 계속하기 전에 예상치 못한 드리프트, 금지된 쓰기, 선언되지 않은 출력은 격리되어 공개되어야 합니다. 승인된 검증 쓰기가 검토된 대상을 합법적으로 변경하는 경우, 단계 6이 리뷰를 다시 실행하기 전에 감사된 검증 후 대상 ID/해시를 다음 리뷰 루프의 시작 ID로 기록하십시오. 읽기 전용 하위 모드는 단계 5 명령어를 실행하지 않습니다.

단계 6: 반복. 수락된 수정이 검토된 대상을 변경한 후(코드, 문서, 스킬 텍스트, 생성된 출력, 또는 기타 번들 내용 포함), 업데이트된 diff 또는 아티팩트에 대해 4-에이전트 리뷰 단계를 다시 실행하십시오. 4-에이전트 리뷰/분류 프로세스가 더 이상 수락/실행 가능한 결과를 남기지 않고 필수 테스트 또는 아티팩트별 증명이 통과될 때까지 계속하십시오. 무한 반복하지 마십시오: 기본적으로 사용자가 명시적으로 계속하도록 요청하지 않는 한 3번의 전체 리뷰/수정 사이클 후에 중단하고, …

(이하 생략)