mcpField
C
creating-oracle-to-postgres-migration-bug-report

creating-oracle-to-postgres-migration-bug-report

github.com/github测试与质量40.5k1.8k 次安装今天更新
代码仓库

关于 creating-oracle-to-postgres-migration-bug-report

用于记录和审查 Oracle 与 PostgreSQL 行为差异所致缺陷的写作技能,提供涵盖复现步骤、根因、解决方案和验证过程的报告结构。

主要功能

  1. 01使用标准化缺陷报告模板
  2. 02对比预期与实际行为
  3. 03记录可复现的场景
  4. 04说明数据库行为差异根因
  5. 05记录修复和验证步骤

适用场景

  1. 01报告数据库迁移相关缺陷
  2. 02审查 Oracle 到 PostgreSQL 的缺陷报告
  3. 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