moonbit-agent-guide

Skill wspierający pracę z projektami MoonBit — od organizacji plików i pakietów, przez konfigurację metadanych w moon.mod.json i moon.pkg.json, aż po stosowanie narzędzi moon (build, check, test, doc, ide). Zawiera konwencje layoutu projektów, strukturę katalogów dla bibliotek i aplikacji konsolowych, oraz zasady testowania white-box i black-box. Idealny dla programistów pracujących z modułami i pakietami MoonBit.

1. Zainstaluj skill moonbit-agent-guide w swoim środowisku Claude/Copilot, wskazując repozytorium loro-dev/loro z katalogu skills/moonbit.

2. Gdy tworzysz nowy projekt MoonBit, utwórz plik moon.mod.json w katalogu głównym projektu, aby zdefiniować metadane modułu — będzie to punkt wejścia dla całej struktury.

3. Dla każdego pakietu (katalogu) w projekcie dodaj plik moon.pkg.json z odpowiednią konfiguracją; jeśli pakiet zawiera aplikację konsolową, ustaw {"is_main": true}.

4. Organizuj pliki źródłowe z rozszerzeniem .mbt (oraz .mbti dla interfejsów) w strukturze katalogów — biblioteki umieszczaj w podkatalogach (np. liba/, liba/libb/), a aplikacje w cmd/main/.

5. Pisz testy w plikach z sufiksem _test.mbt (testy black-box) lub _wbtest.mbt (testy white-box dla członków prywatnych), a dokumentację w plikach README.mbt.md z blokami kodu oznaczonymi jako test.

6. Używaj narzędzi moon do budowania (build), sprawdzania (check), testowania (test), generowania dokumentacji (doc) i integracji z IDE — skill podpowie konwencje i strukturę dla każdego z tych kroków.