Community研究與資料分析github.com

mrcha033/skills

MrCha 技能組 — 適用於 ChatGPT、Codex 及相容代理的可攜式代理技能

skills 是什麼?

此技能提供一個結構化的顧問審查框架,讓代理在執行高風險動作之前,能夠隔離且可重複地進行批判性分析。它支援四個階段:計劃、卡住、轉向與最終審計,每個階段都有清晰的工作流程與上下文打包要求。該系統利用獨立的 `codex exec` 程序,並透過強制執行上下文契約、審查評分量表與決策驗證步驟,確保審查不被污染。此技能需搭配終端機執行、已驗證的本機 `codex` CLI 以及對特定模型路由 `gpt-5.6-sol` 的存取權,適用於需要在使用者可見任務之外進行嚴謹審查的場景。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add mrcha033/skills

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Advisor Review

使用此技能目錄中的捆綁腳本。明確調用是一個鎖存器:在給出實質性的最終答案或執行與審查結果相符或衝突的操作之前,請先在相同的父任務中執行審查器。在建構封包期間,仍可繼續進行僅限讀取的證據收集。

請勿在全域工具目錄中搜尋顧問。請勿開啟第二個使用者可見的任務。唯一的子行程執行是 scripts/run_advisor.py 啟動的獨立 codex exec 程序。

需求

需要終端機執行、已驗證的本機 codex CLI、對所要求之 gpt-5.6-sol 模型路由的存取權,以及從父 shell 出發的對外 Codex API 存取權。若父沙箱封鎖了子程序網路連線,則巢狀審查器也會被封鎖。如果缺少任何一項需求,請回報獨立審查受阻;未經使用者或任務授權,不得削弱沙箱。

執行器並非保密邊界。在建立封包之前,請先清理證據與成品。

工作流程

  1. 宣布正在使用 Advisor Review 及其原因。

  2. 選擇一個階段:

    • plan:對提出的方法提出質疑。
    • stuck:診斷失敗或陷入迴圈的工作。
    • pivot:比較本質上不同的方法。
    • final:審計完成的工作及其端點證據。
  3. 閱讀 references/context-contract.md。

  4. 選擇上下文模式:

    • packet:簡短的來源錨定事實即足夠。
    • bundle:經過清理的日誌、時間線、差異或其他有界文字成品會對診斷產生實質影響。
  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
    

    將回傳的收據保留在調用任務中。在其他使用者可見任務中產生的收據不視為交接。

  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 對等物。

相關技能