agnix — AI 编码助手配置校验器
在 AI 助手因配置错误而静默失效之前，用 455 条规则校验 CLAUDE.md、SKILL.md、hooks 和 MCP 配置，并自动修复问题。
证据显示该工具为本地静态校验器：不执行外部命令、拒绝符号链接、限制文件大小/数量/正则输入、原子写入，遥测默认关闭且经编译特性门控并有环境感知禁用。修复路径区分 --fix-safe 与 --fix-unsafe 并支持 --dry-run 预览，确认机制充分。扣分点：修复无显式回滚/撤销机制，仅有原子写入保证；README 中嵌入 tiyuvta 推理服务的推广内容，且部分规则来源声称依赖 --explain 命令而未在源文件中直接展示。
工作区版本一致（0.52.2 贯穿 Cargo.toml、pyproject shim 与同步脚本说明），CLI 提供分级错误输出、帮助提示、--explain 规则解释，自洽性好。扣分点：依赖 serde_norway 分支（虽注明原因，但属上游替代）、tokio 1.52.3 等具体版本的可获得性未在证据中验证；Windows 平台行为被自述为验证不足。
明确面向多工具（Claude Code、Cursor、Copilot、Kiro、MCP 等）开发者与 CI 场景，支持 VS Code/JetBrains/Neovim/Zed 与 GitHub Action，能力边界通过 target/tools 过滤和已知限制说明清晰。扣分点：--target 被自身标注为 legacy 预设且主要影响部分规则，过滤精度依赖 tools 列表，触发边界描述部分含糊。
信息架构清晰（crates 划分、文档站、规则表）、安装说明多渠道完备、命名稳定、SECURITY.md 列出已知限制（TOCTOU、平台差异等）非常坦诚、CHANGELOG 更新有 CI 强制、版本同步有脚本。扣分点：License 元数据为 Apache-2.0 而 README/Cargo 为 MIT OR Apache-2.0，存在不一致；FAQ 缺失；维护者身份未经验证，安全响应承诺（48小时）仅为声明。
输出可用性高（github 注解格式、--strict、编辑器集成、LSP）；解决真实痛点（skills 不触发、跨工具格式漂移），边际价值明确；本地工具成本极低而收益直接。未见明显扣分项，但 455 规则的实际有效性未经执行验证，故保守不给满置信而非扣分。
规则计数、来源声称（官方规范、学术研究）与 --explain 机制提供一定可追溯性；CI/cargo-audit/CodeQL/fuzz 的存在可通过工作流文件部分佐证。扣分点：455 规则与外部引用（Vercel、Stack Overflow 调查）的准确性无法在静态审阅中核实，事实与营销性推断的分离依赖读者自行判断，README 语气偏营销。
- License 元数据（Apache-2.0）与仓库声明（MIT OR Apache-2.0）不一致，合规使用前请以仓库内 LICENSE 文件为准。
- --fix-unsafe 会应用低置信度修复，建议先使用 --dry-run --show-fixes 预览；修复无自动回滚，请依赖版本控制。
- 维护者身份未经注册表验证；安全联系邮箱为个人 Gmail 地址。
- Windows 平台的符号链接行为自述验证不足；TOCTOU 窗口已知存在。
- 455 条规则的数量与外部研究引用未经独立核实，本评估为静态审阅，未执行任何校验。
这个 Agent 能做什么，适合哪些场景？
agnix 是一个面向 AI 编码助手配置的静态校验工具，定位为“缺失的 linter 与 LSP”。它提供 455 条规则，覆盖 Agent Skills、Claude Code、GitHub Copilot、Cursor、Kiro、MCP、AGENTS.md、Cline 和 Gemini CLI 等工具的配置文件。项目使用 Rust 编写，由多个 workspace crate 组成：agnix-core（校验引擎）、agnix-cli（命令行）、agnix-lsp（语言服务器）、agnix-mcp（MCP 服务器）和 agnix-wasm（浏览器运行时绑定）。诊断结果带修复建议，支持 --fix、--fix-safe、--fix-unsafe 多级自动修复模式，也可通过 --dry-run 预览修复差异。编辑器集成覆盖 VS Code、JetBrains、Neovim 和 Zed，并提供官方 GitHub Action 用于 CI 中的配置校验。
agnix 扫描仓库中的 agent 配置文件（CLAUDE.md、AGENTS.md、SKILL.md、.cursor/rules/*.mdc、*.mcp.、.kiro/ 下的各类文件等），依据 knowledge-base/rules. 生成的规则元数据逐条校验，输出带行列位置的诊断（如“Invalid name 'Review-Code'”），并提示可修复项。CLI 命令包括 agnix .（校验当前目录）、--fix 系列参数应用修复、--strict 将警告视为错误、--format github 输出 GitHub Actions 注解、agnix explain MCP-018 解释某条规则及其依据。它同时提供 LSP 语言服务器供编辑器实时诊断，MCP 服务器二进制供 agent 生态调用，以及 WASM 绑定支持浏览器内的在线 playground。
- 使用 Claude Code 的开发者：SKILL.md 语法稍有错误就可能导致技能无法触发，需要每次提交前校验 frontmatter 字段。
- 同时使用 Cursor、Claude Code 和 Copilot 的团队：各工具配置格式不同，需要在 CI 中统一校验防止某工具下配置静默失效。
- 维护 MCP 配置的工程师：用 agnix explain MCP-018 查看规则依据，排查 *.mcp. 中的错误。
- 在 VS Code 或 JetBrains 中编写 agent 配置的开发者：通过 LSP 扩展获得实时诊断与自动修复。
- 平台工程团队：通过 agent-sh/agnix GitHub Action 在流水线中强制校验所有 agent 配置文件。
这个 Agent 有哪些优点和局限？
- 规则覆盖面广：455 条规则覆盖 9 类工具（Claude Code 53 条、Kiro 53 条、Agent Skills 31 条等），是目前源中唯一同时校验 CLAUDE.md、SKILL.md、hooks、MCP 和 Kiro 的工具。
- 规则来源可追溯：规则源自官方规范、学术研究和真实故障模式，agnix explain 命令可查看每条规则的依据。
- 三级自动修复（--fix / --fix-safe / --fix-unsafe）加 --dry-run 预览，可在 CI 与本地分别采用不同安全级别。
- 多形态交付：CLI、LSP、MCP 服务器、WASM 绑定与 VS Code/JetBrains/Neovim/Zed 扩展一应俱全，并有官方 GitHub Action。
- Rust 核心 + npm/Homebrew/pip 多发行渠道意味着采用团队需选定安装路径，且 agnix-cli（Cargo 包名）与 npm 包名不同，可能引起混淆。
- 部分 Copilot（6 条）和 Cline（4 条）工具规则数量明显少于 Claude Code 和 Kiro，对以这些工具为主的团队覆盖有限。
- --fix-unsafe 会应用中低置信度修复，不加区分使用可能引入不当改动，需要团队制定修复策略。
- 仓库未提供基准测试或误报率数据，规则对项目实际代码质量的改进程度缺乏量化证据。
如何安装或部署这个 Agent？
任选其一：
- npm（推荐，全平台）：npm install -g agnix
- Homebrew：brew tap agent-sh/agnix && brew install agnix- pip：pip install agnix（或 uvx agnix . 免安装运行）
- Cargo：cargo install agnix-cli也可从 GitHub Releases 下载预编译二进制。
编辑器扩展：VS Code 与 JetBrains 分别从各自 Marketplace 安装（VS Code 项目名为 avifenesh.agnix），Neovim 使用 agent-sh/agnix 插件仓库，Zed 在扩展中搜索 agnix。
如何使用这个 Agent？
首次运行：
bash
agnix . # 校验当前目录
agnix --fix . # 应用安全修复
agnix --dry-run --show-fixes . # 预览修复差异
agnix --strict . # 严格模式（警告视为错误）
agnix --format github . # GitHub Actions 注解格式输出
agnix explain MCP-018 # 解释某条规则及其证据
agnix --target claude-code . # 针对特定工具的规则过滤
CI 集成：
yaml
- name: Validate agent configs
uses: agent-sh/agnix@v0with:
target: 'claude-code'