plugin-best-practices

此技能是 Claude Code 插件開發者的主要架構驗證器。它提供自動化監督，確保插件符合既定的最佳實踐、結構要求與介面模式。專為在 Claude Code 生態系統中構建專業代理、技能與 MCP 伺服器的開發者所設計，此工具能強制執行整個插件生命週期的一致性，從清單檔案建立到最終部署就緒。對於維持程式碼品質、確保透過漸進式揭露來遵守 Token 預算，以及驗證工具調用是否符合安全與功能準則至關重要。

• 針對檔案佈局、目錄命名與 kebab-case 規範的自動化結構驗證。

• 根據架構要求與必要元數據欄位進行全面的清單檔案驗證。

• 針對技能與代理組件進行嚴格的前置內容審核，確保使用第三人稱語氣與準確的觸發短語。

• 工具調用分析，用於檢測並解決隱式與顯式工具調用之間的模式衝突。

• 漸進式揭露合規檢查，確保 SKILL.md 檔案保持在 5k Token 預算內，以便高效加載上下文。

• RFC 2119 要求等級執行，以確保技術文件明確無歧義。

• 開發者應在啟動新插件專案或準備發佈現有插件時觸發此技能。

• 工作流程包含五個順序檢查：結構、清單、前置內容、工具調用與 Token 預算。

• 預期的輸出包括詳細記錄通過檢查的項目，以及針對檢測到的任何違規事項的具體可執行修復建議。

• 整合方式無縫簡便；只需透過提供的 Python 腳本執行驗證器，或在開發環境中調用該技能即可。

• 限制條件包括嚴格遵守插件組件模型，其中指令型技能、知識型技能、代理與 MCP 伺服器各有獨特的實作要求。

• 請務必使用顯式命名慣例（plugin-name:component-name），以確保跨插件引用的正確解析。