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

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

github.com/githubTesting & quality40.5k1.8k installsUpdated today
Repository

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

A writing skill for documenting and reviewing defects caused by Oracle-to-PostgreSQL behavioral differences. It provides a report structure covering reproduction, root cause, solution, and validation.

Key features

  1. 01Use a standardized bug report template
  2. 02Compare expected and observed behavior
  3. 03Document reproducible scenarios
  4. 04Explain database-specific root causes
  5. 05Record fixes and validation steps

Use cases

  1. 01Report a migration-related database defect
  2. 02Review an Oracle-to-PostgreSQL bug report
  3. 03Document test steps for a database fix

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/github/awesome-copilot --skill creating-oracle-to-postgres-migration-bug-report

After installing, type/creating-oracle-to-postgres-migration-bug-reportin Claude Code to confirm it loaded.

Bundled filesreferences/BUG-REPORT-TEMPLATE.md

Details

From the project README

Creating Bug Reports for Oracle-to-PostgreSQL Migration

When to Use

  • Documenting a defect caused by behavioral differences between Oracle and PostgreSQL
  • Writing or reviewing a bug report for an Oracle-to-PostgreSQL migration project

Bug Report Format

Use the template in references/BUG-REPORT-TEMPLATE.md. Each report must include:

  • Status: ✅ RESOLVED, ⛔ UNRESOLVED, or ⏳ IN PROGRESS
  • Component: Affected endpoint, repository, or stored procedure
  • Test: Related automated test names
  • Severity: Low / Medium / High / Critical — based on impact scope
  • Problem: Expected Oracle behavior vs. observed PostgreSQL behavior
  • Scenario: Ordered reproduction steps with seed data, operation, expected result, and actual result
  • Root Cause: The specific Oracle/PostgreSQL behavioral difference causing the defect
  • Solution: Changes made or required, with explicit file paths
  • Validation: Steps to confirm the fix on both databases

Oracle-to-PostgreSQL Guidance

  • Oracle is the source of truth — frame expected behavior from the Oracle baseline
  • Call out data layer nuances explicitly: empty string vs. NULL, type coercion strictness, collation, sequence values, time zones, padding, constraints
  • Client code changes should be avoided unless required for correct behavior; when proposed, document and justify them clearly

Writing Style

  • Plain language, short sentences, clear next actions
  • Present or past tense consistently
  • Bullets and numbered lists for steps and validations
  • Minimal SQL excerpts and logs as evidence; omit sensitive data and keep snippets reproducible
  • Stick to existing runtime/language versions; avoid speculative fixes

Filename Convention

Save bug reports to .github/oracle-to-postgres-migration/Reports/{ProjectName}/BUG_REPORT_<DescriptiveSlug>.md where:

  • {ProjectName} is the project's assembly/folder name with spaces normalized to - (e.g. MyApp.DataAccess)
  • <DescriptiveSlug> is a short PascalCase identifier describing the defect (e.g., EmptyStringNullHandling, RefCursorUnwrapFailure)

Comments

Markdown supported