Przejdź do treści
Biblioteka skilli
Programowanie · Konwersja i formaty

upgrade-agent-native

/upgrade-agent-native

Doprowadza starszą aplikację lub przestrzeń Agent-Native do aktualnej wersji, naprawia nieudane aktualizacje i odradza łatanie rdzenia.

Repozytorium
agent-native ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Doprowadza starszą aplikację lub przestrzeń Agent-Native do aktualnej wersji, naprawia nieudane aktualizacje i odradza łatanie rdzenia.

Oryginalny opis (EN)

Bring an older Agent-Native app or workspace current. Use when updating @agent-native/core, fixing a broken upgrade, or when tempted to patch or override core/dispatch packages to make an old branch run.

Jak działa

  1. Rule
  2. Why
  3. How
  4. Don't
  5. Related Skills
Sekcje z nagłówków SKILL.md, w oryginale · 78 linii, 337 słów
Podgląd SKILL.md
---
name: upgrade-agent-native
description: >-
  Bring an older Agent-Native app or workspace current. Use when updating
  @agent-native/core, fixing a broken upgrade, or when tempted to patch or
  override core/dispatch packages to make an old branch run.
scope: dev
metadata:
  internal: true
---

# Upgrade Agent-Native

## Rule

When an older Agent-Native app/branch needs to run on current packages, use
`agent-native upgrade`. Never "fix" upgrade breakage with
`pnpm.overrides`, `patchedDependencies`, `resolutions`, local patches, or
edits under `node_modules/@agent-native/*` — especially not against
`@agent-native/core` or `@agent-native/dispatch`.

## Why

Agents often respond to a failed core bump by inventing framework patches and
dispatch behavior overrides. That hides the real app-level break, drifts from
upstream, and makes the next upgrade worse. The supported path is bump →
install → refresh scaffold skills → verify, then fix **app** code only.

## How

1. **Doctor first (optional but recommended)**

   ```bash
   npx @agent-native/core@latest upgrade check
   ```

   This reports framework overrides/patches and pending `@agent-native/*`
   bumps. If overrides/patches are present, remove them before continuing.

2. **Run the upgrade**

   ```bash
   npx @agent-native/core@latest upgrade
   ```

   Or from an already-installed CLI: `pnpm exec agent-native upgrade` /
   `agent-native upgrade`.

   What it does:

   - Blocks (unless `--force`) when `@agent-native/*` overrides/patches exist
   - Rewrites non-local `@agent-native/*` dependency pins to `latest`
   - Runs the package manager install
   - Runs `skills update scaffold --project`
   - Runs `typecheck` when the project has that script

3. **If upgrade or typecheck fails**

   - Read the concrete error
   - Fix **app** source, actions, config, or env — not framework packages
   - Re-run `agent-native upgrade` or `pnpm typecheck`
   - Stop and ask the user if you cannot fix the app-level error

4. **Dry-run / partial runs**

   ```bash
   agent-native upgrade --dry-run
   agent-native upgrade --skip-verify
   agent-native upgrade --skip-install   # package.json bumps only
   ```

## Don't

- Don't add `pnpm.overrides`, `overrides`, `resolutions`, or
  `patchedDependencies` for any `@agent-native/*` package
- Don't edit `node_modules/@agent-native/core` or
  `node_modules/@agent-native/dispatch`
- Don't invent local "dispatch behavior" shims to paper over version skew
- Don't keep iterating with more framework patches after a failed install
- Don't skip `skills update scaffold --project` after a core bump (the
  upgrade command does this for you)

## Related Skills

- **self-modifying-code** — Tier 4: framework packages are off limits
- **agent-native-docs** — version-matched docs after the bump
- **portability** — keep app code provider-agnostic across upgrades

Wersje

RepozytoriumWynikLicencja
Ta strona · builderio/agent-native100MIT
builderio/agent-native100MIT

Migawka bazy z 13.11.2026 · wersja paczki a56b0c2fc269 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100multi-app-workspace
    Opisuje, jak zbudować lub rozszerzyć wieloaplikacyjną przestrzeń roboczą Agent-Native: kształt monorepo, płaszczyzna sterowania Dispatch, aplikacja-powłoka i wspólny pakiet.
  • 100update
    Doprowadza cały projekt do najnowszych wersji narzędzi i pakietów, pyta tylko o decyzje i kończy pull requestem.
  • 100upgrade-react-native
    Prowadzi podnoszenie react-native do nowszej wersji, obejmując zmiany w projektach natywnych Android i iOS oraz łamiące zmiany.
  • 100koan-upgrade
    Audytuje, planuje i migruje starszą aplikację Koan do bieżącej wersji, zachowując obserwowalne kontrakty i zatrzymując się, gdy nie da się wykazać zamiennika.
  • 100upgrades
    Podnosi React Native, włącza New Architecture i utrzymuje w zgodzie natywne zależności, przy aktualizacji modułów natywnych.
  • 100react-native-web-core
    Obejmuje podstawy React Native Web: koncepcje, komponenty i wzorce wieloplatformowe przy budowie aplikacji webowych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.