適用於 Claude Code、Codex CLI 與 Gemini CLI
適用於 AI 程式碼助理的 QNAP 指引技能
一份英文的 Agent Skill，在助理回答前告知其何謂 QNAP NAS：RAM-disk 根目錄、以 BusyBox 取代 GNU 工具、無 systemd 且無套件管理器，以及透過 getcfg 與 setcfg 管理的設定。它指明了不應依循 Ubuntu 習慣而應撰寫的內容、資料存放位置、QPKG 如何建置、簽署與發布，以及絕對不要建議的做法：適用於使用 QNAP QDK 的自有 Linux 電腦，或 Bucket & Code Server IDE 之中；Bucket & Code Server IDE 亦隨附相同的技能，並將其放入精靈建立的每個專案中。
此 zip 檔的 SHA-256：dd85c6048b7a43cb0fd767341e2b12f57ec1d003c5ad095ec880e094145af482（qnap-skill-1.0.0-68.zip.sha256）
內含項目
包含規則與指引任務對照表的 SKILL.md，以及十一份參考資料：shell、絕不建議的做法、儲存空間與路徑、建置、App Builder 配方、QPKG 套件、程式碼簽署、App Center 與儲存庫、連接埠、備份以及核心模組。
資訊來源
NAS 相關資訊源自 forum.qnap.net.pl 上的 QNAP Club Poland 知識庫，並在 QTS 6.1 與 QuTS hero 6.0 裝置上實測；每份參考資料均附有其來源連結。建置、儲存庫與簽署相關資訊則來自 Bucket & Code Server IDE 的使用者指南、QNAP 的 QDK 2.5.0，以及在 Ubuntu 24.04 上以 QDK 2.5.0 為 QTS 6.1 與 QuTS hero 6.1 裝置建置的 QPKG。
安裝方式
若是 Claude Code，請將其解壓縮至專案中（第一行），或解壓縮至您的家目錄以套用至所有專案（第二行）：
unzip qnap-skill-1.0.0-68.zip -d .claude/skills/
unzip qnap-skill-1.0.0-68.zip -d ~/.claude/skills/Codex CLI 會讀取 AGENTS.md，而 Gemini CLI 在設定中指定該檔案後也會讀取：請在該檔案中新增一行，指示助理讀取 .claude/skills/qnap-dev/SKILL.md。
關於程式碼簽署的明確說明
- 檔案形式的憑證（
certificate、private_key、ca_certs）：支援。由 QDK 的qbuild簽署套件，可在自己的電腦上執行，或透過bvs qbuild。 - 硬體權杖（USB 金鑰）上的憑證：不支援且未經測試。此技能提供了 QDK 本身途徑的說明，並註明該途徑從未執行過。
- 無憑證：套件未簽署。其他 NAS 裝置僅在其擁有者允許未具備有效數位簽署的應用程式時才會安裝，而此技能絕不建議這麼做。
授權條款
此技能的文字採用 Creative Commons Attribution 4.0 International License (CC BY 4.0) 授權：您可以出於任何目的分享與修改它，但必須註明出處 「QNAP guidelines skill by QNAP Club Poland / qnaputilities.com, CC BY 4.0」、提供授權條款的連結，並說明是否經過修改。zip 檔內的 LICENSE 包含法律條文。隨附此技能的套件 Bucket & Code Server IDE 則保留其自身的授權條款。