agnix 配置检查器

这个 Agent 能做什么，适合哪些场景？

agnix 是面向 AI 编程助手配置的静态检查器和语言服务器，覆盖 CLAUDE.md、AGENTS.md、SKILL.md、钩子、MCP 配置及其他代理文件。它提供 456 条规则，支持 Claude Code、Codex CLI、OpenCode、Cursor、Copilot、Kiro、Cline、Gemini CLI 和 Agent Skills 等格式。项目采用 Rust 工作区架构，包含共享验证引擎、CLI、LSP、MCP 服务器以及 WebAssembly 绑定。检查结果包含文件位置、错误或警告级别、规则标识、修复建议和可自动修复状态，并支持安全修复、完整修复、严格模式及 GitHub Actions 注释格式。它可以作为本地命令、编辑器扩展、GitHub Action、浏览器 Playground 或运行时集成使用，不负责执行模型推理或生成代码。

agnix 读取项目目录中的受支持配置文件，将内容交给 agnix-core 验证引擎，并依据 agnix-rules 中由 knowledge-base/rules.json 生成的规则元数据报告诊断。CLI 可通过 agnix . 扫描目录，输出文件、行列、严重级别、规则说明和修复提示；--strict 将警告视为错误，--format github 生成 GitHub Actions 注释。--fix 和 --fix-safe 应用安全修复，--fix-unsafe 还会应用中等及低置信度修复，--dry-run --show-fixes 则以内联差异预览变更。agnix explain MCP-018 可展示指定规则及其证据。除 agnix-cli 外，仓库还提供 agnix-lsp、agnix-mcp 和 agnix-wasm，分别服务于编辑器诊断、MCP 接入和浏览器或运行时集成。

1. 同时使用 Claude Code、Cursor 和 Copilot 的团队，在提交前检查各工具采用的不同配置格式。
2. 维护 SKILL.md 的技能作者，排查名称、字段或语法错误导致技能无法触发的问题。
3. 负责 CI 的工程团队，通过 GitHub Action 阻止含配置错误的变更进入主分支。
4. 希望边编辑边发现问题的开发者，通过 VS Code、JetBrains、Neovim 或 Zed 集成获取诊断。
5. 维护 MCP、钩子或代理配置的工具作者，在发布前预览并应用可用的自动修复。
6. 需要在浏览器或自有运行时中嵌入验证能力的开发者，使用项目提供的 WebAssembly 绑定。

如何安装或部署这个 Agent？

npm 是文档推荐且面向所有平台的安装方式：

npm install -g agnix

macOS 或 Linux 可通过 Homebrew 安装：

brew tap agent-sh/agnix && brew install agnix

也可使用 pip：

pip install agnix

如需从 Rust 工具链安装 CLI：

cargo install agnix-cli

首次检查不需要 API 密钥或模型凭据。文档未给出最低 Node.js、Python 或 Rust 版本，因此采用相应安装方式前需要自行确认本地运行时可用。

如何使用这个 Agent？

在待检查项目的根目录运行：

agnix .

应用安全修复：

agnix --fix .

预览修复及内联差异而不直接修改文件：

agnix --dry-run --show-fixes .

将警告作为错误并为 GitHub Actions 生成注释，可分别运行：

agnix --strict .

agnix --format github .

查询具体规则的说明和证据：

agnix explain MCP-018

GitHub Actions 中可加入：

- name: Validate agent configs
  uses: agent-sh/agnix@v0
  with:
    target: 'claude-code'

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.59.1 2026-10-23
   发布说明摘录

   Security - Update Tokio to 1.53.3 for the AsyncFd I/O-safety advisory (RUSTSEC-2026-0386). - Update rustls-webpki to 0.103.16 and webpki-root-certs to 1.0.10 to reject distrusted emSign certificate chains (RUSTSEC-2026-0382, RUSTSEC-2026-0383). - Update the website's follow-redirects lockfile to 1.16.1 (GHSA-q3jh-wrc6-jgq8, GHSA-8r9p-f939-6h3c). Fixed - PE-006 checks native AGENTS.md when Claude Code is explicitly selected, including mixed-tool runs. Unscoped shared files retain their existing checks. The warning identifies Claude prompting guidance. (#1705) …

   在 GitHub 查看 ↗
2. v0.59.0 2026-10-17
   发布说明摘录

   Migration - Roo Code support is removed (Roo Code shut down on 2026-05-15): ROO-001 to ROO-006 and RC-SK-001 are retired, .roo/ files get only the generic checks, rules.roo_code is a deprecated no-op, and tools = ["roo-code"] only warns. Remove those IDs and settings from your config. - Remove the rule IDs retired in this release from disabled_rules, severity overrides and explicit rule lists: AGM-003, AGM-005, CC-AG-013, CC-HK-017, CC-MEM-007, CC-MEM-009, CC-OS-005, CC-SET-014, CC-SET-015, CC-SET-021, CC-SET-024, CC-SET-032, CDX-001, CDX-002, CDX-003, CDX-AG-004, CDX-AG-007, C …

   在 GitHub 查看 ↗
3. v0.58.0 2026-10-16
   发布说明摘录

   Migration - Remove retired IDs REF-004, OC-DEP-004, CC-MEM-005, CC-MEM-006, CC-MEM-008, AGM-006, and MCP-005 from disabled_rules, severity overrides, and explicit rule lists. Generic-instruction advice remains under PE-005; unrelated retirements have no replacement. - Quoted-boolean repairs now require --fix-unsafe. Review the proposed values first: enabling previously ignored settings can change behavior or security policy. Plain --fix leaves these strings unchanged. Removed - Retire REF-004: Claude Code supports non-Markdown imports, including @package.json. …

   在 GitHub 查看 ↗

常见问题