用途
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> |
步骤(按顺序执行):
- 检查 git:
git --version,缺失则用平台包管理器安装 - 检查 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 - 其他:使用平台包管理器
- macOS:
- 检查 gh auth:
gh auth status,未认证则运行gh auth login并引导用户完成 - 检查 ghq:
ghq --version,缺失则安装:- macOS:
brew install ghq - Linux/Windows:
go install github.com/x-motemen/ghq@latest(需 Go),或从 GitHub releases 下载二进制
- macOS:
- 检查 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 等外部工具,需先行准备
- 其他未在资料中说明的限制暂未提供。