Für Claude Code, Codex CLI und Gemini CLI
Der QNAP-Richtlinien-Skill für KI-Coding-Assistenten
Ein Agent Skill auf Englisch, der einem Assistenten vor der Antwort erklärt, was ein QNAP NAS ist: ein Root-Dateisystem auf einer RAM-Disk, BusyBox statt GNU-Tools, kein systemd und kein Paketmanager, Einstellungen über getcfg und setcfg. Er legt dar, was anstelle von Ubuntu-Gewohnheiten zu schreiben ist, wo Daten liegen, wie QPKGs gebaut, signiert und veröffentlicht werden und was niemals empfohlen werden darf: auf dem eigenen Linux-Rechner mit QNAPs QDK oder in Bucket & Code Server IDE, das denselben Skill ausliefert und in jedes Projekt einbindet, das dessen Assistent erstellt.
SHA-256 der ZIP-Datei: dd85c6048b7a43cb0fd767341e2b12f57ec1d003c5ad095ec880e094145af482 (qnap-skill-1.0.0-68.zip.sha256)
Was enthalten ist
SKILL.md mit den Regeln und einer Tabelle, welche Referenz welche Aufgabe beantwortet, sowie elf Referenzen: die Shell, was niemals empfohlen werden darf, Speicher und Pfade, Build-Vorgang, App-Builder-Rezepte, QPKG-Pakete, Codesignierung, App Center und Repositories, Ports, Backups und Kernel-Module.
Woher die Fakten stammen
Die NAS-Fakten stammen aus der Wissensdatenbank von QNAP Club Poland auf forum.qnap.net.pl, ermittelt auf Geräten mit QTS 6.1 und QuTS hero 6.0; jede Referenz verlinkt ihre Quellen. Die Fakten zu Build, Repository und Signierung stammen aus dem Benutzerhandbuch von Bucket & Code Server IDE , QNAPs QDK 2.5.0 und QPKGs, die mit QDK 2.5.0 unter Ubuntu 24.04 für Geräte mit QTS 6.1 und QuTS hero 6.1 gebaut wurden.
Installation
Für Claude Code in ein Projekt entpacken (die erste Zeile) oder für alle Projekte in Ihr Home-Verzeichnis (die zweite):
unzip qnap-skill-1.0.0-68.zip -d .claude/skills/
unzip qnap-skill-1.0.0-68.zip -d ~/.claude/skills/Codex CLI liest AGENTS.md, und Gemini CLI tut dies, sobald dessen Einstellungen diese Datei angeben: Fügen Sie dort eine Zeile ein, die den Assistenten anweist, .claude/skills/qnap-dev/SKILL.md zu lesen.
Codesignierung, klar dargestellt
- Ein Zertifikat als Dateien (
certificate,private_key,ca_certs): unterstützt.qbuildaus dem QDK signiert das Paket, auf dem eigenen Rechner oder überbvs qbuild. - Ein Zertifikat auf einem Hardware-Token (ein USB-Key): nicht unterstützt und ungetestet. Der Skill schildert die Fakten zu QDKs eigenem Weg und gibt an, dass dieser nie ausgeführt wurde.
- Kein Zertifikat: Das Paket ist unsigniert. Andere NAS-Geräte installieren es nur, wenn deren Besitzer Apps ohne gültige digitale Signatur zulassen, was der Skill niemals empfiehlt.
Lizenz
Der Text des Skills ist unter der Creative Commons Attribution 4.0 International License (CC BY 4.0) lizenziert: Sie dürfen ihn für jeden Zweck teilen und anpassen, unter Nennung der Quellenangabe „QNAP guidelines skill by QNAP Club Poland / qnaputilities.com, CC BY 4.0“, eines Links zur Lizenz und eines Hinweises, falls Sie Änderungen vorgenommen haben. Die Datei LICENSE der ZIP-Datei enthält den vollständigen Lizenztext. Bucket & Code Server IDE, das Paket, das den Skill ausliefert, behält seine eigene Lizenz.