oracle

Oracle 是一款专为软件开发环境与大型语言模型之间搭建桥梁的 CLI 工具。它允许开发者选取特定的档案集、目录或符合模式的档案，制作高上下文的「一次性」请求。透过自动化处理项目上下文提取，Oracle 确保 AI 模型能够获取技术架构、建置工具、设定档与错误日志等必要资讯，进而产出精确的调试、重构或架构设计建议。此工具针对如 GPT-5.2 Pro 等具备深度思考能力的模型进行了优化，并提供受管理的对话阶段生命周期。

• 透过自动聚合基于使用者自订模式的程式码库上下文，简化提示词工程流程。

• 支援双模式执行：针对需要长上下文的任务，提供浏览器自动化模式并支援持久化对话阶段；针对程式化需求，则提供标准 API 模式。

• 内建强大的预览与报告工具，让使用者在发送请求前即可检视档案载荷与权杖（Token）消耗，有效控制成本。

• 提供完善的阶段管理系统，若发生连线中断或逾时，使用者可随时重新附加（Reattach）至正在进行的分析任务。

• 遵循开发环境惯例（如 .gitignore），同时允许使用者精确控制纳入或排除的档案与目录。

• 在提示词中务必包含项目简介，说明技术栈、程式进入点以及期望的输出格式（如补丁计划、单元测试）。

• 在执行正式查询前，使用 --dry-run 与 --files-report 旗标来审核 Token 使用量并确认档案范围。

• 工具预设会忽略 node_modules 与 coverage 等编译产物，确保 AI 能聚焦于原始码逻辑。

• 对于复杂的问题分析，建议使用「穷举式提示」模式，提供明确的重现步骤、完整错误讯息与操作边界。

• Oracle 属于一次性上下文工具，请确保档案集中已明确包含所有必要设定档与进入点，以取得最佳的模型回应效果。