För Claude Code, Codex CLI och Gemini CLI
QNAP-riktlinjeskillen för AI-kodningsassistenter
En Agent Skill på engelska som talar om för en assistent vad en QNAP NAS är innan den svarar: ett rotfilsystem på en RAM-disk, BusyBox istället för GNU-verktyg, inget systemd och ingen pakethanterare, inställningar via getcfg och setcfg. Den beskriver vad man ska skriva istället för Ubuntu-vanan, var data finns, hur QPKG:er byggs, signeras och publiceras samt vad som aldrig ska rekommenderas: på din egen Linux-dator med QNAP:s QDK, eller i Bucket & Code Server IDE, som levereras med samma skill och lägger till den i varje projekt som dess guide skapar.
Zip-filens SHA-256: dd85c6048b7a43cb0fd767341e2b12f57ec1d003c5ad095ec880e094145af482 (qnap-skill-1.0.0-68.zip.sha256)
Vad som ingår
SKILL.md med reglerna och en tabell över vilken referens som svarar på vilken uppgift, samt elva referenser: skalet, vad som aldrig ska rekommenderas, lagring och sökvägar, byggprocess, App Builder-recept, QPKG-paket, kodsignering, App Center och förråd, portar, säkerhetskopior och kärnmoduler.
Var fakta kommer ifrån
NAS-fakta kommer från QNAP Club Polands kunskapsbas på forum.qnap.net.pl, uppmätta på QTS 6.1- och QuTS hero 6.0-enheter; varje referens länkar till sina källor. Fakta om byggprocess, förråd och signering kommer från användarhandboken för Bucket & Code Server IDE , QNAP:s QDK 2.5.0 och QPKG:er byggda med QDK 2.5.0 på Ubuntu 24.04 för QTS 6.1- och QuTS hero 6.1-enheter.
Installation
För Claude Code, packa upp den i ett projekt (första raden) eller i din hemkatalog för alla projekt (andra raden):
unzip qnap-skill-1.0.0-68.zip -d .claude/skills/
unzip qnap-skill-1.0.0-68.zip -d ~/.claude/skills/
Codex CLI läser AGENTS.md, och Gemini CLI gör det så snart dess inställningar anger den filen: lägg till en rad där som instruerar assistenten att läsa .claude/skills/qnap-dev/SKILL.md.
Kodsignering, rakt på sak
- Ett certifikat som filer (
certificate,private_key,ca_certs): stöds.qbuildi QDK signerar paketet, på din egen dator eller viabvs qbuild. - Ett certifikat på en hårdvarutoken (en USB-säkerhetsnyckel): stöds inte och har inte testats. Denna skill återger fakta om QDK:s egen väg och uppger att den aldrig körts.
- Inget certifikat: paketet är osignerat. Andra NAS-enheter installerar det endast om deras ägare tillåter appar utan en giltig digital signatur, vilket denna skill aldrig rekommenderar.
Licens
Texten i denna skill är licensierad under Creative Commons Attribution 4.0 International License (CC BY 4.0): du får dela och anpassa den för vilket ändamål som helst, med erkännandet ”QNAP guidelines skill by QNAP Club Poland / qnaputilities.com, CC BY 4.0”, en länk till licensen och en notering om du har gjort ändringar. Zip-filens LICENSE innehåller den juridiska texten. Bucket & Code Server IDE, paketet som levereras med denna skill, behåller sin egen licens.