agent-sh/agnix

The missing linter and lsp for AI coding assistants. Validate CLAUDE.md, AGENTS.md, SKILL.md, hooks, MCP. Plugin for all major IDEs included, with autofixes.

解決的問題

AI Agent 配置（例如 Claude Code、Cursor 或 Copilot 的配置）經常因為語法錯誤或格式不正確而導致靜默失敗。一個微小的錯誤就可能導致 Agent 的技能失效或產生錯誤的結果。由於不同的工具使用不同的格式，在一個工具中可以正常運行的配置可能會在另一個工具中失效。

工作原理

Agnix 使用從官方規範與實際損壞模式中收集的 440 多個規則集，來驗證 CLAUDE.md、SKILL.md 與 MCP 配置等設定檔。可以透過 CLI 使用，透過 GitHub Actions 整合至 CI/CD 流水線，或直接在 VS Code、JetBrains、Neovim 與 Zed 等程式碼編輯器中使用。

適用對象

正在構建或使用 AI 驅動的編碼工具與 Agent 的開發人員及團隊，他們希望確保其 Agent 的指令、技能與工具配置在語法上是正確的，並且在不同的 AI 平台之間具有相容性。

亮點

  • 多工具支援： 驗證 Claude Code、Cursor、GitHub Copilot、MCP、Gemini CLI 等的配置。
  • 自動修復能力： 提供安全與非安全模式，自動修正常見的配置錯誤。
  • 編輯器整合： 為熱門 IDE 提供 LSP 支援，實現即時診斷。
  • 支援 CI/CD： 包含 GitHub Action，可以在合併前捕捉損壞的 Agent 配置。