Council Oracle 用于对复杂问题进行深度分析与推理,把 Codex 和 Claude 子代理当作两位资深架构师,让二者独立分析同一问题,再由 Claude 作为主导综合者交叉验证、去重并合并为一份统一报告。
用途与适用场景:架构分析与设计决策、疑难或复杂 Bug 调试、变更影响评估、安全推理与威胁建模、重构策略评估、方案权衡分析,以及关于代码库的复杂“为什么/怎么做”问题。不适用场景:简单事实性问题(直接回答)、代码生成、代码审查(改用 council-review)、需要修改文件的任务(本技能为只读分析)。
使用方式:Codex CLI 需先安装 npm i -g @openai/codex,并用 codex login 认证。若只安装了一个 CLI,则退回使用可用的 oracle 并给出警告,分析仍有价值。流程上,先由 Claude 用 Read、Grep、Glob 收集相关代码与上下文,并用 context7 获取最新官方文档、用 WebSearch 查找官方博客与权威参考资料,将上下文写入临时文件,通过 --context-file 传入。随后并行运行两个 oracle:Codex 以 scripts/codex-oracle.py 作为后台 Bash 任务运行(可能耗时较长,需等待完成通知),命令形如 python3 scripts/codex-oracle.py --question "..." --context-file path1 --context-file path2 [--focus text] [--dry-run];同时用 Agent 工具启动 Claude 子代理(subagent_type="general-purpose"),仅使用只读工具,从资深架构师视角分析并返回结构化结论(摘要、关键发现、建议、风险)。
交叉验证与综合:两个响应都返回后,对 Codex 的每条发现分别确认、质疑或改进,并补充 Claude 子代理的独到见解;然后合并、去重并重写为一份统一报告,报告模板见 references/output-format.md,综合规则见 references/synthesis-rules.md。报告按主题组织,不按来源分节,读起来应像单一分析师完成。规则包括:两个 oracle 必须并行运行并使用相同问题与上下文;必须等两者都完成再综合;Codex 始终通过包装脚本调用,不直接调用 codex CLI;缺少 Codex CLI 时仅运行 Claude 子代理并正常综合。运行脚本时不要阅读脚本源码,直接运行并用 --help 查看用法。其他细节(如具体模型、超时上限之外的信息)暂未提供。