Přeskočit na obsah

/schema-change — Změna datového kontraktu

Změna datového kontraktu: Provede změnu kanonického schématu se všemi třinácti místy, která z ní plynou: schéma, existující data, view modely, šablony, exporty, JSON-LD kontext, validátory, testy, golden snapshot, migrace, datový kontrakt, vzdělávací vrstva a SEO konfigurace. Claude skill, provoz.

Claude skill provoz

Volání

/schema-change

Argumenty: "<typ záznamu> <co se mění>"

Zdroj: .claude/skills/schema-change/SKILL.md

Provede změnu kanonického schématu se všemi třinácti místy, která z ní plynou: schéma, existující data, view modely, šablony, exporty, JSON-LD kontext, validátory, testy, golden snapshot, migrace, datový kontrakt, vzdělávací vrstva a SEO konfigurace. U každého řádku vyžaduje buď „hotovo“, nebo explicitní „netýká se, protože“.

Kdy ho spustit

Při přidání, přejmenování nebo odebrání pole v typu záznamu, a při změně enumu, povinnosti nebo formátu.

Pro koho a s jakým rizikem

  • Persona: vývojář, údržbář
  • Riziko: údržbář
  • Zapisuje do souborů: ano

Co vynucuje

Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.

Co je potřeba vědět

  • Poloviční implementace pole je selhání, ne rozpracovanost — a brána ho nemusí odhalit v obou směrech.
  • Nejpodceňovanější kroky jsou existující data a migrace. Povinné pole bez migrace shodí build na každém existujícím záznamu, což je správně, ale musí to být plán, ne překvapení.
  • Nejlevnější pole je to, které nevzniklo. Hloubka v grafu se počítá, ne ukládá — a to je vzor, ne výjimka.
  • Skóre důvěryhodnosti jako pole skill odmítá: hodnotilo by pravdu, ne doloženost, a truth-rating značky verify:jsonld zakazuje.

Jak se skill popisuje sám

Provede změnu kanonického schématu se všemi místy, která z ní plynou — schéma, existující data, generátory, view modely, šablony, exporty, JSON-LD, validátory, testy, migrace a dokumentace. Použij ho při přidání, přejmenování nebo odebrání pole v záznamu, nebo když někdo řekne „chci u zdroje evidovat i X".

Doslovný text z .claude/skills/schema-change/SKILL.md.

Vstupy a výstupy

Zapisuje

  • schemas/canonical/**
  • scripts/data/build-view-models.mjs
  • templates/**
  • migrace

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.