Přeskočit na obsah

C112 — Přidání nové schopnosti

Pokročilé: kdy schopnost vzniknout má, kdy ne, a co všechno k ní patří, aby byla hotová.

C112Claude Code 9 minVývojářMaintainer

Po téhle lekci

  • Použijete pět otázek, které rozhodují o vzniku schopnosti.
  • Zařadíte věc do správné vrstvy: fakt, pravidlo, postup, záruka.
  • Vyjmenujete, co brána vyžaduje, aby schopnost prošla buildem.

Přidat schopnost je snadné. Přidat ji správně znamená nejdřív zjistit, jestli má vzniknout.

Pět otázek

Při první „ne" se schopnost nepíše:

  1. Řeší to už něco? Rozšířit existující je skoro vždycky lepší než založit druhé.
  2. Je za tím opakovaná práce? Konkrétně: třikrát vložený stejný dlouhý prompt, zaplavený kontext, dvanáctikrokový postup opakovaný lidmi.
  3. Dá se to otestovat? Ne text — metadata, odkazy, přítomnost povinných částí.
  4. Je to opravdu schopnost? Viz níž.
  5. Je pro to persona? Schopnost bez uživatele je jen údržbová plocha.

Zařazení do vrstvy

fakt platný vždy          → CLAUDE.md
pravidlo pro část stromu  → pravidlo s uvedenými cestami
postup                    → skill
specialista v izolaci     → agent
uživatelská cesta         → workflow
ZÁRUKA                    → validátor

Co brána vyžaduje

Schopnost neprojde buildem bez:

  • záznamu v katalogu s personou, úrovní rizika a informací, jestli zapisuje;
  • hranice použití — kdy se schopnost NEMÁ použít. Schopnost bez hranice se použije tam, kam nepatří;
  • jedinečného jména napříč vrstvami;
  • odkazů, které někam vedou — na neexistující soubor, příkaz nebo schopnost build spadne.

U subagenta navíc vyjmenované nástroje. Vynechaný seznam znamená, že zdědí všechny — a „jen čtoucí" agent by uměl zapisovat.

Jméno ověřte

Některá jména jsou obsazená vestavěnými příkazy. Schopnost toho jména by šla zdokumentovat, ale ne spustit — a dokumentovaná schopnost bez funkce je přesně to, co ústava projektu zakazuje.

Ověř si, že to sedí

Chcete přidat schopnost, která před commitem zkontroluje, že v datech není datum narození. Skill, nebo validátor?

Zobrazit odpověď

Validátor. Je to mechanicky ověřitelné pravidlo, které má platit vždycky — ne postup, který si někdo vyžádá. Skill by se dal přeskočit a nikdo by se to nedozvěděl; validátor v bráně shodí build. Tohle je čtvrtá otázka v praxi.

Kanonické znění pojmů

Lekce pojem vysvětluje. Závazná definice je tady — když se rozejdou, platí tahle stránka.