用途：Oracle 将提示词与代码库文件打包，向 GPT-5.2 Codex 发起单次请求，用于复杂任务的深度规划，适合 5 个以上规格、依赖关系不清、架构决策、迁移规划、性能优化等需要 10 分钟以上规划的场景；简单任务、线性实现、缺陷修复、快速重构不建议使用。
主要能力：一次性执行输出 plan.md 到当前目录；支持 --dry-run summary --files-report 预览 token 数（目标 <196k）；支持 --file 包含与 ! 排除的文件模式，默认忽略 node_modules、dist、coverage、.git、.turbo、.next、build、tmp，超过 1MB 的文件被拒绝；会话存储在 ~/.oracle/sessions，超时后可用 session <session-id> --render 重新附加而不重跑。
前置与用法：需安装 Oracle CLI：npm install -g @steipete/oracle，或使用 npx -y @steipete/oracle --help。典型流程为：编写提示词到 /tmp/oracle-prompt.txt，预览 token，执行 npx -y @steipete/oracle --engine browser --model gpt-5.2-codex --slug "..." -p "$(cat /tmp/oracle-prompt.txt)" --file "src/**" 等，用 npx -y @steipete/oracle status --hours 1 查看状态，完成后 cat plan.md 阅读，再把阶段/任务转换为 spec YAML。
限制：Oracle 不做交互，只输出结果；coding 任务应使用 gpt-5.2-codex 模型；超时不要重跑而应重新附加会话；--force 仅用于有意重复运行。具体收费、价格与平台支持暂未提供。