plugin-checker

plugin-checker 是為 Claude Code 開發擴充功能的開發人員所設計的必要品質保證工具。它提供了一套結構化的審核方法，用於審查外掛程式目錄，驗證其是否符合清單、目錄結構和檔案命名慣例等嚴格要求，以利於正確整合。透過自動偵測常見錯誤（例如 plugin.json 中的無效 JSON 語法、組件檔案位置錯誤，或是代理程式與技能中不符合規定的 frontmatter），該工具能顯著減少故障排除時間，確保外掛程式已達到發布標準。

• 驗證 .claude-plugin/plugin.json 的 JSON 語法、名稱欄位合規性 (kebab-case) 以及所需的作者元數據。

• 審核目錄配置，確保代理程式、技能、指令和鉤子（hooks）皆依照市場規範放置。

• 對 .md 檔案中的 YAML frontmatter 進行深度檢查，確保 name、description 以及 model/color/tool 配置等必要欄位存在且有效。

• 驗證 hooks.json 結構，確保如 PreToolUse 和 SessionStart 等事件名稱正確對應至可執行腳本。

• 強制執行路徑可移植性，檢查是否使用 ${CLAUDE_PLUGIN_ROOT} 並確保腳本具有正確的 shebang 標頭。

• 偵測常見的配置反模式，例如寫死的絕對路徑、遺失的說明文件需求以及不當的檔案巢狀結構。

• 非常適合開發 Claude Code 生態系統的開發人員與儲存庫維護者。

• 建議在提交外掛程式或更新現有專案結構之前執行審核指令。

• 可輕鬆整合至 CI 流程中，自動驗證外掛程式清單的結構並進行 Lint 檢查。

• 有助於排查常見錯誤，例如外掛程式載入失敗、觸發條件遺失或鉤子功能無預期運作。

• 提供清晰的報告格式，將發現的問題分類為嚴重問題與警告，利於快速修復結構缺陷。