Community寫作與編輯github.com

SimaAlexandru99/agentscan

靜態分析代理設定檔,找出鉤子腳本遺失、MCP/技能與磁碟不一致等問題。無需網路。

agentscan 是什麼?

agentscan 是一個唯讀的靜態分析工具,專為 AI 代理(如 Claude Code、Cursor 等)的設定檔而設計。它會掃描 `.claude/`、`.commandcode/`、`.agents/`、`.mcp.json` 或 `skills-lock.json` 等目錄與檔案,尋找鉤子(hook)腳本遺失、技能或 MCP 設定與磁碟實際內容不符等問題。工具完全不需網路連線,也不依賴模型猜測,因此結果純粹基於事實,適合在 CI/CD 流程或開發者工作流程中使用。它會輸出結構化的報告,方便代理直接處理修復,尤其 `claude.hook.missing-script` 這類錯誤必須優先解決。對於沒有實際專案的情況,`demo` 模式會建立臨時環境並自動清理。支援的平台包括 Claude Code、Cursor、Codex 及通用 `.agents/` 目錄設定。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add SimaAlexandru99/agentscan

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

agentscan 是做什麼的?

唯讀的代理設定精靈。發現結果皆為事實。

使用時機

  • 處理 Hook、技能、MCP 或 AGENTS.md 時
  • 當有人說某個守衛(guard)已啟用,但你尚未驗證其腳本是否存在時
  • 當 PR 涉及 .claude/、.commandcode/、.agents/、.mcp.json 或 skills-lock.json 時

執行方式

從儲存庫根目錄執行:

npx @chimix/agentscan@latest --output prompt

--output prompt 是傳遞給負責修復的代理的交接格式。請勿跳過 claude.hook.missing-script(錯誤)。

若無現成專案:

npx @chimix/agentscan@latest demo

demo 會建立一個一次性測試環境,輸出報告後自動刪除該環境。

避免做的事

  • 不要輸出掃描的目錄樹結構
  • 不要用模型猜測某個鉤子是否有效
  • 不要比對技能 frontmatter 中的 name 與其目錄名稱,也不要驗證模型 ID

相關技能