Oracle

核心用法

Oracle 是一款由 Peter Steinberger（steipete）开发的 CLI 工具，核心功能是将用户 prompt 与选定文件打包成「one-shot」请求，让大模型在真实代码库上下文中作答。支持浏览器自动化和 API 两种引擎模式。

关键工作流：

• 文件选择：通过 --file 支持 glob 模式、多路径、排除规则，自动忽略 node_modules 等目录
• 预览验证：--dry-run + --files-report 可在零 token 消耗下检查 payload 和文件范围
• 浏览器模式（主推）：搭配 GPT-5.2 Pro，支持 10 分钟至 1 小时的长思考任务，会话可断点续连
• API 模式：需设置 OPENAI_API_KEY，支持 Claude/Grok/Codex 等多模型

会话管理：
会话持久化存储于 ~/.oracle/sessions，支持 --slug 命名、状态查询（oracle status）和断点重连（oracle session <id>）。任务中断时切勿重跑，应直接重连原会话。

显著优点

1. 上下文工程优化：通过精简文件集（最小真理集）+ 结构化 prompt 模板，显著提升大模型回答质量
2. 浏览器自动化成熟：专为 GPT-5.2 Pro 长时任务设计，自动处理 paste/upload 切换（~60k 字符阈值）
3. 安全导向设计：默认排除敏感路径，文档明确警告不附加密钥文件，提供 --render --copy 手动审查 fallback
4. 远程执行支持：oracle serve 支持服务端部署，客户端通过 token 认证远程调用
5. 零状态依赖：每次运行独立，「恢复上下文」即重新执行相同 prompt+文件集

局限性与风险

工具层局限：

• 浏览器模式仅支持 GPT/Gemini，Claude/Grok 需切换 API 引擎
• 文件 >1MB 自动拒绝，超大仓库需手动切片
• 纯文档型 Skill，实际执行依赖用户本地安装的 @steipete/oracle NPM 包

使用风险：

• token 成本盲区：大文件集 × 长思考模型易产生高额费用，必须先用 --dry-run 验证
• 模型幻觉：输出标记为「advisory」，需人工核对代码+测试，不可直接合入生产
• 会话堆积：长时任务可能产生大量持久化会话，需定期清理 ~/.oracle/sessions
• 浏览器稳定性：自动化依赖 ChatGPT 网页结构，官方 UI 变更可能导致 breakage

适合人群

• 需要深度代码审查、重构规划、复杂 bug 定位的资深开发者
• 使用 GPT-5.2 Pro/Claude/Gemini 等大模型进行「长思考」任务的技术团队
• 追求可复现、可审计 AI 辅助流程的工程负责人（通过 --slug + 持久化会话实现）

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 敏感数据泄露 | 误将 `.env`、密钥文件 attach 给模型 | 严格遵循文档警告，使用 `--file` 白名单而非黑名单 |

| 成本失控 | 大 payload × 长思考模型 | `--dry-run` 预览 token 消耗，设置预算警报 |

| 模型输出误用 | 将 advisory 建议直接合入生产 | 强制要求代码审查+测试验证 |

| 本地依赖风险 | `@steipete/oracle` 包本身的安全更新 | 关注 NPM 安全公告，pin 版本号 |

该 Skill 本身为纯文档类型，经 CLS-Certify 六维扫描获 S 级/98 分 认证，来源 T2（可信开发者），无代码执行风险。