mrcha033/skills

Advisor Review

이 스킬 디렉토리의 번들 스크립트를 사용하십시오. 명시적 호출은 래치(latch) 역할을 합니다: 실질적인 최종 답변 또는 리뷰와 일치하거나 충돌하는 조치가 있기 전에, 동일한 상위 태스크 내에서 리뷰어를 실행하십시오. 읽기 전용 증거 수집은 패킷을 구성하는 동안 계속될 수 있습니다.

어드바이저를 위해 전역 도구 카탈로그를 검색하지 마십시오. 두 번째 사용자에게 보이는 태스크를 열지 마십시오. 유일한 하위 실행은 scripts/run_advisor.py에 의해 시작되는 격리된 codex exec 프로세스입니다.

요구 사항

쉘 실행, 인증된 로컬 codex CLI, 요청된 gpt-5.6-sol 모델 라우트에 대한 접근 권한, 상위 쉘에서의 아웃바운드 Codex API 접근이 필요합니다. 하위 프로세스 네트워킹을 차단하는 상위 샌드박스는 중첩된 리뷰어도 차단합니다. 요구 사항이 하나라도 누락되면 독립적 리뷰가 차단되었음을 보고하십시오. 사용자 또는 태스크 권한 없이 샌드박스를 약화시키지 마십시오.

실행기는 기밀 경계가 아닙니다. 패킷을 구축하기 전에 증거와 아티팩트를 정리(sanitize)하십시오.

워크플로우

1. Advisor Review가 사용 중임과 그 이유를 알립니다.

2. 한 가지 단계를 선택합니다:

   • plan: 제안된 접근 방식에 이의를 제기합니다.
   • stuck: 실패했거나 루프에 빠진 작업을 진단합니다.
   • pivot: 실질적으로 다른 접근 방식을 비교합니다.
   • final: 완료된 작업과 그 최종 증거를 감사합니다.

3. references/context-contract.md를 읽습니다.

4. 컨텍스트 모드를 선택합니다:

   • packet: 짧은 출처 기반 사실로 충분합니다.
   • bundle: 정리된 로그, 타임라인, diff 또는 기타 제한된 텍스트 아티팩트가 진단에 실질적으로 영향을 미칩니다.

5. scripts/build_context_packet.py로 advisor-context-2.0을 구축합니다.

   • stuck의 경우, 작업과 정확한 결과를 시간 순서대로 포함합니다.
   • 모든 관찰된 사실에 구체적인 출처를 제공합니다.
   • 부정적 결과, 충돌하는 상태, 컨텍스트 제한 사항을 포함합니다.
   • 결정에 중요한 텍스트를 조용히 잘라내지 마십시오. 빌더 실패는 차단된 리뷰입니다.

6. references/review-rubric.md를 읽습니다.

7. 노력을 선택합니다:

   1. high, xhigh 또는 max에 대한 명시적 요청을 존중합니다.
   2. max는 명시적으로 요청된 가장 깊은 리뷰 또는 해결되지 않은 주요 모호성이 있는 중요하고 되돌리기 어려운 결정에만 사용합니다.
   3. xhigh는 교차 구성 요소 실패, 상충하는 검증된 증거, 두 번 이상의 실패한 접근 방식, 주요 전환 또는 영향력이 큰 완료 주장에 사용합니다.
   4. 그 외에는 high를 사용합니다.

8. 기본적으로 정확히 하나의 격리된 리뷰를 실행하고 그 영수증을 저장합니다:

   python3 scripts/run_advisor.py \
     --input context-packet.json \
     --effort xhigh \
     --output advisor-receipt.json
   

   반환된 영수증을 호출 태스크 내에 보관하십시오. 다른 사용자에게 보이는 태스크에서 생성된 영수증은 인계(handoff)가 아닙니다.

9. 영수증을 확인합니다:

   • request.requested_model은 gpt-5.6-sol이어야 합니다.
   • request.requested_effort는 선택한 노력과 일치해야 합니다.
   • observed_model 및 observed_effort는 null일 수 있습니다. 현재 CLI는 제공 측 정체를 공식적으로 노출하지 않습니다. 요청된 정체를 확인된 실제 정체로 설명하지 마십시오.
   • 실행기 오류, 스키마 실패, 시간 초과 또는 컨텍스트 해시 불일치가 있으면 리뷰가 차단됩니다.
   • 격리된 하위 프로세스는 호스트 인증 파일이 있을 때만 연결하는 임시 CODEX_HOME을 사용합니다. 또한 플러그인, 원격 플러그인 로딩, 스킬 검색 및 다중 에이전트 실행을 비활성화하여 관련 없는 스킬 카탈로그가 리뷰 컨텍스트를 소비하지 못하게 합니다.

10. references/decision-contract.md를 읽습니다. 모든 R# 권장 사항을 adopt, reject 또는 defer로 해결한 후 다음을 실행합니다:

    python3 scripts/validate_decision.py \
      --receipt advisor-receipt.json \
      --decision advisor-decision.json
    

11. 결정 레코드가 검증될 때까지 어드바이저 권장 사항에 따라 행동하지 마십시오. 파괴적인 권장 사항은 추가로 확인된 사용자 권한이 필요합니다.

12. 검증된 다음 조치와 중지 조건을 사용하여 상위 태스크를 계속합니다.

막힌 작업 규칙

• 상태를 더 변경하기 전에 진단하십시오.
• 실행 경계를 구분하십시오: 상위 태스크, 격리된 리뷰어 프로세스 및 기타 사용자에게 보이는 태스크는 별개입니다.
• 별도 태스크의 영수증을 동일 태스크 인계를 대신하도록 두지 마십시오.
• 경쟁 가설을 분리하는 하나의 읽기 전용 또는 되돌릴 수 있는 실험을 선호하십시오.
• 반복된 사용자 수정 후에는 새로운 증거 없이 동일한 처방을 반복하지 마십시오.
• 증거가 연결되지 않는 한, 하나의 실패한 하위 시스템에서 플러그인, 서비스, 리포지토리 또는 패키지로 범위를 넓히지 마십시오.

리뷰 예산

기본적으로 한 번의 리뷰를 사용하십시오. 두 번째 리뷰는 새로운 증거가 결정을 실질적으로 변경하거나 고위험 최종 재확인이 정당화되는 경우에만 허용됩니다. 세 번째 리뷰는 구체적인 충돌을 조정하기 위해서만 허용됩니다. 무제한 리뷰 루프를 만들지 마십시오.

스킬 변경 동작 게이트

Advisor Review 자체를 수정할 때는 결정론적 테스트와 최소한 하나의 정리된 동작 픽스처를 실행하십시오:

python3 scripts/evaluate_advisor_behavior.py \
  --fixture behavior-fixture.json \
  --receipt advisor-receipt.json

실용적인 경우 이전/새로운 픽스처를 쌍으로 사용하십시오. 산문 유사성이 아닌 탐지, 증거 연결, 제한된 실험 및 위험한 행동 비율을 판단하십시오.

보고

다음을 보고하십시오:

• 단계, 컨텍스트 모드, 요청된 Sol 모델, 요청된 노력 및 신원 확인 상태;
• 어드바이저 평결 및 증거 연결 진단;
• 각 결과적 권장 사항의 채택/거부/연기 처리;
• 선택된 다음 조치 및 중지 조건;
• 해결되지 않은 위험 또는 컨텍스트 제한 사항.

결과를 어드바이저 스타일 독립적 리뷰라고 부르고, Claude Advisor와의 동일시는 피하십시오.