writing-skills

Writing Skills to podejście Test-Driven Development zastosowane do tworzenia dokumentacji umiejętności dla agentów Claude i Codex. Zamiast pisać instrukcje na ślepo, najpierw definiujesz scenariusze testowe (presja na subagentów), obserwujesz, jak agent zawodzi bez dokumentacji, następnie piszesz umiejętność i weryfikujesz, że agent jej przestrzega. Umiejętności przechowywane są w katalogach specyficznych dla agenta (~/.claude/skills dla Claude Code, ~/.agents/skills/ dla Codex). Skill uczy cię cyklu RED-GREEN-REFACTOR: test pada, piszesz dokumentację, test przechodzi, zamykasz luki w instrukcjach.

1. Zapoznaj się z umiejętnością superpowers:test-driven-development — definiuje ona cykl RED-GREEN-REFACTOR, który Writing Skills adaptuje do dokumentacji. 2. Przygotuj scenariusz testowy (pressure scenario) z subagentami, który będzie sprawdzać, czy agent przestrzega reguły, którą chcesz nauczyć. Uruchom ten scenariusz PRZED napisaniem dokumentacji — obserwuj, jak agent zawodzi i jakie uzasadnienia podaje. 3. Napisz dokument umiejętności (SKILL.md) w odpowiednim katalogu: ~/.claude/skills dla Claude Code lub ~/.agents/skills/ dla Codex. Dokument powinien być przewodnikiem referencyjnym, zawierającym sprawdzone techniki i wzorce — nie opowiadaj historii, jak rozwiązałeś problem raz. 4. Uruchom scenariusz testowy ponownie z dokumentacją umiejętności dostępną dla agenta — zweryfikuj, że agent teraz przestrzega reguł i przechodzi test. 5. Przejrzyj i ulepsz (refactor) dokumentację, aby zamknąć wszelkie luki lub niejasności, które agent mógł wykorzystać, jednocześnie utrzymując zgodność z testami. 6. Pamiętaj: jeśli nie obserwowałeś, jak agent zawodzi bez umiejętności, nie wiesz, czy nauczasz go właściwych rzeczy.