Menu
Přihlásit
Návod Vibe coding

Dependabot pro agent skills: verzování přes APM

Dependabot pro agent skills hlídá verze v apm.yml. Návod na APM, lockfile, nastavení dependabot.yml a bezpečné review pull requestů se skills.

Aktualizováno Publikováno 7 min čtení 4 kroky

Obsah článku 10 sekcí

V kostce

  • Od 3. 11. 2026 umí Dependabot v GitHubu aktualizovat závislosti v apm.yml, tedy skills, prompty a instrukce spravované přes APM.
  • Aktualizace pokrývá tagy, úplná SHA a větve; lockfile apm.lock.yaml přegeneruje jen tehdy, když už existuje.
  • Dependabot nedělá bezpečnostní aktualizace a nechává beze změny MCP servery, lokální cesty, nepřipnuté položky a zkrácená SHA.
  • Pull request se skills čti jako změnu kódu: projdi diff SKILL.md, nové skripty a oprávnění, merge nenech automaticky.
Dependabot pro agent skills: verzování přes APM - ilustrační obrázek

Dependabot pro agent skills je od 3. listopadu 2026 realita: GitHub ho naučil aktualizovat závislosti v souboru apm.yml, tedy skills, prompty a instrukce pro AI agenty, které spravuje Agent Package Manager (APM). Dosud sis skill zkopíroval do repozitáře a za půl roku nevěděl, jestli autor mezitím něco opravil, nebo rozbil. Teď ti na novou verzi přijde pull request jako u každé jiné knihovny.

V tomhle návodu si ukážeme, co APM je, jak do něj převést skills, které máš rozházené po projektech, jak zapneš Dependabota a hlavně kde jsou jeho meze. Zdroje jsem ověřil v oznámení GitHub Changelogu z 3. 11. 2026 a v dokumentaci APM.

Balíčky s verzemi a robotická ruka, která vyměňuje starou verzi za novou

Proč verzovat skills stejně jako knihovny

Skill není dekorace. Je to text, který agentovi říká, jak má dělat code review, psát testy nebo nasazovat. Když se změní, změní se chování agenta, přestože v aplikačním kódu nepřibyl jediný řádek. Přesně tohle se při kopírování souborů mezi repozitáři ztrácí.

Typické bolesti, které řeší správa závislostí:

  • Drift: stejný skill ve třech repozitářích, každý trochu jiný.
  • Žádná historie: nevíš, kdy a proč se instrukce změnila.
  • Ruční aktualizace: upstream skill se zlepšil, ale nikdo si toho nevšiml.
  • Reprodukovatelnost: kolega po git clone dostane jiné chování agenta než ty.

Pokud skills teprve zavádíš, začni u článků Claude Skills návod: vlastní dovednosti agenta a Subagenti vs skills. Tady už předpokládám, že skills máš a chceš je udržovat.

Co je Agent Package Manager (APM)

APM je open-source správce závislostí pro konfiguraci AI agentů. Vyvíjí ho organizace Microsoft na GitHubu a běží pod licencí MIT. Podle dokumentace umí nasadit balíčky pro GitHub Copilot, Claude Code, Cursor, Codex, Gemini, OpenCode, Windsurf, Kiro i Grok Build. Každý nástroj dostane jen ty primitivy, které podporuje.

Základ tvoří tři věci:

  • apm.yml je manifest. Povinné jsou dvě pole, name a version. Závislosti jdou do dependencies.apm, MCP servery do dependencies.mcp.
  • apm.lock.yaml je lockfile. Má se commitovat. Zapisuje přesný commit, ze kterého se balíček nainstaloval, a nasazené soubory. Díky tomu dostane každý po klonu totéž.
  • apm install stáhne závislosti a rozloží je do složek konkrétního agenta.

Instalace podle oficiální stránky:

brew install apm
# Linux/macOS bez Homebrew
curl -sSL https://aka.ms/apm-unix | sh
# Windows
irm https://aka.ms/apm-windows | iex

Zkušební balíček si vyzkoušíš jedním příkazem: apm install microsoft/apm-sample-package.

Jak vypadá apm.yml se skills

Závislost je zkratka vlastnik/repozitar, volitelně s #ref. Dokumentace uvádí tyto podoby:

  • microsoft/apm-sample-package#v1.0.0 je tag (neměnný),
  • owner/repo#main je větev, která se může kdykoli změnit,
  • ComposioHQ/awesome-claude-skills/brand-guidelines je jen podsložka repozitáře, tedy jeden skill,
  • ./packages/my-shared-skills je lokální cesta, jen pro vývoj.

Jednoduchý manifest může vypadat takto:

name: moje-tymove-skills
version: 1.0.0

dependencies:
  apm:
    - ComposioHQ/awesome-claude-skills/brand-guidelines#v1.2.0
    - moje-firma/agent-standardy/skills/code-review#v2.0.1
  mcp: []

Tag v ref je důležitý. Když ho vynecháš, APM tě na nepřipnutou závislost upozorní a stahovat budeš to, co je zrovna na výchozí větvi.

Tip ref může být i rozsah semver, třeba ^1.2.0. APM ho podle manifestu vyhodnotí proti vzdáleným tagům a vybere nejvyšší shodu. Dependabot se o rozsazích v oznámení ani v diskusi nezmiňuje, proto pro něj raději používej konkrétní tagy.

Krok za krokem: převod skills do APM

Skills dej do jednoho balíčku

Každý skill má vlastní složku v .apm/skills/. Jediný povinný soubor je SKILL.md, volitelně přidáš scripts/, references/ a assets/. Jméno skillu v hlavičce musí odpovídat názvu složky: malá písmena, číslice a pomlčky, nejvýše 64 znaků. Popis má mít maximálně 1024 znaků.

Zkus instalaci nanečisto

Nejdřív se podívej, kam APM soubory rozloží, a nic nezapisuj:

apm install --dry-run --target claude
apm install --target claude

Pro Claude Code skončí skill v .claude/skills/<name>/SKILL.md. Cursor, Codex, Gemini, Copilot i OpenCode používají podle dokumentace .agents/skills/<name>/SKILL.md.

Zkontroluj skill auditem

apm audit --file .apm/skills/<name>/SKILL.md

Instalace navíc skenuje skryté znaky Unicode. Jediný neviditelný znak v souboru může instalaci zablokovat, což je dobrá pojistka proti podvrženým instrukcím.

Připni verze a commitni lockfile

Každou závislost zapiš s tagem a po instalaci commitni apm.yml i apm.lock.yaml. Dependabot lockfile přegeneruje jen tehdy, když v repozitáři už je, a bez něj ti nikdo nezaručí stejné chování agenta na dvou počítačích.

Zapnutí Dependabota pro APM

Podle changelogu stačí přidat do .github/dependabot.yml položku apm, nasměrovat ji do složky s apm.yml a zvolit plán. Příklad (hodnoty directory a interval si uprav):

version: 2
updates:
  - package-ecosystem: "apm"
    directory: "/"
    schedule:
      interval: "weekly"

GitHub k tomu oznámení nezveřejnil hotový YAML, takže ber ukázku jako ověřený tvar podle popisu v changelogu, ne jako kopii z dokumentace. První týden si projdi, co přijde.

Pozor v diskusi v repozitáři dependabot-core (issue č. 14350) se u APM objevila poznámka o beta stavu a volbě enable-beta-ecosystems: true. Changelog z 3. listopadu už mluví o obecné dostupnosti na github.com pro všechny tarify. Kdyby ti GitHub konfiguraci odmítl, zkus tuhle volbu přidat.

Co přesně Dependabot umí

Podle oznámení a diskuse v dependabot-core:

  • Tagy (owner/repo#v1.2.0) posune na nejnovější release tag.
  • Úplné SHA commitu (40 znaků) posune na commit nejnovějšího anotovaného tagu a přidá komentář s verzí.
  • Větve (owner/repo#main) neaktualizuje v manifestu, ale posune commit zapsaný v apm.lock.yaml.
  • Lockfile přegeneruje pomocí apm lock, ale jen pokud už existuje.
  • Pokrývá dependencies i devDependencies a funguje s volbami groups, ignore a cooldown.

Dependabot se tedy chová stejně jako u npm nebo Composeru. Můžeš skupinovat aktualizace do jednoho PR, ignorovat konkrétní balíčky nebo nastavit prodlevu, než nová verze dozraje.

Co Dependabot nedělá

  • Jen verzovací aktualizace. Bezpečnostní aktualizace (security updates) APM zatím nepodporuje.
  • Nepřipnuté položky, zkrácené SHA, lokální cesty a MCP servery nechává beze změny.
  • Enterprise Server: na GitHub Enterprise Server dorazí podpora ve verzi 3.24.

V praxi z toho plyne jedno pravidlo: bez tagu není co aktualizovat.

Jak reviewovat pull request se skills

Tohle je nejdůležitější část. PR od Dependabota s novou verzí skillu není rutinní bump knihovny. Mění instrukce, podle kterých tvůj agent jedná, a to může ovlivnit i to, co smí spouštět.

Checklist k review:

  1. Podívej se na diff SKILL.md, ne jen na číslo verze. Co se změnilo v pravidlech?
  2. Hledej nové skripty. Skill může přibalit scripts/, které agent spustí.
  3. Zkontroluj oprávnění. Přibyla instrukce typu „spusť bez ptaní“ nebo odkaz na neznámou doménu?
  4. Projdi lockfile. Měl by se změnit commit u konkrétního balíčku, ne celý strom.
  5. Spusť skill na jednom známém úkolu a porovnej výstup s tím, co dával dřív.

Pokud tvůj agent pracuje s citlivými daty, přečti si ještě jak auditovat bezpečnost AI agentů a bezpečnostní kroky pro rozšíření VS Code a Cursoru. Stejná logika platí pro skills: třetí strana ti dodává kód, který se spouští tvým jménem.

Tip nastav v repozitáři pravidlo, že PR měnící .claude/skills/ nebo .agents/skills/ schvaluje vždy člověk z týmu, nikdy automatický merge.

Týmové nastavení, které funguje

Z praxe jde o tři vrstvy:

  • Firemní balíček se standardy (code review, testy, styl commitů) s tagovanými verzemi, který si repozitáře instalují přes APM.
  • Projektový manifest v každém repozitáři, kde je jen to, co projekt skutečně používá.
  • Dependabot s týdenním plánem a skupinováním, ať nedostaneš každý den jiný PR.

Pro sdílení kontextu mezi agenty se hodí i AGENTS.md. APM umí instrukce kompilovat do AGENTS.md nebo CLAUDE.md, takže jedno místo pravdy obslouží víc nástrojů. Autoři zmiňují i varování: jakmile na sdíleném kontextu závisí víc týmů, je z něj součást platformy a potřebuje vlastníka a řízení změn.

Než to nasadíš

Návod vychází z oficiálního changelogu GitHubu, dokumentace APM a diskuse v dependabot-core, ne z testu v ostrém repozitáři. Ukázkový dependabot.yml proto nejdřív vyzkoušej na testovacím repozitáři a první pull requesty od Dependabota projdi ručně.

Časté otázky

Co je Agent Package Manager (APM)?

Open-source správce závislostí pro konfiguraci AI agentů od Microsoftu. Přes soubor apm.yml a lockfile apm.lock.yaml instaluje skills, prompty, instrukce a MCP servery pro Copilot, Claude Code, Cursor, Codex a další.

Aktualizuje Dependabot i MCP servery?

Ne. MCP servery v apm.yml nechává Dependabot beze změny, stejně jako lokální cesty, nepřipnuté položky a zkrácené SHA.

Hlídá Dependabot i bezpečnostní zranitelnosti skills?

Zatím ne. Oznámení výslovně říká, že podpora pokrývá verzovací aktualizace, ne bezpečnostní. Proto si každý PR musíš projít ručně.

Musím mít apm.lock.yaml?

Nemusíš, Dependabot ho aktualizuje jen tehdy, když existuje. Doporučuju ho ale commitovat, protože zaručuje stejný obsah balíčků po každém klonu.

Funguje to i s Claude Code?

Ano. APM má cíl claude a rozloží skill do .claude/skills/<name>/SKILL.md. Ostatní nástroje jako Cursor, Codex nebo Gemini používají složku .agents/skills/.

Shrnutí

Skills jsou závislosti jako každé jiné. APM jim dá manifest a lockfile, Dependabot k tomu přidá pravidelné pull requesty. Nejdřív připni verze tagy, commitni apm.lock.yaml, zapni týdenní plán a každý PR si přečti jako změnu kódu, ne jako číslo verze. Vyzkoušej to nejdřív na jednom repozitáři.

Ušetřete

  • Google: až 350 000 $ v Google Cloud kreditech na 2 roky — zobrazit výhodu
  • Anthropic: 6 měsíců Claude Ultra zdarma (v hodnotě 1 200 $) — zobrazit výhodu
  • Google: 1 rok Google AI Plus zdarma (jinak 149,99 Kč měsíčně) — zobrazit výhodu

Další AI kredity a slevy →

Zmíněné AI nástroje

Pokračuj dál

Všechny články →