developing-genkit-tooling

Skill zawiera najlepsze praktyki do tworzenia narzędzi dla Genkit. Dowiesz się, jak prawidłowo nazewnictwo CLI (kebab-case z dwukropkami) i narzędzi MCP (snake_case), jak strukturować komendy przy użyciu runWithManager do interakcji z runtime'em projektu, oraz jak formatować wyjście dla maszyn i użytkowników. Obejmuje wytyczne architektoniczne dla statycznych narzędzi (np. dokumentacja) i narzędzi wymagających kontekstu projektu.

1. Zapoznaj się z konwencją nazewnictwa dla komend CLI: używaj kebab-case z dwukropkami jako separatorami (np. flow:run, eval:run). W kodzie argumenty piszesz camelCase (flowName), ale w tekście pomocy używasz standardowego formatu (<flowName>).

2. Dla narzędzi MCP stosuj snake_case (np. list_flows, run_flow), aby zachować spójność ze standardami MCP.

3. Implementując komendy CLI w cli/src/commands/, użyj narzędzia runWithManager do zarządzania cyklem życia runtime'u projektu. Importuj runWithManager z ../utils/manager-utils i opakowuj logikę interakcji z managerem wewnątrz funkcji callback.

4. Formatuj wyjście komend za pomocą logger z @genkit-ai/tools-common/utils. Jeśli komenda generuje dane, udostępnij opcje JSON lub zapisu do pliku. Dla operacji wspierających streaming (jak flow:run) dodaj flagę --stream i kieruj wyjście na stdout.

5. Rozróżnij między narzędziami statycznymi (np. dokumentacja, które nie wymagają kontekstu projektu) a narzędziami runtime'owymi (wymagającymi uruchomionego projektu Genkit). Każdy typ ma inny wzorzec rejestracji i zależności.