SuperAPI AI 工具集

oracle

智能体与模型

查看项目

更新于 10-16 04:23

技能介绍

用途

Oracle 是用于管理 Oracle instruments 的技能与档案(profile)管理工具。它让用户按需启用、禁用和组合各类技能,而不是一次性加载全部内容。

主要能力

档案(Profiles,层级)

提供三档基础档案,按需选择:

档案 技能数 说明
minimal 4 日常仪式:standup → recap → work → rrr → forward
standard 9 日常主力 + 探索(覆盖约 96% 的实际使用)
full 30 全部技能
  • minimal(4 个技能):forward、rrr、recap、standup
  • standard(9 个技能):minimal + trace、dig、learn、talk-to、oracle-family-scan
  • full(30 个技能):启用全部技能

功能模块(Features,附加模块)

可在任意档案之上叠加领域特定的技能集:

功能 技能数 适用时机
soul 6 孕育/唤醒新的 oracles
network 5 多 oracle 通信
workspace 3 并行工作 + 日常运维
creator 4 内容创作 + 研究
  • soul:awaken、philosophy、who-are-you、about-oracle、birth、feel
  • network:talk-to、oracle-family-scan、oracle-soul-sync-update、oracle、oraclenet
  • workspace:worktree、physical、schedule
  • creator:speak、deep-research、watch、gemini
  • 已弃用(可恢复):merged、fyi —— 调用量 0-1 次,已从 v3 移除

组合示例:

  • minimal + soul → 社区 oracle(10 个技能)
  • minimal + creator → 内容创作者(8 个技能)
  • standard + network → oracle 开发者(14 个技能)
  • standard + workspace → 并行 agent 工作(14 个技能)

使用方式

命令一览

命令 操作
/oracle prepare 检查并安装 git、gh、ghq
/oracle profile 显示档案与当前状态
/oracle profile minimal 切换到 minimal(4 个技能)
/oracle profile standard 切换到 standard(9 个技能)
/oracle profile full 启用全部 30 个
/oracle feature add soul 添加 soul 技能
/oracle feature remove creator 移除 creator 技能
/oracle enable trace dig 启用指定技能
/oracle disable watch gemini 禁用指定技能
/oracle skills 列出全部技能及 ✓/✗ 状态

/oracle prepare

检查所需工具并安装缺失项,必要时配置 gh auth。

先通过运行时环境(如 uname 或 $OSTYPE)检测平台,对应包管理器如下:

平台 包管理器
macOS brew install <pkg>
Linux(Debian/Ubuntu) sudo apt install <pkg>(gh 使用官方 gh 仓库)
Linux(Fedora/RHEL) sudo dnf install <pkg>
Linux(Arch) sudo pacman -S <pkg>
Windows winget install <pkg> 或 scoop install <pkg>

步骤(按顺序执行):

  1. 检查 git:git --version,缺失则用平台包管理器安装
  2. 检查 gh:gh --version,缺失则安装:
    • macOS:brew install gh
    • Debian/Ubuntu:参照 https://github.com/cli/cli/blob/trunk/docs/install_linux.md
    • Windows:winget install GitHub.cli
    • 其他:使用平台包管理器
  3. 检查 gh auth:gh auth status,未认证则运行 gh auth login 并引导用户完成
  4. 检查 ghq:ghq --version,缺失则安装:
    • macOS:brew install ghq
    • Linux/Windows:go install github.com/x-motemen/ghq@latest(需 Go),或从 GitHub releases 下载二进制
  5. 检查 ghq root:ghq root,未设置则建议 git config --global ghq.root ~/Code

结束时输出汇总表:

Platform: macOS / Linux (Ubuntu) / Windows
Tool    Status
----    ------
git     ✓ installed (2.x.x)
gh      ✓ installed + authenticated
ghq     ✓ installed (root: ~/Code)

若一切已就绪,只打印汇总,不做改动。

/oracle profile

列出可用档案与当前状态,显示当前激活的档案、已启用的功能以及技能数量:

Current: standard + soul (15 skills enabled, 15 disabled)

Profiles:
  minimal     4 skills   Daily ritual
  standard    9 skills   Daily driver + discovery  ← active
  full       30 skills   Everything

Features:
  soul        6 skills   Birth/awaken oracles  ← active
  network     5 skills   Multi-oracle comms
  workspace   5 skills   Parallel work + ops
  creator     4 skills   Content + research

/oracle profile <name>

切换到某个档案层级,启用该档案的技能并禁用其余技能。

  • 启用 = 将 SKILL.md.disabled 重命名为 SKILL.md
  • 禁用 = 将 SKILL.md 重命名为 SKILL.md.disabled

不会删除任何内容;被禁用的技能仍保留在磁盘上,只是对 AI 不可见。

Switching to: standard

  ✓ forward        (was ✓)
  ✓ rrr            (was ✓)
  ✓ recap          (was ✓)
  ✓ standup        (was ✗ disabled → enabled)
  ✓ trace          (was ✓)
  ...
  ✗ awaken         (was ✓ enabled → disabled)
  ✗ oraclenet      (was ✓ enabled → disabled)
  ...

9 enabled, 21 disabled. Restart session to apply.

切换后需重启会话生效。

/oracle feature add <name>

在当前档案之上启用一个功能模块(启用该功能包含的所有技能)。

/oracle feature remove <name>

禁用一个功能模块(仅禁用不属于当前激活档案的技能)。

/oracle enable <skill...>

按名称启用指定技能,对每个技能执行:

# ~/.claude/skills/<name>/SKILL.md.disabled → SKILL.md

/oracle disable <skill...>

按名称禁用指定技能,不删除任何内容:

# ~/.claude/skills/<name>/SKILL.md → SKILL.md.disabled

/oracle skills

列出全部技能及当前状态,例如:

Oracle Skills (30 installed, 9 enabled, 21 disabled)

  ✓ forward          minimal    730 calls
  ✓ rrr              minimal    981 calls
  ✓ recap            minimal    449 calls
  ✓ standup          minimal      4 calls
  ✓ trace            standard  1537 calls
  ✓ dig              standard   679 calls
  ✓ learn            standard   420 calls
  ✓ talk-to          standard   177 calls
  ✓ oracle-family-scan standard  319 calls
  ✗ awaken           [soul]      25 calls
  ✗ philosophy       [soul]      29 calls
  ✗ worktree         [workspace] 63 calls
  ✗ merged           [workspace]  0 calls
  ...

/oracle install <skill>

安装单个技能:

oracle-skills install -g -y --skill <skill>

/oracle remove <skill>

卸载单个技能:

oracle-skills uninstall -g -y --skill <skill>

适用场景

  • 需要按不同工作模式(日常仪式、日常开发、全量)快速切换技能集
  • 需要在基础档案上叠加特定领域能力(如新 oracle 的孕育/唤醒、多 oracle 通信、并行工作、内容创作与研究)
  • 希望精确启停单个技能,并保留已安装但暂不使用的技能

限制

  • 档案切换后需重启会话才能生效
  • 被禁用的技能虽保留在磁盘上,但对 AI 不可见
  • 功能模块移除时仅禁用不属于当前激活档案的技能
  • 依赖 git、gh、ghq 等外部工具,需先行准备
  • 其他未在资料中说明的限制暂未提供。