Community研究与数据分析github.com

顾问审查技能

一个便携式AI代理技能,用于对工作成果、设计方案或问题诊断进行结构化、独立的审查,支持ChatGPT、Codex及兼容代理。

顾问审查技能 是什么?

该技能为AI代理(如Codex、ChatGPT)提供了一套标准化的独立审查工作流。其主要用途是在代理执行关键决策、陷入困境、面临重大方案转折或完成工作后进行系统化的审计和挑战,从而提升结果质量和安全性。技能支持多种审查阶段(如规划挑战、故障诊断、方案对比、最终审计)并根据上下文复杂度选择不同努力等级(从高到极高)。工作流的核心是通过隔离的子进程运行审查脚本,生成带有模型和努力等级验证的收据,并基于决策合同解析每条建议。技能还包含严格的预算控制(默认一次审查,最多两次)和自修改行为门控,确保审查本身的可靠性和可重复性。该技能适用于需要深度推理和结果验证的高风险AI交互场景。

兼容平台✓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 的新对话。

文档

顾问审查

使用此技能目录中的捆绑脚本。显式调用是一个锁存器:在给出实质性最终答案或采取后续或冲突行动之前,在同一父任务中运行审查程序。构建数据包时,只读证据收集可以继续进行。

不要搜索全局工具目录寻找顾问。不要打开第二个用户可见的任务。唯一的子执行是由 scripts/run_advisor.py 启动的隔离 codex exec 进程。

要求

需要Shell执行、经过身份验证的本地 codex CLI、对所请求的 gpt-5.6-sol 模型路由的访问权限,以及父Shell的出站Codex API访问权限。阻止子进程网络连接的父沙箱也会阻止嵌套的审查程序。如果缺少任何要求,则报告独立审查被阻止;未经用户或任务授权,不要削弱沙箱。

运行程序不是机密性边界。在构建数据包之前,对证据和工件进行消毒。

工作流

  1. 宣布正在使用顾问审查及其原因。

  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. 使用验证后的下一步操作和停止条件继续父任务。

卡住工作规则

  • 在更改更多状态之前先进行诊断。
  • 区分执行边界:父任务、隔离审查进程和任何其他用户可见的任务是分开的。
  • 不要让单独任务的收据替代同一任务的交接。
  • 倾向于进行一个只读或可逆的实验来区分竞争性假设。
  • 在用户重复纠正后,不要在没有新证据的情况下重复相同的建议。
  • 不要将范围从一个有故障的子系统扩大到插件、服务、仓库或包,除非有证据将它们联系起来。

审查预算

默认使用一次审查。仅在新证据实质上改变了决策或有理由进行高风险最终重新检查时,才允许进行第二次审查。仅允许在调和具体冲突时进行第三次审查。切勿创建无休止的评审循环。

技能更改行为门控

在修改“顾问审查”本身时,运行确定性测试和至少一个消毒后的行为测试夹具:

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

在可行的情况下使用配对的新/旧夹具。判断检测、证据关联、有界实验和风险操作率——而不是散文相似性。

报告

报告:

  • 阶段、上下文模式、请求的Sol模型、请求的努力等级和身份验证状态;
  • 顾问结论和基于证据的诊断;
  • 每个重要建议的采纳/拒绝/推迟处置;
  • 选定的下一步操作和停止条件;
  • 未解决的风险或上下文限制。

将结果称为顾问式独立审查,而非Claude顾问等同体。

相关技能