1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Reviewing_Oracle_To_Postgres_Migration_Github_Awesome_Copilot |
| 作者/维护者 | GitHub（github/awesome-copilot 官方合集仓库，社区贡献并经官方审核合并；原始贡献者 PrimedPaul） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/reviewing-oracle-to-postgres-migration |
| 许可证 | MIT（仓库根目录明确声明，来自 GitHub API） |
| GitHub Stars | 38,967（合集仓库整体，来自 GitHub API；不代表本技能自身热度，见第 2 章说明） |
| Forks | 4,941（合集仓库整体，来自 GitHub API） |
| 最新版本 | 该子目录最近一次实质性内容更新于 2026-07-14，最近一次打包更新于 2026-08-11（均来自 GitHub API commits 记录） |
| 安装方式 | 复制该子目录到 agent 的 skills 目录，或通过 Copilot 插件市场安装 |
2. 功能介绍与亮点
本技能是一份 Oracle→PostgreSQL 数据库迁移的风险核对清单，把 15 份、共计约 60KB 的参考文档（references/ 目录）编织成一套可在迁移前后两个阶段复用的排查流程，覆盖空字符串语义、REF CURSOR 处理、类型强制转换、排序与字符集、UNION ALL 执行计划、物化视图刷新、时间戳时区、并发事务等 Oracle 与 PostgreSQL 之间已知的行为差异点。
核心能力：
- 两套流程共用一份知识库：迁移前用“风险评估流程”逐条核对参考索引里哪些差异点适用于本次改造范围；迁移后用“验证流程”反向核对每条适用差异是否已被处理、集成测试是否覆盖了对应场景。
- 索引优先、按需展开：先读
references/REFERENCE.md的索引判断相关性，只在确认适用时才展开对应的详细参考文件，避免每次都要通读全部 15 份文档。 - 收口动作明确：流程终点是输出一份“哪些差异点已核对、哪些仍需人工决策”的清单，而不是停留在“提醒你注意”的模糊建议。
- 纯知识性技能，不改代码、不执行命令：本技能本身只做只读分析与报告生成，实际的代码迁移由同一合集里的其他姊妹技能（如迁移存储过程、迁移数据访问层代码）承担，二者可配合但互不依赖。
主要亮点：官方合集仓库审核收录、参考文档体量与技术细节明显厚于同类“迁移提醒”型技能（如时间戳时区一项单独写了约 8.6KB、并发事务约 9.6KB）、纯文本零依赖零外联、近 2 个月内有实质性维护。
3. 适用场景
所属分类：工程效率与代码质量（核心产出是围绕一次具体的代码/数据库迁移给出风险核对与验证结论，直接服务于迁移改造这件“写代码”的正确性）。
具体使用场景：
- 团队计划把 .NET 应用的数据层从 Oracle 迁移到 PostgreSQL，在动手改造存储过程或数据访问代码之前，先用它排查哪些已知行为差异会踩坑；
- 迁移工作完成后，用它做一次收口验证，确认每条适用的行为差异都已被处理、且集成测试覆盖了对应的边界场景；
- 排查迁移后出现的诡异行为（如排序结果不一致、
UNION ALL查询变慢、REF CURSOR 消费异常）时，先查参考索引里是否已有现成的已知原因与修复模式。
受益人群：负责 Oracle 到 PostgreSQL 数据库迁移的后端开发者与 DBA，尤其是缺乏两种数据库行为差异经验、容易把“能编译”误当成“迁移正确”的初中级开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md（YAML frontmatter + Markdown 正文 + references 目录），无外部依赖、无网络请求、无代码执行，符合 Agent Skills 通用规范 |
| Codex | 原生支持 | 纯文本参考与流程指导技能，不涉及联网或系统调用，不受沙箱断网限制 |
| OpenClaw | 未验证 | 未找到该平台的直接安装记录，但技能本身不含平台专有语法，理论上可直接迁移 |
| Hermes Agent | 未验证 | 同上，未找到具体验证来源 |
5. 推荐理由
数据库迁移类技能常见的问题是“提醒你要小心”却给不出可核查的具体清单，本技能反其道而行——把 Oracle/PostgreSQL 之间已知的行为差异逐条写成独立参考文件，再配一套“迁移前排查、迁移后验证”两阶段流程，让 agent 在改代码前后都能对着同一份知识库做机械核对，而不是凭经验猜哪里可能出问题。技能本身零执行权限、零外部依赖，装上即可用，适合任何一支正在或计划把 .NET 应用从 Oracle 搬到 PostgreSQL 的团队。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 GitHub 官方审核合并收录进其官方维护的合集仓库；该子技能自身暂无独立于合集整体的第三方热度证据（未查到具名评价或独立报道，仅有仓库自身的自动化资源核查机器人记录） |
| 可用性 | 9 | 复制即用、零配置、零付费依赖；参考文档体量大且逐条聚焦具体行为差异，不依赖其他姊妹技能已产出的中间文件即可独立使用；最近一次实质性维护在 2 个月内 |
| 安全性 | 9 | 纯文本参考与分析流程，不含任何可执行代码或脚本，不联网、不写入文件、不要求任何凭据 |
安全检查清单逐项结果：① 不执行任何 shell 命令，纯文本分析 ② 不联网、无数据外发 ③ 不要求任何 API key 或凭据 ④ 正文未发现可疑指令或注入迹象 ⑤ 官方合集仓库审核收录，作者信誉良好 ⑥ License 明确（MIT）⑦ 最近一次维护在 2 个月内，处于活跃状态。
综合评分（三项均值）：8.33
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| migrating-oracle-to-postgres-stored-procedures（同仓库） | 把 Oracle PL/SQL 存储过程逐条翻译为 PostgreSQL PL/pgSQL | 是“动手改代码”的执行者，依赖已导出的 DDL 目录结构才能工作；本技能是“事前事后都能用”的风险核对者，不依赖特定项目结构 |
| creating-oracle-to-postgres-master-migration-plan（同仓库） | 扫描 .NET 解决方案、给出项目级迁移优先级清单 | 解决的是“先迁哪个项目”的宏观规划问题；本技能解决的是“迁移过程中会踩哪些具体的数据库行为坑”，二者是迁移流程里不同阶段的工具，可配合使用 |
| db-oracle-skills（Oracle 官方出品） | 面向仍在使用 Oracle 数据库本身的 SQL 调优与安全审计 | 服务对象是“继续用 Oracle”的团队；本技能服务的是“正在把 Oracle 换成 PostgreSQL”的团队，场景方向相反，无功能重叠 |
核心差异化：市面上常见的“数据库迁移助手”多集中在语法翻译（把 A 数据库的写法转成 B 数据库的写法），容易忽略两者之间“语法能编译但行为不一致”的隐性差异；本技能专门把这类隐性差异整理成可核查清单，填补了“翻译对了但没验证语义等价”这一环。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，GitHub 仓库内也未见针对该技能的独立 issue 或 PR 讨论（仅有仓库自身运行的自动化资源过期核查机器人留下的记录）。
9. 其他补充
同仓库还配套一份完整的 Oracle→PostgreSQL 迁移技能族（含项目发现分类、测试计划、测试脚手架、数据访问代码迁移、存储过程迁移、bug 报告生成等），本技能是其中负责“风险核对与验证”这一环的独立组件，也可单独使用而不依赖其余组件。
10. 安装使用方式
方式一：直接复制
将 skills/reviewing-oracle-to-postgres-migration/ 整个目录（含 SKILL.md 与 references/ 子目录）复制到你的 agent 的 skills 目录下（如 Claude Code 的 .claude/skills/reviewing-oracle-to-postgres-migration/）。
方式二：通过 Copilot 插件市场（适用于 GitHub Copilot CLI/VS Code 用户）：
copilot plugin marketplace add github/awesome-copilot
copilot plugin install reviewing-oracle-to-postgres-migration@awesome-copilot安装后无需重启，在对话中提出“帮我核查这次 Oracle 迁移到 PostgreSQL 有哪些行为差异风险”或“验证一下这段迁移代码是否覆盖了已知的 Oracle/PostgreSQL 差异”即可触发；技能本身不需要任何额外配置或密钥。
11. 注意事项
- 本技能只做风险核对与验证，不会自动生成迁移代码——实际的存储过程翻译、数据访问代码改造需要配合同仓库的其他迁移技能或人工完成；
- 参考文档聚焦的是已知的通用行为差异模式，无法覆盖所有业务特定的数据语义差异，复杂业务逻辑仍需人工评审；
- 技能面向的场景相对窄（.NET + Oracle + PostgreSQL 的具体迁移项目），若团队使用其他技术栈迁移数据库，需自行评估参考文档的适用程度。