← Radar adatlapja
AgentRadar

Skill · 1.0.0 verzió

Kompatibilitást törő változások kutatása

Kiadási előzményekből és interfészkülönbségekből konkrét migrációs hatástérképet készít a kódodhoz.

migration-breaking-change-intelligence

Nézd meg, miben segít

Mikor hasznos?

Ismeretlen verziókon át történő könyvtárfrissítés előtt használd.

Miben segít neked?

  • Feltérképezi a tervezett verziótartomány minden kiadási határát.
  • Vizsgálja a módosult exportokat, típusokat és konfigurációs szerződéseket.
  • A jelentett regressziókat a projekt tényleges használatához kapcsolja.

Például ezt kérheted

Kutasd ki a frissítést, felsorolva az érintett importot, szükséges igazítást és nyitott külső hibát. Minden törő változást rendelj valós hívási helyhez. A nem érintő upstream módosítás különüljön el, az érintett működéshez pedig adj kis ellenőrzést.

Részletes dokumentáció

Itt a skill eredeti útmutatóját, példáit és ellenőrzési szempontjait olvashatod az eredeti nyelven.

Részletek…Összecsukás

Migration & Breaking-Change Intelligence

Changelogs frequently omit subtle behavioral changes—altered default timeouts, stricter validation, changed error classes, or modified return semantics. When researching an upgrade or comparing versions, combine release notes with direct commit/diff inspection.

Workflow

  1. Map the version span and release history:
    • Identify the exact current version (vFrom) and target version (vTo), plus all intermediate major and minor releases.
    • Read CHANGELOG.md, GitHub Releases, and official migration guides across every intermediate major version (e.g., upgrading v2 -> v5 requires checking v3, v4, and v5 breaking notes).
  2. Inspect diffs on public entry points and types:
    • Compare exported TypeScript definitions (.d.ts), public classes/functions, and configuration schemas between vFrom and vTo.
    • Check for:
      • Removed or renamed exports, methods, and options.
      • Changed default values (e.g., retry: true -> false, timeout: 0 -> 30000, strict: false -> true).
      • Sync-to-async signature changes or Node/runtime minimum version bumps (engines field).
  3. Search post-release issues for regression reports:
    • Check issues opened shortly after vTo shipped. Early adopters often report undocumented breaking changes, memory regressions, or bundler incompatibilities before docs are updated.
  4. Produce a concrete migration impact map:
    • Cross-reference every upstream breaking change against our codebase's actual call sites (grep / AST search).
    • Classify each impact as:
      • Zero-impact: Affects APIs we do not call.
      • Mechanical codemod: Simple rename or signature adjustment across $N$ call sites.
      • Behavioral / semantic shift: Requires adapter changes, config pinning, or new regression tests.
    • Hand off the verified impact map to the dependency upgrade specialist or implementing developer.

Csomagban lévő fájlok 1

  • SKILL.md