Jak psát AGENTS.md a skilly pro nové modely

Většina AGENTS.md, které vidím, je zbytečně dlouhá. Ten náš taky byl. Pravidla, která kdysi pomáhala starším modelům, dnes agenta spíš brzdí: čte dokumentaci, kterou nepotřebuje, pouští testy navíc a ptá se na souhlas tam, kde nemusí.

Na Astře Max mi úkoly běží i přes tři hodiny. U takhle dlouhé práce nechci, aby agenta zastavilo pravidlo, které jsem psal pro starší model.

OpenAI o tom 11. září napsalo článek ke GPT-6 Astra. Tady je, co jsem si z něj vzal, jak to máme u nás a dva prompty, se kterými si to uděláte sami.

AGENTS.md jen na to, co platí pořád

AGENTS.md agent čte u každého úkolu. Každý řádek v něm tedy zabírá kontext, i když s prací nesouvisí. Patří tam jen pravidla, která platí skoro vždycky. Zbytek dejte do dokumentů, které agent otevře, až je bude potřebovat.

Místo pravidel tam dnes máme tabulku. Ke každému typu práce, jako je design, blog, CRM nebo měření, patří jeden dokument. Když agent upravuje blog, přečte si návod k blogu. Když opravuje formulář, o reklamách nečte nic.

Většinu starých pravidel stačí zúžit na to, na čem opravdu záleží:

Používáte i Claude Code? Ten čte AGENTS.md jen tehdy, když v projektu chybí CLAUDE.md. Do CLAUDE.md proto napište jediný řádek @AGENTS.md a oba agenti čtou stejná pravidla.

Popis skillu rozhoduje, kdy se spustí

Agent na začátku nevidí celé skilly, jen jejich názvy a popisy. Codex jim dává nejvýš 2 % kontextu, Claude Code 1 %, a když se nevejdou, zkracují je. Celý SKILL.md agent otevře, až když popis sedí na úkol. Popis je tak nejdůležitější věta celého skillu.

• Moc široký: „Vytváří migrace Postgres. Použij při práci s databázemi, dotazy nebo modely.“
• Přesný: „Vytváří migrace Postgres. Použij, když přidáváš nebo měníš migraci.“

První se spustí u každé práce s databází, druhý jen u migrací. Když skill pokrývá víc postupů, nechte v SKILL.md jen rozcestník a podrobnosti dejte do složky references/.

Neopisujte návod, pošlete agenta ke zdroji

Tohle jsem v první verzi článku udělal špatně. Přečetl jsem návod OpenAI, přepsal ho do vlastních pravidel a ta vložil do promptu. Agent tak dostal můj výtah místo originálu. Přitom si ho umí přečíst sám.

Prompt níže proto jen říká, kde je zdroj a co s ním udělat. Agent potřebuje přístup k webu.

Ukliď instrukce, které v tomhle projektu čteš.

Nejdřív si přečti, jak mají instrukce pro nové modely vypadat: https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra
Pokud jsi Claude Code, přečti si ještě https://code.claude.com/docs/en/memory a https://code.claude.com/docs/en/skills

Pak projdi AGENTS.md, CLAUDE.md, pravidla editoru a skilly v projektu i globálně a uprav je podle těch zásad. Máš-li přístup k historii našich sezení, najdi místa, kde jsem tě opravoval nebo kde jsi zbytečně čekal na souhlas, a zjisti, které pravidlo za tím stálo.

Měň jen instrukce, skilly a README v projektu. Globální soubory jen navrhni. Když do složky nemůžeš zapisovat, pošli změny jako patch.

Hotovo je, až mi v odpovědi napíšeš, co jsi smazal, přesunul nebo přepsal a proč, a otázky, o kterých musím rozhodnout já. Necommituj a nepushuj.

Výsledek si projděte v diffu jako každou jinou změnu. Když agent smaže pravidlo, které má svůj důvod, dopište ten důvod k pravidlu. Příště ho nechá být.

Skill si nechte napsat z hotové práce

Skill se vyplatí, když agentovi pořád dokola vysvětlujete stejný postup. Nejrychlejší cesta: dotáhněte s ním práci do konce a pak ho požádejte, ať z ní udělá skill. Zase mu dejte odkaz na pravidla, ne vlastní shrnutí.

Z práce, kterou jsme teď dokončili, udělej skill.

Drž se specifikace https://agentskills.io/specification a návodu OpenAI: https://github.com/openai/codex/blob/main/codex-rs/skills/src/assets/samples/skill-creator/SKILL.md

Popis napiš slovy, kterými ti tuhle práci obvykle zadávám. Do SKILL.md dej jen to, co změní tvoje rozhodnutí.

Hotovo je, až skill uložíš a napíšeš mi dvě zadání, na která se má spustit, a jedno podobné, na které ne.

Výsledek může vypadat třeba takhle:

---
name: nasazeni-webu
description: Nasadí web a ověří výsledek. Použij, když chce uživatel nasadit web nebo náhled.
---

Náhledové nasazení můžeš spustit sám. Na produkci nasazuj jen na výslovný pokyn v zadání.

Před nasazením musí projít build. Po nasazení otevři web na šířce 390 px i na desktopu a vyzkoušej hlavní stránky a formuláře.

Hotovo je, když uživateli pošleš adresu nasazení a seznam chyb, které jsi našel a opravil.

Uložte ho do .agents/skills/nasazeni-webu/ pro Codex nebo do .claude/skills/nasazeni-webu/ pro Claude Code. Pak ho vyzkoušejte v novém sezení se zadáním, které ho má spustit, a s jedním, které ne.

A po každém novém modelu pusťte úklid znovu. Co dnes pomáhá, může u dalšího modelu zase brzdit.