Oracle 二模评审
用 oracle 命令行把提示词和指定文件打包成一次性请求,交给第二个模型做代码评审、重构或排错交叉验证。
功能与用途
自己盯着代码改久了容易有盲区,想让另一个模型带着真实仓库上下文再看一遍。它用 npx 跑 @steipete/oracle,pick 一组最小但能说明问题的文件,先用 --dry-run 预览将要发送的内容和 token 开销,再走浏览器引擎(ChatGPT 里的 GPT-5.2 Pro)或 API 引擎发起请求;运行可能要十几分钟到一小时,超时别重跑而是 reattach 到已存会话。输出只作参考,仍要对着代码和测试核实,也不要默认把 .env 之类的密钥带上。
适用场景
- 疑难 Bug 交叉排查:遇到难以定位的隐蔽缺陷时,将错误日志、最小复现上下文及相关源码打包,让高阶模型以全新视角交叉验证并寻找逻辑盲区。
- 架构重构与方案评审:在进行关键模块重构或接口改造前,打包核心代码与设计约束,请求第二模型评估架构改动风险并给出多方案权衡。
- 深度代码与质量走查:关键功能发布前,挑选核心业务逻辑文件并排除敏感密钥,交由另一高推理模型进行独立代码审查,识别潜在漏洞与边界隐患。
适用人群
- 做代码评审和重构决策的后端工程师
- 需要跨模型交叉验证方案架构师
- 排查诡异缺陷时想换个模型看问题的开发者
使用步骤
- 先精挑文件集:用最少的文件覆盖问题真相,用 --file 传目录或 glob,用 ! 前缀排除测试和快照文件。
- 跑 --dry-run summary 或 --dry-run full 预览将要发送的内容,需要时加 --files-report 看谁的 token 占大头,控制总量在 196k 以内。
- 按需选引擎:默认浏览器引擎配合 GPT-5.2 Pro 走 ChatGPT 人机回路,设了 OPENAI_API_KEY 会自动选 api;用 Claude、Grok 或多模型必须显式 --engine api 且需用户同意(有费用)。
- 发起运行;长耗时和 detached 是正常的,超时不要重跑,用 oracle status --hours 72 找到会话再 oracle session <id> --render 接回。
- 读返回的评审意见,当作参考而非结论,回到代码与测试中核实;需要复现同一上下文就用同一份提示词和 --file 组合重跑。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- 1.0.1
- 最近更新
- 2026-05-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation.
使用前准备
- 本机有 Node.js 环境可用 npx 运行 @steipete/oracle
- 浏览器引擎需要 ChatGPT 已登录,API 引擎需要设置 OPENAI_API_KEY 并取得用户对费用的同意。
依赖与权限
- OPENAI_API_KEY
- 读取用户主动提供的内容