Agent Skills
返回列表
💻

Oracle CLI 最佳实践

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-oracle。

技能介绍

要解决什么问题

让模型帮你读仓库、排错或给改法时,它默认不知道你的栈、目录约定和真实错误原文。手工复制零散文件很容易漏关键入口、把测试夹带进上下文,或不小心附上 .env。Oracle CLI(@steipete/oracle)把提示词 + 你选定的文件集合打成一次「one-shot」请求,走浏览器(常见是 ChatGPT 里的 GPT‑5.2 Pro)或 API,让回答建立在当前仓库片段上,而不是泛泛猜测。

技能如何工作

核心流程是:收窄文件集 → 预览将要发送的内容 → 再真正跑一轮。

  • 选文件(--file):支持目录、glob 与排除(!**/*.test.*);默认会跳过 node_modules、.git 等,并尊重 .gitignore;单文件超过 1 MB 会被拒绝。
  • 零花费预览:--dry-run 可看摘要把要进上下文的内容;配合 --files-report 在花钱前找出 token 大户,目标是把总输入压在约 196k tokens 以内。
  • 主路径浏览器:--engine browser 配合 --model gpt-5.2-pro,属于「人在回路」;一轮可能 10 分钟到 1 小时 都正常,会话会落在 ~/.oracle/sessions,超时别重跑,用 oracle session 重新挂载。
  • 提示词模板:技能强调 Oracle 从零开始——必须在 prompt 里写清栈、构建/测试命令、关键目录、verbatim 报错、约束与期望输出(例如「给 patch 计划 + 测试」)。

技能明确:把模型输出当建议,务必对照代码库与测试自行验证。

适用边界与注意点

  • 安全:默认不要挂密钥、token;宁可少文件 + 高信号 prompt,也别整仓 dump。
  • 引擎:浏览器侧主要面向 GPT/Gemini;Claude/Grok 等需 --engine api,且 API 会产生费用,需明确同意后再跑。
  • 可复现:Oracle 每次 run 都是 one-shot,模型不会记住上次;若要以后还原同一调查上下文,需要保存同一段 exhaustive prompt + 同一套 --file。

使用场景

  • 重构前用 `--dry-run` 和 `--files-report` 核对 `src/**` 进上下文的 token 体量,避免 GPT 会话一上来就超预算。
  • 长时 browser 跑 GPT‑5.2 Pro 排障时 CLI 断开,用 `oracle status` 找到会话再用 `oracle session` 挂载继续,而不是重跑丢进度。
  • 需要把 prompt 与若干 glob 文件手动贴进 ChatGPT 时,用 `--render --copy` 生成可粘贴的 Markdown 包。
  • 本机已登录 ChatGPT、远程机器只有代码时,用 `oracle serve` 配 `--remote-host` 让浏览器自动化在已登录主机上执行。

适合人员

  • 维护单体/多包仓库、需要把「栈说明 + 关键模块 + verbatim 报错」一次性喂给外部模型的后端工程师
  • 经常让 ChatGPT 浏览器模式读代码、但苦于复制遗漏入口文件与配置的前端/全栈开发者
  • 负责安全审查上下文、要求排除 `.env` 与测试噪音后再问模型的平台或 DevOps 工程师
  • 跨时区协作、会话易超时且必须靠 slug 与 session 恢复调查上下文的 Tech Lead