Pour Claude Code, Codex CLI et Gemini CLI
Le skill de directives QNAP pour assistants de codage IA
Un Agent Skill en anglais qui indique à un assistant ce qu'est un NAS QNAP avant qu'il ne réponde : une racine sur disque RAM, BusyBox au lieu des outils GNU, pas de systemd ni de gestionnaire de paquets, des paramètres gérés par getcfg et setcfg. Il précise ce qu'il faut écrire à la place des habitudes Ubuntu, où se trouvent les données, comment les QPKG sont compilés, signés et publiés, et ce qu'il ne faut jamais recommander : sur votre propre ordinateur Linux avec le QDK de QNAP, ou dans Bucket & Code Server IDE, qui intègre le même skill et le place dans chaque projet créé par son assistant.
SHA-256 du zip : dd85c6048b7a43cb0fd767341e2b12f57ec1d003c5ad095ec880e094145af482 (qnap-skill-1.0.0-68.zip.sha256)
Contenu
SKILL.md avec les règles et un tableau associant chaque référence à sa tâche, ainsi que onze références : le shell, ce qu'il ne faut jamais recommander, le stockage et les chemins, la compilation, les recettes de l'App Builder, les paquets QPKG, la signature de code, l'App Center et les dépôts, les ports, les sauvegardes et les modules du noyau.
Origine des informations
Les informations relatives au NAS proviennent de la base de connaissances de QNAP Club Poland sur forum.qnap.net.pl, mesurées sur des unités sous QTS 6.1 et QuTS hero 6.0 ; chaque référence renvoie vers ses sources. Les informations sur la compilation, les dépôts et la signature proviennent du guide d'utilisation de Bucket & Code Server IDE , du QDK 2.5.0 de QNAP et de paquets QPKG compilés avec le QDK 2.5.0 sous Ubuntu 24.04 pour des unités sous QTS 6.1 et QuTS hero 6.1.
Installation
Pour Claude Code, décompressez-le dans un projet (première ligne) ou dans votre dossier personnel pour l'ensemble des projets (seconde ligne) :
unzip qnap-skill-1.0.0-68.zip -d .claude/skills/
unzip qnap-skill-1.0.0-68.zip -d ~/.claude/skills/Codex CLI lit AGENTS.md, et Gemini CLI fait de même une fois configuré pour cibler ce fichier : ajoutez-y une ligne indiquant à l'assistant de lire .claude/skills/qnap-dev/SKILL.md.
La signature de code, expliquée simplement
- Un certificat sous forme de fichiers (
certificate,private_key,ca_certs) : pris en charge. Leqbuilddu QDK signe le paquet, sur votre propre ordinateur ou viabvs qbuild. - Un certificat sur token matériel (clé USB) : non pris en charge et non testé. Le skill fournit les faits concernant la méthode propre à QDK et indique qu'elle n'a jamais été exécutée.
- Aucun certificat : le paquet n'est pas signé. D'autres NAS ne l'installeront que si leurs propriétaires autorisent les applications sans signature numérique valide, ce que le skill ne recommande jamais.
Licence
Le texte du skill est sous licence Creative Commons Attribution 4.0 International (CC BY 4.0) : vous pouvez le partager et l'adapter à toutes fins, avec la mention de crédit « QNAP guidelines skill by QNAP Club Poland / qnaputilities.com, CC BY 4.0 », un lien vers la licence et une indication si vous l'avez modifié. Le fichier LICENSE du zip contient le texte juridique complet. Bucket & Code Server IDE, le paquet qui intègre le skill, conserve sa propre licence.