SuperAPI AI 工具集

consulting-an-oracle

编程与开发

查看项目

更新于 10-16 00:01

技能介绍

用途:当同一症状在本次会话中已尝试 3 次以上修复仍未收敛,或用户明确要求“问 oracle”“写封信给专家模型”“为另一个模型起草提示”时,用本技能把失败调查整理为一份可独立阅读的单次提示文件,交给无项目背景、无历史记忆的更强模型作答。原则是最少但充分的上下文优于整仓倾倒,聚焦的约 1500 行优于 30000 行堆砌。

主要能力与流程:先并行探测项目形态(Ruby 版本、框架、数据库、测试框架、后台任务、资源管线、类型工具、Hotwire 等);再拉取逐字失败信息,包括确切命令、完整堆栈、期望与实际的各一句话描述;接着按“假设—动作—结果”重建 3 至 7 条已尝试项,包含部分成功;然后以失败文件为中心一跳选取不超过 8 个文件、总计不超过 2000 行;在写入磁盘前先在内存中脱敏,排除 .env、master.key、credentials.yml.enc、.pem、.key 等文件,替换 API key、secret、token、password、含凭据的连接串等为 [REDACTED:<原因>];随后按模板写入文件,最后只打印路径、行数和建议调用方式,不调用任何模型,也不在编辑器中打开文件。还包含 Ruby/Rails 常见嫌疑清单:Zeitwerk 加载、冻结字符串字面量、线程安全、初始化器顺序、gem 版本漂移、猴子补丁、ActiveSupport 陷阱、环境差异、后台任务路径、schema 与模型不一致。

使用方式:输出位置为 tmp/oracle/<YYYY-MM-DD>-<slug>.md,Rails 项目已忽略 tmp/;不可写或非 Rails 时回退到 /tmp/oracle-<slug>.md。slug 用简短 kebab-case 描述症状。完成后打印文件路径与建议调用命令,例如 codex --model gpt-5-pro --file tmp/oracle/2026-05-06-<slug>.md,或粘贴到聊天界面。开始时应声明正在使用该技能。

适用场景:会话内调试停滞、上下文将被压缩但失败调查需作为一次性提示存活、或用户明确要求打包问题给外部模型。不适用于尚未真正调试、问题已解决、需连同完整插件工具转交给另一个 Claude 会话,或用户希望继续尝试的情形。

限制:技能只产出文件,不执行模型调用;需用户自行选择 oracle 并承担凭据、CLI 可用性与成本决策;单次模型无记忆,故提示须自包含、使用绝对路径并附 Git SHA,避免“会话早期”“如前所述”等指代。反模式包括整仓倾倒、概述堆栈、手工脱敏整个 .env、对用户用第二人称叙述、提出开放式问题、夹杂会话叙事。模板细节暂未提供。