当前位置：首页 > news >正文

【openclaw实用Skill】oracle 技能

news 2026/4/29 18:52:45

Oracle CLI最佳实践,包括提示词+文件打包、引擎、会话和文件附加模式。Oracle将提示词和选定文件打包成"一次性"请求,让另一个模型用真实仓库上下文回答(API或浏览器自动化)。将输出视为建议性:对照代码和测试进行验证。

技能概述

oracle 技能是一个强大的代码分析和生成工具,它将用户的提示词和选定的文件打包成一个"一次性"请求,然后发送给另一个模型(如GPT-5.2 Pro)进行分析。Oracle的主要用例是通过浏览器模式使用GPT-5.2 Pro,这是一个"长时间思考"的路径,通常需要10分钟到1小时。Oracle提供了完整的会话管理功能,包括会话存储、重新附加和状态查询。使用Oracle时,应该将输出视为建议性的,并对照代码和测试进行验证。

下载地址:https://github.com/openclaw/openclaw/tree/main/skills

主要功能

文件打包: 将提示词和文件打包成一次性请求
多引擎支持: 支持API和浏览器两种引擎
会话管理: 存储会话、重新附加、状态查询
文件附加: 支持多种文件附加模式
远程主机: 支持远程浏览器主机
代码生成: 生成CLI和TypeScript类型定义

触发条件

在以下情况下应该调用此技能:

用户需要使用Oracle CLI进行代码分析
用户需要打包提示词和文件发送给模型
用户需要管理Oracle会话
用户需要生成CLI或类型定义

使用场景

场景1: 浏览器模式运行

用户需要使用GPT-5.2 Pro进行长时间分析,使用浏览器模式。

场景2: 预览请求

用户需要预览将要发送的请求和token消耗,使用dry-run模式。

场景3: 重新附加会话

用户需要重新附加到之前运行的会话,使用session命令。

处理过程

1. 帮助命令

oracle --help npx -y @steipete/oracle --help

2. 预览请求

oracle --dry-run summary -p "" --file "src/**" --file "!**/*.test.*" oracle --dry-run full -p "" --file "src/**"

3. Token检查

oracle --dry-run summary --files-report -p "" --file "src/**"

4. 浏览器模式运行

oracle --engine browser --model gpt-5.2-pro -p "" --file "src/**"

5. 手动粘贴回退

oracle --render --copy -p "" --file "src/**"

输入要求

使用此技能时,用户需要提供:

提示词: 要发送给模型的任务描述
文件: 要包含的文件、目录或glob模式
引擎(可选): API或浏览器引擎
模型(可选): 要使用的模型

输出说明

技能将提供:

分析结果: 模型对代码的分析和建议
会话ID: 存储的会话标识符
预览数据: 请求预览和token消耗

使用示例

示例: 使用浏览器模式运行Oracle

oracle --engine browser --model gpt-5.2-pro -p "" --file "src/**"

最佳实践

选择文件集: 选择包含真相的最少文件集
预览请求: 使用`--dry-run`和`--files-report`预览
浏览器模式: 使用浏览器模式进行常规GPT-5.2 Pro工作流
重新附加: 如果运行分离/超时,重新附加到存储的会话
验证输出: 将输出视为建议性,对照代码和测试验证

附加文件

包含: `--file "src/**"`、`--file src/index.ts`、`--file docs --file README.md`
排除: `--file "src/**" --file "!src/**/*.test.ts" --file "!**/*.snap"`
默认忽略: `node_modules`、`dist`、`coverage`、`.git`、`.turbo`、`.next`、`build`、`tmp`
遵循.gitignore: 扩展glob时遵循`.gitignore`
不跟随符号链接: 不跟随符号链接
文件大小限制: 拒绝大于1MB的文件