Dla Claude Code, Codex CLI i Gemini CLI
Skill z wytycznymi dotyczącymi QNAP dla asystentów kodowania AI
Agent Skill w języku angielskim, który informuje asystenta, czym jest QNAP NAS, zanim ten udzieli odpowiedzi: główny system plików w RAM-dysku, BusyBox zamiast narzędzi GNU, brak systemd i brak menedżera pakietów, ustawienia dostępne przez getcfg i setcfg. Wskazuje, co pisać zamiast nawyków z Ubuntu, gdzie znajdują się dane, jak pakiety QPKG są budowane, podpisywane i publikowane, a także czego nigdy nie zalecać: na własnym komputerze z Linuksem z QDK firmy QNAP albo w Bucket & Code Server IDE, który dostarcza ten sam skill i umieszcza go w każdym projekcie tworzonym przez jego kreator.
Suma SHA-256 archiwum zip: dd85c6048b7a43cb0fd767341e2b12f57ec1d003c5ad095ec880e094145af482 (qnap-skill-1.0.0-68.zip.sha256)
Co znajduje się w środku
SKILL.md z zasadami oraz tabelą wskazującą, która referencja odpowiada na które zadanie, a także jedenaście referencji: powłoka, czego nigdy nie zalecać, pamięć masowa i ścieżki, budowanie, przepisy App Buildera, pakiety QPKG, podpisywanie kodu, App Center i repozytoria, porty, kopie zapasowe oraz moduły jądra.
Skąd pochodzą fakty
Fakty dotyczące NAS pochodzą z bazy wiedzy QNAP Club Poland na forum.qnap.net.pl, sprawdzone na urządzeniach z QTS 6.1 i QuTS hero 6.0; każda referencja zawiera odnośniki do swoich źródeł. Fakty dotyczące budowania, repozytoriów i podpisywania pochodzą z podręcznika użytkownika Bucket & Code Server IDE , QDK 2.5.0 firmy QNAP oraz pakietów QPKG zbudowanych za pomocą QDK 2.5.0 na Ubuntu 24.04 dla urządzeń z QTS 6.1 i QuTS hero 6.1.
Instalacja
W przypadku Claude Code rozpakuj archiwum do projektu (pierwszy wiersz) lub do katalogu domowego dla wszystkich projektów (drugi wiersz):
unzip qnap-skill-1.0.0-68.zip -d .claude/skills/
unzip qnap-skill-1.0.0-68.zip -d ~/.claude/skills/Codex CLI odczytuje AGENTS.md, a Gemini CLI robi to, gdy plik ten zostanie wskazany w jego ustawieniach: dodaj tam wiersz nakazujący asystentowi odczytanie .claude/skills/qnap-dev/SKILL.md.
Podpisywanie kodu w prostych słowach
- Certyfikat w postaci plików (
certificate,private_key,ca_certs): obsługiwany.qbuildz QDK podpisuje pakiet, na własnym komputerze albo przezbvs qbuild. - Certyfikat na tokenie sprzętowym (klucz USB): nieobsługiwany i nietestowany. Skill przedstawia fakty dotyczące natywnej ścieżki QDK i zaznacza, że nigdy nie została uruchomiona.
- Brak certyfikatu: pakiet jest niepodpisany. Inne urządzenia NAS zainstalują go tylko wtedy, gdy ich właściciele zezwolą na aplikacje bez ważnego podpisu cyfrowego, czego skill nigdy nie zaleca.
Licencja
Tekst skilla jest objęty licencją Creative Commons Attribution 4.0 International License (CC BY 4.0): możesz go udostępniać i dostosowywać do dowolnego celu, z zachowaniem noty uznania autorstwa „QNAP guidelines skill by QNAP Club Poland / qnaputilities.com, CC BY 4.0”, odnośnikiem do licencji oraz informacją, jeśli wprowadzono zmiany. Plik LICENSE w archiwum zip zawiera pełny tekst prawny licencji. Bucket & Code Server IDE, pakiet dostarczający ten skill, zachowuje własną licencję.