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