Per Claude Code, Codex CLI e Gemini CLI
La skill con le linee guida QNAP per gli assistenti di programmazione AI
Una Agent Skill in inglese che spiega a un assistente cosa sia un NAS QNAP prima che risponda: una root su RAM-disk, BusyBox invece degli strumenti GNU, nessun systemd e nessun gestore di pacchetti, impostazioni gestite tramite getcfg e setcfg. Indica cosa scrivere al posto delle consuetudini di Ubuntu, dove risiedono i dati, come vengono compilati, firmati e pubblicati i pacchetti QPKG e cosa non raccomandare mai: sul proprio computer Linux con il QDK di QNAP, oppure in Bucket & Code Server IDE, che include la stessa skill e la inserisce in ogni progetto creato tramite la sua procedura guidata.
SHA-256 dello zip: dd85c6048b7a43cb0fd767341e2b12f57ec1d003c5ad095ec880e094145af482 (qnap-skill-1.0.0-68.zip.sha256)
Cosa contiene
SKILL.md con le regole e una tabella che indica quale riferimento risponde a ciascun compito, e undici riferimenti: la shell, cosa non raccomandare mai, storage e percorsi, compilazione, ricette dell'App Builder, pacchetti QPKG, firma del codice, App Center e repository, porte, backup e moduli del kernel.
Da dove provengono le informazioni
Le informazioni sui NAS provengono dalla knowledge base di QNAP Club Poland su forum.qnap.net.pl, verificate su unità QTS 6.1 e QuTS hero 6.0; ogni riferimento include i link alle rispettive fonti. Le informazioni su compilazione, repository e firma provengono dalla guida utente di Bucket & Code Server IDE , da QDK 2.5.0 di QNAP e da pacchetti QPKG compilati con QDK 2.5.0 su Ubuntu 24.04 per unità QTS 6.1 e QuTS hero 6.1.
Installazione
Per Claude Code, estrarre lo zip all'interno di un progetto (la prima riga) o nella propria cartella home per applicarlo a ogni progetto (la seconda):
unzip qnap-skill-1.0.0-68.zip -d .claude/skills/
unzip qnap-skill-1.0.0-68.zip -d ~/.claude/skills/Codex CLI legge AGENTS.md, e Gemini CLI fa lo stesso una volta specificato tale file nelle sue impostazioni: aggiungere lì una riga che indichi all'assistente di leggere .claude/skills/qnap-dev/SKILL.md.
Firma del codice, spiegata chiaramente
- Un certificato sotto forma di file (
certificate,private_key,ca_certs): supportato.qbuilddel QDK firma il pacchetto, sul proprio computer o tramitebvs qbuild. - Un certificato su token hardware (una chiave USB): non supportato e non testato. La skill riporta i dettagli della procedura prevista da QDK, specificando che non è mai stata eseguita.
- Nessun certificato: il pacchetto non è firmato. Le altre unità NAS lo installeranno solo se i rispettivi proprietari consentono app prive di una firma digitale valida, cosa che la skill raccomanda di non fare mai.
Licenza
Il testo della skill è rilasciato sotto la Creative Commons Attribution 4.0 International License (CC BY 4.0): è consentito condividerlo e adattarlo per qualsiasi scopo, riportando la menzione di attribuzione “QNAP guidelines skill by QNAP Club Poland / qnaputilities.com, CC BY 4.0”, un link alla licenza e una nota nel caso in cui siano state apportate modifiche. Il file LICENSE presente nello zip contiene il testo legale completo. Bucket & Code Server IDE, il pacchetto che distribuisce la skill, mantiene la propria licenza.