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 配置。