核心用法
Oracle 是 @steipete/oracle CLI 工具的包装文档，核心功能是将用户提示词与选定的代码文件打包成「一次性」请求，发送至第二模型（GPT-5.2 Pro 或其他）进行审查、调试或交叉验证。支持两种引擎模式：浏览器模式（默认，人工介入，适合长时任务）和 API 模式（需显式授权，按量计费）。
典型工作流：
1. 精简文件集（最少必要文件）→ 2. --dry-run 预览 → 3. --engine browser 运行 → 4. 如超时则 reattach 会话
关键命令：
npx -y @steipete/oracle --dry-run summary -p "<task>" --file "src/**"（预览模式，零成本）npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/**"（主路径）oracle status --hours 72+oracle session <id> --render（会话管理）
显著优点
- 权威开发者背书：作者 Peter Steinberger 为 PSPDFKit 创始人兼 CEO，iOS/macOS 社区知名开发者
- 零依赖安全：Skill 本身为纯 Markdown 文档，无可执行代码、零依赖、零网络请求
- 灵活的文件选择：支持 glob 模式、排除规则（
!前缀）、自动尊重.gitignore - 成本可控：
--dry-run+--files-report可在发送前精确预估 token 用量（建议 <196k tokens） - 会话持久化：长时任务自动存储，支持断线重连，避免重复消费
潜在缺点与局限
- 数据外传风险：用户代码和提示词将被发送至 OpenAI/Gemini 等第三方服务，需自行评估合规性
- 浏览器模式耗时：GPT-5.2 Pro 工作流可能耗时 10 分钟至 1 小时，不适合紧急场景
- API 模式需显式授权：需配置
OPENAI_API_KEY并手动确认，增加使用门槛 - 文件大小限制：>1 MB 文件被拒绝，需手动拆分或缩小范围
- 无持续记忆：每次运行为「one-shot」，模型不记忆历史会话
适合人群
- 需要第二意见验证的中大型项目开发者
- 进行复杂重构、架构评审或调试的工程师
- 对 AI 辅助代码审查有预算和控制需求的团队
- 重视数据安全、愿意主动管理文件包含范围的用户
常规风险
1. 敏感信息泄露：--file 参数可能意外包含 .env、密钥文件，需配合 --dry-run 严格审查
2. 供应商锁定：深度依赖 OpenAI/GPT 生态，切换模型需调整工作流
3. 成本累积：API 模式按 token 计费，大型代码库多次运行可能产生意外费用
4. 输出幻觉：AI 建议需对照实际代码库和测试验证，不可直接采纳