4.2 Osvědčené postupy psaní
Osvědčené postupy psaní
Vzory, které dělají Skills spolehlivé
Čtyři pravidla pro spolehlivé instrukce
Používejte číslované kroky
Rozložte úlohu do jasné sekvence. Claude následuje číslované kroky spolehlivěji než prozaické odstavce.
Dávejte konkrétní příklady
Ukažte Claudovi, jak vypadá dobrý výstup. Zahrňte vzorové vstupy a očekávané výstupy.
Definujte formát výstupu explicitně
Určete přesnou strukturu, nadpisy, délku a styl.
Řekněte, co NEDĚLAT
Guardrails jsou stejně důležité jako instrukce. Řekněte Claudovi, čemu se vyhnout.
Dobré vs. špatné instrukce
Dobré: Konkrétní a akční
Spusťte python scripts/validate.py --input {filename} pro kontrolu formátu dat. Pokud validace selže, běžné problémy zahrnují: chybějící povinná pole, neplatné formáty data (použijte YYYY-MM-DD).
Špatné: Příliš vágní
Zvalidujte data před pokračováním.
Vzor guardrails
## Guardrails - Nikdy nepřeskakujte krok validace - Vždy se zeptejte na časové období, pokud není uvedeno - Každou sekci omezte na 3-5 bodů - NEZAHRNUJTE surová data do finálního reportu - Pokud API vrátí chybu, zkuste znovu jednou, pak reportujte uživateli
Test zmatení
Pokud vás krok při čtení mate, bude mást i Clauda. Pište instrukce, které by chytrý lidský asistent mohl následovat bez kladení otázek.
Shrnutí osvědčených postupů
Číslované kroky, konkrétní příklady, explicitní formáty a jasné guardrails — tyto čtyři vzory dělají rozdíl mezi Skillem, který občas funguje, a Skillem, který funguje vždy.
Čtyři ověřené vzory pro spolehlivé instrukce v SKILL.md.
Momentálně nejsou žádné komentáře.