Tworzenie własnego moda
claude plugin validate pozwala sprawdzić własny mod tak, jak widzi go Claude Code, bez uruchamiania jego kodu i bez rozpoczynania sesji. Polecenie sprawdza manifest moda i wykonuje analizę statyczną źródła modułu hooks. Uruchom je w powłoce, podając katalog moda jako argument.
Wynik pokazuje zdarzenia obsługiwane przez moduł, wraz z filtrami zapisanymi w nawiasach klamrowych. Linia calls: ujawnia metody API modów, które wykryto w kodzie. Jeśli kod używa zmiennych środowiskowych lub $.state, wynik może też zawierać informacje o odczytach i zapisach tych wartości.
Aby analiza wykryła wywołanie API, zapisuj je w pełnej postaci: $, przestrzeń nazw i metodę. Nazwę zdarzenia w każdym wywołaniu on podawaj jako literał tekstowy; zmienna lub pętla po nazwach nie przejdzie walidacji. Jeśli zamierzone zdarzenie nie pojawia się w wyniku, Claude Code nie wywoła odpowiadającego mu hooka; częstą przyczyną jest literówka w nazwie.
Walidację warto uruchomić po zmianie modułu, ponieważ Claude może edytować kod, uruchomić claude plugin validate i poprawić zgłoszone problemy. Przed udostępnieniem moda sprawdź jego nazwę: walidator odrzuca nazwy wyglądające na własne nazwy Anthropic, na przykład zaczynające się od claude-. Ponieważ zdarzenia i metody mogą zmieniać się między wydaniami, README powinien wskazywać wersję Claude Code, z którą mod został przetestowany.
./first-mod.claude plugin validate ./first-mod
claude plugin validate
Zastosowanie w praktyce
Podczas tworzenia własnego moda uruchom walidator na jego katalogu, aby sprawdzić manifest i analizę statyczną modułu hooks bez uruchamiania kodu. Po walidacji przejrzyj linię hooks: i upewnij się, że wynik zawiera oczekiwane zdarzenia oraz ich filtry. Sprawdź też linię calls:, aby potwierdzić, jakie metody API modów wykryto w module. Gdy zmieniasz istniejący mod z pomocą Claude, walidacja może wskazać problemy, które Claude następnie poprawi. Przed udostępnieniem sprawdź nazwę moda, ponieważ walidator odrzuca nazwę przypominającą własną nazwę Anthropic.
on — częstą przyczyną jest literówka, a nazwa musi być literałem tekstowym.