Claude Code、Codex CLI、Gemini CLI向け
AIコーディングアシスタント向けQNAPガイドラインスキル
アシスタントが回答する前にQNAP NASとは何かを伝える英語のAgent Skillです。RAMディスク上のルートファイルシステム、GNUツールの代わりのBusyBox、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、および11個のリファレンス（シェル、絶対に推奨してはならないこと、ストレージとパス、ビルド、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の場合、プロジェクト内に解凍するか（1行目）、すべてのプロジェクトで使用するためにホームフォルダーに解凍します（2行目）：
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機では、所有者が有効なデジタル署名のないアプリを許可している場合にのみインストールされますが、このスキルではそれを推奨することは決してありません。
ライセンス
このスキルのテキストはクリエイティブ・コモンズ 表示 4.0 国際 ライセンス（CC BY 4.0）のもとでライセンスされています。クレジット表記「QNAP guidelines skill by QNAP Club Poland / qnaputilities.com, CC BY 4.0」、ライセンスへのリンク、変更を加えた場合の注記を含めることで、目的を問わず共有および翻案が可能です。zipファイル内のLICENSEに正式な利用許諾条項が記載されています。このスキルを同梱するパッケージであるBucket & Code Server IDEは、独自のライセンスを維持します。