关于 creating-oracle-to-postgres-migration-bug-report
用于记录和审查 Oracle 与 PostgreSQL 行为差异所致缺陷的写作技能,提供涵盖复现步骤、根因、解决方案和验证过程的报告结构。
主要功能
- 01使用标准化缺陷报告模板
- 02对比预期与实际行为
- 03记录可复现的场景
- 04说明数据库行为差异根因
- 05记录修复和验证步骤
适用场景
- 01报告数据库迁移相关缺陷
- 02审查 Oracle 到 PostgreSQL 的缺陷报告
- 03记录数据库修复的测试步骤
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ github/ awesome-copilot --skill creating-oracle-to-postgres-migration-bug-report安装后在 Claude Code 中输入/creating-oracle-to-postgres-migration-bug-report确认已加载。
附带文件references/BUG-REPORT-TEMPLATE.md
详细介绍
为 Oracle 到 PostgreSQL 迁移创建 Bug 报告
何时使用
- 记录由 Oracle 与 PostgreSQL 之间的行为差异导致的缺陷
- 为 Oracle 到 PostgreSQL 迁移项目撰写或审阅 bug 报告
Bug 报告格式
使用 references/BUG-REPORT-TEMPLATE.md 中的模板。每份报告必须包含:
- 状态:✅ RESOLVED、⛔ UNRESOLVED 或 ⏳ IN PROGRESS
- 组件:受影响的端点、仓储或存储过程
- 测试:相关的自动化测试名称
- 严重程度:Low / Medium / High / Critical — 基于影响范围
- 问题:预期的 Oracle 行为与观察到的 PostgreSQL 行为
- 场景:有序的复现步骤,包含种子数据、操作、预期结果和实际结果
- 根本原因:导致该缺陷的具体 Oracle/PostgreSQL 行为差异
- 解决方案:已做或需要做的更改,并明确给出文件路径
- 验证:在两个数据库上确认修复的步骤
Oracle 到 PostgreSQL 指南
- Oracle 是事实来源 — 以 Oracle 基线来界定预期行为
- 明确指数据层的细微差别:空字符串与 NULL、类型强制转换的严格性、排序规则、序列值、时区、填充、约束
- 除非为实现正确行为所必需,否则应避免修改客户端代码;若提议修改,须清晰记录并说明理由
写作风格
- 语言平实,句子简短,后续动作明确
- 一致地使用现在时或过去时
- 步骤和验证使用项目符号和编号列表
- 用最少的 SQL 片段和日志作为证据;省略敏感数据并保持片段可复现
- 坚持使用现有的运行时/语言版本;避免推测性的修复
文件名约定
将 bug 报告保存到 .github/oracle-to-postgres-migration/Reports/{ProjectName}/BUG_REPORT_<DescriptiveSlug>.md,其中:
{ProjectName}是项目的程序集/文件夹名称,空格规范化为-(例如MyApp.DataAccess)<DescriptiveSlug>是描述该缺陷的简短 PascalCase 标识符(例如EmptyStringNullHandling、RefCursorUnwrapFailure)
评论
支持 Markdown