Advisor Review
使用此技能目錄中的捆綁腳本。明確調用是一個鎖存器:在給出實質性的最終答案或執行與審查結果相符或衝突的操作之前,請先在相同的父任務中執行審查器。在建構封包期間,仍可繼續進行僅限讀取的證據收集。
請勿在全域工具目錄中搜尋顧問。請勿開啟第二個使用者可見的任務。唯一的子行程執行是 scripts/run_advisor.py 啟動的獨立 codex exec 程序。
需求
需要終端機執行、已驗證的本機 codex CLI、對所要求之 gpt-5.6-sol 模型路由的存取權,以及從父 shell 出發的對外 Codex API 存取權。若父沙箱封鎖了子程序網路連線,則巢狀審查器也會被封鎖。如果缺少任何一項需求,請回報獨立審查受阻;未經使用者或任務授權,不得削弱沙箱。
執行器並非保密邊界。在建立封包之前,請先清理證據與成品。
工作流程
-
宣布正在使用 Advisor Review 及其原因。
-
選擇一個階段:
plan:對提出的方法提出質疑。stuck:診斷失敗或陷入迴圈的工作。pivot:比較本質上不同的方法。final:審計完成的工作及其端點證據。
-
閱讀
references/context-contract.md。 -
選擇上下文模式:
packet:簡短的來源錨定事實即足夠。bundle:經過清理的日誌、時間線、差異或其他有界文字成品會對診斷產生實質影響。
-
使用
scripts/build_context_packet.py建立advisor-context-2.0。- 對於
stuck階段,請按時間順序包含動作與確切結果。 - 為每個觀察到的事實提供具體來源。
- 包含負面結果、衝突狀態與上下文限制。
- 切勿靜默截斷對決策至關重要的文字。建置失敗即表示審查受阻。
- 對於
-
閱讀
references/review-rubric.md。 -
選擇投入程度:
- 遵循對
high、xhigh或max的明確要求。 - 僅在明確要求進行最深入審查,或做出具有重大未解決模糊性的關鍵且難以逆轉的決策時,才使用
max。 - 當出現跨元件故障、衝突的已驗證證據、兩種或以上的失敗方法、重大轉向或高影響力的完成宣告時,使用
xhigh。 - 否則使用
high。
- 遵循對
-
預設執行剛好一次隔離審查並儲存其收據:
python3 scripts/run_advisor.py \ --input context-packet.json \ --effort xhigh \ --output advisor-receipt.json將回傳的收據保留在調用任務中。在其他使用者可見任務中產生的收據不視為交接。
-
檢查收據:
request.requested_model必須是gpt-5.6-sol。request.requested_effort必須與所選投入程度相符。observed_model和observed_effort可能為null;目前的 CLI 無法權威性地揭露服務端身份。切勿將所要求的身分描述為已驗證的實際身分。- 任何執行器錯誤、架構失敗、逾時或上下文雜湊不匹配都會阻斷審查。
- 隔離的子程序會使用一個臨時的
CODEX_HOME,其中僅鏈結主機驗證檔案(若存在)。它還會停用外掛程式、遠端外掛程式載入、技能搜尋以及多代理執行,以防止不相關的技能目錄消耗審查上下文。
-
閱讀
references/decision-contract.md。將每個R#建議解析為adopt、reject或defer,然後執行:python3 scripts/validate_decision.py \ --receipt advisor-receipt.json \ --decision advisor-decision.json -
在決策記錄驗證之前,請勿執行顧問建議。破壞性建議另外需要經確認的使用者授權。
-
使用驗證後的下一個動作與停止條件,繼續執行父任務。
卡住工作規則
- 在變更更多狀態之前,先進行診斷。
- 區分執行邊界:父任務、隔離的審查程序以及任何其他使用者可見任務都是分開的。
- 不要讓單獨任務的收據取代同任務的交接。
- 偏好一個能夠區分競爭假設的唯讀或可逆實驗。
- 在使用者重複修正之後,若沒有新證據,請勿重複相同的處方。
- 除非有證據連結,否則不要將範圍從單一故障子系統擴大到外掛程式、服務、儲存庫或套件。
審查預算
預設使用一次審查。僅在新證據實質性地改變決策,或有充分理由進行高風險的最終複查時,才允許進行第二次審查。僅為了解決具體衝突,才允許進行第三次審查。切勿建立無止盡的審查迴圈。
技能變更行為閘
修改 Advisor Review 本身時,請執行確定性測試以及至少一個經過清理的行為測試案例:
python3 scripts/evaluate_advisor_behavior.py \
--fixture behavior-fixture.json \
--receipt advisor-receipt.json
如可行,請使用成對的新舊測試案例。判斷的重點在於檢測能力、證據連結、有界實驗以及高風險動作比率,而非文字相似度。
報告
報告項目:
- 階段、上下文模式、請求的 Sol 模型、請求的投入程度以及身份驗證狀態;
- 顧問裁決與證據連結的診斷結果;
- 每個重要建議的採用/拒絕/延緩處置;
- 所選的下一個動作與停止條件;
- 未解決的風險或上下文限制。
將結果稱為顧問風格的獨立審查,而非 Claude Advisor 對等物。