1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | db-oracle-skills |
| 项目自述名称 | Oracle Database Skills（隶属 “Oracle Skills” 合集，见下方说明） |
| 作者/维护者 | Oracle（官方组织账号 oracle） |
| 来源链接 | https://github.com/oracle/skills/tree/main/db |
| 许可证 | Universal Permissive License v1.0（UPL-1.0），来自 GitHub API，根目录 LICENSE.txt 原文确认 |
| GitHub Stars / Forks | 760 / 203（合集仓库 oracle/skills 整体数字，覆盖 db/oci/apex/fusion/graal 五个域；不代表 db 本域自身热度，见第 6 章说明） |
| 最新版本 | 无固定版本号，滚动更新（最近一次提交 2026-07-17） |
| 安装方式 | Claude Code 插件市场 / 通用 Agent Skills 安装器（npx skills add），见第 10 章 |
2. 功能介绍与亮点
db-oracle-skills 是 Oracle 官方“Oracle Skills”合集仓库中的数据库域，为 SQL 编写、PL/SQL 开发、性能调优、安全、迁移、ORDS/SQLcl 使用以及“agent 安全操作数据库”提供成体系的参考指南。核心亮点：
- 按主题分域路由：admin、agent、appdev、architecture、backup-recovery、containers、design、devops、features、frameworks、migrations、monitoring、ords、performance、plsql、security、sql-dev、sqlcl 共 18 个子目录，SKILL.md 提供路由表，agent 按需只读所需主题文件
- agent 安全操作护栏：
db/agent/收录 destructive-op-guards（DROP/TRUNCATE/DELETE 前的依赖、锁、外键检查 SQL 范例）、safe-dml-patterns、idempotency-patterns、schema-discovery 等文档，专门应对“agent 直接操作生产数据库”的高风险场景 - 覆盖面广：从基础 SQL/PL/SQL 到 RAC、Multitenant、Data Guard 等企业级架构，从主流 ORM 框架适配到 PostgreSQL/MySQL/SQL Server/MongoDB/Snowflake 迁移指南均有收录
- 纯文档、零脚本：db 域全部 182 个文件中 163 个为 Markdown，不含任何可执行脚本
- 多贡献者活跃维护：仓库 2026-03 创建，116 次提交中 17 次涉及 db 路径；56 个 issue/PR 来自多位不同署名贡献者，非单人维护
3. 适用场景
固定分类：工程效率与代码质量
适用于日常需要编写、审查、调试或调优 SQL/PL/SQL 的开发者，需要用 agent 安全执行数据库变更（避免误删表、误删数据）的 DBA 或运维人员，以及需要将应用从 PostgreSQL/MySQL/SQL Server/MongoDB 等迁移到 Oracle Database 的团队。
4. 跨 Agent 兼容性
db-oracle-skills 是标准 Agent Skills 格式（YAML front matter + Markdown 正文），无 Claude Code 专属特性（不依赖 hooks、context: fork 等）。仓库同时提供两种安装路径：
- Claude Code：✅ 原生支持——仓库自带
.claude-plugin/marketplace.json，可通过/plugin marketplace add oracle/skills直接注册并安装 db 插件 - Codex：✅ 支持——通用安装器
vercel-labs/skills（npx skills add）官方文档明确列出 Codex 为受支持 agent 之一，可直接拉取本仓库任意子目录安装 - OpenClaw：✅ 支持——同一安装器文档明确列出 OpenClaw 及其技能目录路径
- Hermes Agent：✅ 支持——同一安装器文档明确列出 Hermes Agent 及其技能目录路径
以上判断依据：db 域内容为纯 Markdown 指南，不使用任何 Claude Code 独有能力，通用安装器的“基础技能安装”能力覆盖全部四个目标 agent。
5. 推荐理由
这是一款专门针对 Oracle Database（区别于 PostgreSQL/ClickHouse/Neon 等开源数据库生态）的官方技能，覆盖企业级场景常见的 SQL 调优、安全审计、迁移与 agent 安全操作护栏，且由 Oracle 官方多人团队持续维护，内容零代码执行、纯文档形态，风险面很小。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | Oracle 为一线企业软件厂商官方出品；合集仓库整体 760 stars，db 域自身在 116 次总提交中占 17 次、56 个 issue/PR 来自多位具名贡献者，为该域自身活跃度的独立证据（整体 star 数不直接计入本域） |
| 可用性 | 9 | SKILL.md 路由表清晰、按主题拆分便于按需阅读；提供 Claude Code 插件市场与通用安装器两条安装路径；最近一次提交为 2026-07-17，维护活跃；技能本身不依赖付费 API |
| 安全性 | 9 | db 域 182 个文件中零可执行脚本，纯 Markdown 指南；db/agent/ 专门提供 DROP/DELETE 等破坏性操作的前置检查 SQL 护栏；License（UPL-1.0）明确；官方组织账号、多人协作，无刷星或误导性描述迹象 |
综合评分（三项均值）：9.0
安全检查清单逐项： ① Shell 命令：不涉及，db 域不含任何脚本文件，仅提供 SQL 范例供 agent 参考执行 ② 联网外发：无，纯静态文档 ③ API key：技能本身不要求，实际连接 Oracle Database 所需的凭据由用户自行管理（数据库技能的通用做法） ④ 可疑指令：未发现 ⑤ 作者信誉：Oracle 官方组织账号，多位具名贡献者 ⑥ License：UPL-1.0，OSI 认可的宽松许可证，根目录 LICENSE.txt 原文确认 ⑦ 维护时间：最近一次提交为 2026-07-17，近日持续活跃
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 db-oracle-skills 的差异 |
|---|---|---|
| neon-postgres-neondatabase-agent-skills | Neon（Serverless Postgres）官方技能 | 面向云原生 Postgres 的分支/无服务器特性，不覆盖 Oracle 专属的 PL/SQL、RAC、Data Guard 等企业级能力 |
| chdb-sql-clickhouse-agent-skills | ClickHouse 嵌入式引擎 chdb 的 SQL 技能 | 聚焦 OLAP 分析型查询，不涉及 Oracle 事务型数据库的安全/迁移/agent 护栏场景 |
| postgres-timescale-pg-aiguide | TimescaleDB（时序 Postgres 扩展）指南 | 专注时序数据场景，与 Oracle 通用企业数据库运维/开发范围不重叠 |
| database-skills（通用数据库技能） | 跨数据库通用规范 | 不含 Oracle 专属语法（PL/SQL）、专属工具（SQLcl/ORDS）与 Oracle 特有架构（RAC/Multitenant）指导 |
Oracle Database 在银行、电信、政务等场景仍是主力数据库，市面上专门针对 Oracle 语法与运维体系（PL/SQL、SQLcl、RAC、Data Guard 等）的官方技能较为少见，多数同类技能集中在 PostgreSQL/ClickHouse 等开源数据库生态。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；GitHub issue 区已有多位具名开发者（如 loiclefevre、ppskannan）就具体技术细节（JSON 约束兼容性、ORDS 原生 JSON 优先级等）提出过反馈并被采纳修复，反映内容处于持续打磨状态。
9. 其他补充
“Oracle Skills” 合集仓库同时还收录 oci（Oracle Cloud Infrastructure）、apex（Oracle APEX）、graal（GraalVM Native Image）三个已有实质内容的域，以及 fusion（预留位，尚无内容）；有 Oracle 云基础设施或 GraalVM 相关需求的用户可按需单独安装对应域。
10. 安装使用方式
方式一：Claude Code 插件市场
/plugin marketplace add oracle/skills
/plugin install db@oracle-skills方式二：通用 Agent Skills 安装器（支持 Claude Code / Codex / OpenClaw / Hermes 等）
npx skills add oracle/skills/db安装后无需重启，agent 会按需读取 db/SKILL.md 中的路由表并跳转到具体主题文件；无需额外配置 API key（实际连接数据库所需的连接串/凭据由用户在自己的环境中管理）。
11. 注意事项
- fusion、apex 两个域目前内容较少（apex 已有 APEXlang 路由与运行时错误目录；fusion 仍为预留占位），若需求集中在这两个方向可先评估内容成熟度
- 该仓库为持续滚动更新，无版本号标记，无法通过版本号判断变更幅度，需关注 CHANGELOG 或提交历史
- 使用 agent 安全护栏文档并不能完全替代生产环境的常规审批流程，重要变更仍建议人工复核