Lekce 05.5: Uživatelské vs. projektové dovednosti (User Vs Project Skills)

⏱️ 3 min čtení • Lekce 05.5

🧠 Mentální model & teoretický rozbor

Kde mají dovednosti žít? Musíme rozlišovat dvě úrovně uložení:

┌─────────────────────────────────────────────────────────────────────────┐
│ UŽIVATELSKÉ DOVEDNOSTI (User-Level Skills)                              │
│ • Antigravity: ~/.gemini/config/skills/<nazev>/SKILL.md                 │
│ • Claude Code: ~/.claude/skills/<nazev>/SKILL.md                        │
│ Vaše osobní superschopnosti:                                            │
│ • Přenosné mezi všemi projekty na vašem počítači.                       │
│ • Styl psaní commit zpráv, generování licencí, osobní debugging.       │
├─────────────────────────────────────────────────────────────────────────┤
│ PROJEKTOVÉ DOVEDNOSTI (Project-Level Skills)                            │
│ • Antigravity: ./.agents/skills/<nazev>/SKILL.md v repozitáři           │
│ • Claude Code: ./.claude/skills/<nazev>/SKILL.md v repozitáři           │
│ Týmový standard a firemní know-how:                                     │
│ • Verzované v Gitu společně se zdrojovým kódem.                         │
│ • Specifické pro databázi, framework a interní utility projektu.        │
│ • Sdílené se všemi kolegy i CI/CD agenty.                               │
└─────────────────────────────────────────────────────────────────────────┘

🏢 Realistický scénář z praxe

Nový juniorní vývojář nastoupí do firmy a naklonuje repozitář:

Protože projekt obsahuje sadu projektových dovedností v .agents/skills/ (nebo .claude/skills/), jeho agent okamžitě ví, jak vytvářet migrace, jak psát komponenty a jak spouštět integrační testy.
Onboarding se zkrátí z týdne na 1 den bez nutnosti číst 80 stránek staré Confluence wiki.

💻 Konkrétní ukázky kódu & promptů

Příklad uživatelské dovednosti (`~/.gemini/config/skills/git-commit/SKILL.md` nebo `~/.claude/skills/git-commit/SKILL.md`):

---
name: smart-commit
description: Vytvoření konvenční Git commit zprávy po analýze git diffu
---

# Smart Commit

1. Spusť `git diff --staged` (pokud je prázdný, spusť `git diff`).
2. Zanalyzuj provedené změny.
3. Navrhni commit zprávu podle specifikace Conventional Commits:
   `feat(...)`, `fix(...)`, `refactor(...)`, `docs(...)`.
4. Požádej uživatele o schválení před samotným commitem.

⚠️ Analýza selhání & Anti-patterns

Chyba: Ukládání projektových internálií do globální složky

Pokud si návod na práci s interní firemní databází uložíte do globální složky (~/.gemini/config/skills/ nebo ~/.claude/skills/):

Vaši kolegové v týmu tuto dovednost nemají a nevidí ji v gitu.
Pokud přepnete na jiný projekt, agent může omylem navrhovat interní postupy na cizím kódu.

🛠️ Inženýrský postup krok za krokem (Playbook)

Osobní workflow zkratky (commit zprávy, lint check, kontrola branch names) ➔ ukládejte do ~/.gemini/config/skills/ (nebo ~/.claude/skills/).
Projektová pravidla a procedury ➔ ukládejte do .agents/skills/ (nebo .claude/skills/) a pushněte do Gitu.

🧪 Praktické cvičení (Hands-on Lab)

Úkol:

Vytvořte si jednu osobní globální dovednost a jednu projektovou dovednost a ověřte jejich dostupnost.

Kroky:

Vytvořte globální dovednost smart-commit.
Vytvořte projektovou dovednost pro spuštění linteru a testů.
Otevřete terminál (agy nebo claude) a ověřte, že obě dovednosti jsou k dispozici přes lomítko /.