Oracle 第二模型审查实战指南：用 agent-scripts 打包仓库上下文并交给 GPT-5.5 Pro 等外部模型

【免费下载链接】agent-scriptsScripts for agents, shared between my repositories.项目地址https://gitcode.com/gh_mirrors/ag/agent-scripts点击查看免费下载本文面向在 agent-scripts 仓库AGENTS.MD管理的多 Agent 工作流中运行OracleCLI 的开发者。Oracle 会将你的提示词与选定的仓库文件打包成一次性的单发one-shot请求交给 API 或浏览器自动化驱动的另一模型如 ChatGPT 中的 GPT-5.5 Pro基于真实代码库上下文回答问题。读完本文你将掌握--dry-run预览、--file附件筛选、浏览器/API 双引擎切换、会话重挂载、API 预检以及高信号提示词模板的完整用法并把 Oracle 当作仓库里 github-project-triage 等技能中独立第二意见审查的可靠工具。一、Oracle 是什么把上下文打包与模型回答解耦Oracle 的核心设计只有一句话把你的 prompt 选中的文件打包成一个请求让另一个模型带着真实仓库上下文来回答支持 API 或浏览器自动化两种通道。关键认知原文档明确强调Oracle 对被审查的仓库一无所知它不会预载项目知识提示词里没写的东西模型就是不知道。因此提示词必须自带项目简报见下文Prompt 模板一节。输出是咨询性的advisory任何回答都必须回到代码库与测试中核对不能直接当作结论落地。运行是一次性的one-shot模型不会记住上一次运行如果需要复现同样的上下文必须用相同的 prompt 相同的--file …集合重跑。二、Oracle 在 agent-scripts 仓库中的定位在本仓库中Oracle 被显式登记为Agent 工作流类技能。可验证的依据如下tools.md 将其收录为开发环境工具Hand prompts files to other AIs (GPT-5 Pro, etc.)并给出使用方式npx -y steipete/oracle --help。skills.sh.json 将其归入Agent Workflows分组与agent-transcript、create-cli、frontend-design、markdown-converter、skill-cleaner并列。AGENTS.MD 提到浏览器自动化场景下的配合规则当 Oracle 这类工具需要附加attach到 Chrome 时应运行 auto-approve 监听器避免每次连接都在屏幕上弹出手工点击的授权提示。github-project-triage/SKILL.md 将 Oracle 作为独立审查选项之一对于每一个看起来可以自治完成的问题当工具支持时先用高推理子代理、oracle 或独立代理审查来核实可行性——只给子代理任务局部的证据并询问该事项能否自治完成、需要什么验证、什么会带来不安全。也就是说在本仓库的多 Agent 体系中Oracle 的标准角色是第二模型second-model复审审查、调试、重构、设计建议都能用但结论一律是辅助性的。三、主用路径浏览器引擎 GPT-5.5 Pro仓库内的默认工作流是--engine browser ChatGPT 中的 GPT-5.5 Pro这是典型的人在回路human in the loop路径运行时长可能从约 10 分钟到 1 小时属于正常现象运行会产生一个可存储、可重挂载的会话stored sessionCLI 超时后不要重跑而是重挂载。推荐默认配置原文档给出的基线维度推荐值Enginebrowser--engine browserModelGPT-5.5 Pro即--model gpt-5.5-pro或在 ChatGPT 界面用选择器标签如--model 5.5 ProAttachments目录/glob 排除规则避免携带密钥四、黄金路径Golden Path快且可靠的四步法挑选紧凑的文件集选最少但仍包含真相的文件而不是整仓库堆上去。先预览再发送需要时用--dry-run--files-report查看即将发送的内容与体积。默认走浏览器模式常规 GPT-5.5 Pro ChatGPT 工作流只有明确需要时才用 API。脱附/超时后重挂载oracle session id --render重连已存储的会话不要重新跑。五、命令速查从预览到运行以下命令均基于npx -y steipete/oracle每次会话先跑一次--help熟悉语法是仓库 tools.md 的明确建议。查看帮助npx -y steipete/oracle --help需要隐藏/高级参数时npx -y steipete/oracle --help --verbose预览不消耗 token# 摘要式预览 npx -y steipete/oracle --dry-run summary -p task --file src/** --file !**/*.test.* # 完整式预览 npx -y steipete/oracle --dry-run full -p task --file src/**Token/成本检查npx -y steipete/oracle --dry-run summary --files-report -p task --file src/**启动/性能追踪npx -y steipete/oracle --perf-trace --perf-trace-path /tmp/oracle-perf.json --dry-run summary -p task --file src/**当 CLI 启动或首字节输出time-to-first-output感觉缓慢时使用重点查看first-output和exit两个指标。浏览器运行主路径长时间运行属正常npx -y steipete/oracle --engine browser --model gpt-5.5-pro -p task --file src/**手动粘贴兜底组装好后复制到剪贴板npx -y steipete/oracle --render --copy -p task --file src/**注意--copy是--copy-markdown的隐藏别名。六、--file附件机制详解--file同时接受文件、目录和 glob可多次传递条目也支持逗号分隔。这是原文档的核心章节下面完整展开。包含规则# 目录 glob --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除非你显式把它们作为字面目录/文件传入尊重.gitignoreglob 展开时会遵守.gitignore不跟随符号链接glob 展开使用followSymbolicLinks: falseDotfile 过滤默认过滤点文件除非显式使用包含点段的模式例如--file .github/**单文件上限超过1 MB的文件默认被拒绝除非调高ORACLE_MAX_FILE_SIZE_BYTES环境变量或~/.oracle/config.json中的maxFileSizeBytes这几点直接服务于紧凑文件集 不泄密的原则默认排除构建产物与点文件就是为了让你送出的包干净、可审计。七、预算与可观测性目标保持总输入在约 196k token以内。用--files-report或--dry-run json在花钱之前揪出token 大户文件。用--perf-trace/ORACLE_PERF_TRACE1做启动与首字节输出计时追踪信息会脱敏prompt、tokens、密钥、cookies 与内联 cookie 载荷脱附的 API 子进程会写一个带会话后缀的 sidecar 追踪文件。需要隐藏/高级开关时npx -y steipete/oracle --help --verbose。八、引擎选择API vs Browser自动选择规则设置了OPENAI_API_KEY时自动用api否则用browser。引擎能力边界browser 引擎只支持 GPT Gemini需要 Claude / Grok / Codex 或多模型并行时用--engine api。API 的强制前置条件API 运行会消耗费用因此必须获得用户明确同意后才能开始。浏览器附件选项--browser-attachments auto|never|alwaysauto自动内联粘贴上限约 60k 字符超出后转为上传。多文本文件打 ZIP 上传保留文件名--browser-bundle-files --browser-bundle-format zip远程浏览器主机签名登录的机器跑自动化# 主机侧 oracle serve --host 0.0.0.0 --port 9473 --token secret # 客户端侧 oracle --engine browser --remote-host host:port --remote-token secret -p task --file src/**九、API Preflight跑之前先体检API 运行需要显式同意且花钱因此在真正启动前应先检查各 provider 的就绪状态——且不能打印密钥# 检查 provider 与模型可用性 oracle doctor --providers --models gpt-5.4,claude-4.6-sonnet,gemini-3-pro # 轻量预检 oracle --preflight --models gpt-5.4,gemini-3-pro # 查看路由结果 oracle --route --model gpt-5.4防止 Azure 环境劫持路由如果用户想要第一方 OpenAI显式传入--provider openai或--no-azure避免导出的 Azure env/config 劫持路由oracle --provider openai --engine api --model gpt-5.5-pro ...多模型专家组 部分成功对部分成功也有用的咨询式多模型面板使用--allow-partial --write-output path这样成功的模型文件与stem.oracle.json清单都易于恢复oracle --models gpt-5.4,claude-4.6-sonnet,gemini-3-pro --allow-partial --write-output /tmp/panel.md -p task超时语义--timeout 10m是面向用户的常规 API 截止时间除非显式设置--http-timeout否则 Oracle 会从--timeout推导 HTTP 传输超时。通过 1Password 注入个人 OpenAI 密钥若导出的OPENAI_API_KEY无效、而用户希望用自己的个人 key可在单个持久 tmux 会话中用$one-password取用。已知条目API Key - OpenAI - Personal字段api_key。只注入到那一条 Oracle 命令中绝不打印 keyOPENAI_API_KEY$(op item get API Key - OpenAI - Personal --account my.1password.com --fields labelapi_key --reveal) oracle --provider openai --engine api --model gpt-5.5-pro ...调试 Oracle 本体优先使用本地 checkout~/Projects/oraclepnpm -C ~/Projects/oracle run build node ~/Projects/oracle/dist/scripts/run-cli.js ...十、会话与 Slug别丢工作会话存储在~/.oracle/sessions可用ORACLE_HOME_DIR覆盖。浏览器运行会把持久文件保存在~/.oracle/sessions/id/artifacts/下包括transcript.md、Deep Research 报告以及可获取时下载的 ChatGPT 生成图片。运行可能脱附或耗时很长浏览器/API GPT-5.5 Pro 很常见。CLI 超时后不要重跑重挂载# 列出近期会话例如最近 72 小时 oracle status --hours 72 # 渲染重挂载指定会话 oracle session id --render用--slug 3-5 words让会话 ID 可读。存在重复 prompt 守卫只有当你确实想要全新运行时才用--force。CLI 护栏没有 prompt 的 root 运行以非零码退出--dry-run与--render/--render-markdown冲突Ctrl-C 会以退出码 130 结束前台 API 运行而浏览器清理/重挂载仍会继续。十一、Prompt 模板高信号因为Oracle 以零项目知识启动模型无法推断你的技术栈、构建工具、约定或显而易见的路径。提示词必须包含项目简报技术栈 构建/测试命令 平台约束东西都在哪关键目录、入口点、配置文件、依赖边界精确的问题 你尝试过什么 错误原文逐字约束不要改 X必须保持公共 API性能预算等期望输出返回补丁方案 测试列出风险假设给出 3 个方案并说明权衡。穷举式 prompt模式为后续还原而写当你预判这是一次长调查时写一个日后可独立站立的 prompt顶部6–30 句的项目简报 当前目标中部可复现的复现步骤 精确报错 你已尝试过的内容底部附上全部所需上下文文件让一个全新模型能完整理解入口点、配置、关键模块、文档。需要复现同样的上下文时用相同的 prompt 相同的--file …集合重跑Oracle 是一次性运行模型不记得上次运行。十二、安全底线默认不附密钥.env、key 文件、认证 token 一律不要进包激进地脱敏只分享必需的。刚刚好的上下文优先更少的文件 更好的 prompt胜过整仓库倾倒。这与本文第四节的 Golden Path 完全一致也是 AGENTS.MD 中密钥绝不外泄、输出必须脱敏这条硬规则在 Oracle 工作流里的具体化。十三、落地清单自检阶段动作关键命令/参数1确认语法npx -y steipete/oracle --help每会话一次2选文件集--file src/** --file !**/*.test.*牢记 1 MB 上限与默认忽略目录3预览--dry-run summary --files-report确认 token 预算约 196k 内4跑--engine browser --model gpt-5.5-pro -p task --file src/**5超时处理oracle status --hours 72oracle session id --render不重跑6核对所有输出回到代码库 测试验证仅作咨询使用把 Oracle 的输出当成第二双眼睛它负责在你钻进代码细节前用完整上下文帮你做审查、调试与重构设计而最终的事实裁决永远以仓库源码与测试为准。赞分享【免费下载链接】agent-scriptsScripts for agents, shared between my repositories.项目地址https://gitcode.com/gh_mirrors/ag/agent-scripts点击查看免费下载相关推荐PyTorch 模型打包实战torch.package 打包模型、代码与资源并实现隔离部署PyTorch 模型打包实战torch.package 打包模型、代码与资源并实现隔离部署 torch.package 是 PyTorch 内置的打包框架它人工智能机器学习深度学习分布式训练模型编译Agno AdvisorTools 实战指南让 Agent 借助多个顾问模型获得第二意见与领域审查Agno AdvisorTools 实战指南让 Agent 借助多个顾问模型获得第二意见与领域审查 本指南基于 Agno 仓库中 cookbook/91_to人工智能大模型AI AgentAgent 框架多智能体工具调用RAGAgent 工作流Agent 记忆CCG Workflow 多模型交叉审查实战Agent Teams 双后端并行审查与 Critical 门禁机制全解CCG Workflow 多模型交叉审查实战Agent Teams 双后端并行审查与 Critical 门禁机制全解 导读 本文围绕 ccg workflow人工智能AI 应用开发工具CLIAI Agentdsh-pluginDeepSeek创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考