$npx -y skills add github/awesome-copilot --skill creating-oracle-to-postgres-migration-bug-reportCreates structured bug reports for defects found during Oracle-to-PostgreSQL migration. Use when documenting behavioral differences between Oracle and PostgreSQL as actionable bug reports with severity, root cause, and remediation steps.
| 1 | # Creating Bug Reports for Oracle-to-PostgreSQL Migration |
| 2 | |
| 3 | ## When to Use |
| 4 | |
| 5 | - Documenting a defect caused by behavioral differences between Oracle and PostgreSQL |
| 6 | - Writing or reviewing a bug report for an Oracle-to-PostgreSQL migration project |
| 7 | |
| 8 | ## Bug Report Format |
| 9 | |
| 10 | Use the template in [references/BUG-REPORT-TEMPLATE.md](references/BUG-REPORT-TEMPLATE.md). Each report must include: |
| 11 | |
| 12 | - **Status**: ✅ RESOLVED, ⛔ UNRESOLVED, or ⏳ IN PROGRESS |
| 13 | - **Component**: Affected endpoint, repository, or stored procedure |
| 14 | - **Test**: Related automated test names |
| 15 | - **Severity**: Low / Medium / High / Critical — based on impact scope |
| 16 | - **Problem**: Expected Oracle behavior vs. observed PostgreSQL behavior |
| 17 | - **Scenario**: Ordered reproduction steps with seed data, operation, expected result, and actual result |
| 18 | - **Root Cause**: The specific Oracle/PostgreSQL behavioral difference causing the defect |
| 19 | - **Solution**: Changes made or required, with explicit file paths |
| 20 | - **Validation**: Steps to confirm the fix on both databases |
| 21 | |
| 22 | ## Oracle-to-PostgreSQL Guidance |
| 23 | |
| 24 | - **Oracle is the source of truth** — frame expected behavior from the Oracle baseline |
| 25 | - Call out data layer nuances explicitly: empty string vs. NULL, type coercion strictness, collation, sequence values, time zones, padding, constraints |
| 26 | - Client code changes should be avoided unless required for correct behavior; when proposed, document and justify them clearly |
| 27 | |
| 28 | ## Writing Style |
| 29 | |
| 30 | - Plain language, short sentences, clear next actions |
| 31 | - Present or past tense consistently |
| 32 | - Bullets and numbered lists for steps and validations |
| 33 | - Minimal SQL excerpts and logs as evidence; omit sensitive data and keep snippets reproducible |
| 34 | - Stick to existing runtime/language versions; avoid speculative fixes |
| 35 | |
| 36 | ## Filename Convention |
| 37 | |
| 38 | Save bug reports as `BUG_REPORT_<DescriptiveSlug>.md` where `<DescriptiveSlug>` is a short PascalCase identifier (e.g., `EmptyStringNullHandling`, `RefCursorUnwrapFailure`). |