你的 Skill 为什么从来不触发？可能是配置写错了——agnix 来救场

最近有个数字让我挺震惊的——Vercel 的调研发现，Skill 配置写错语法后，触发率直接掉到 0%。你的 SKILL.md 写得很用心，但 AI 根本读不到，等于白干。

这个问题，agnix 专门来解决。

它是什么

agnix 是一个专门给 AI 编程助手做配置校验的 linter，说白了就是：把你的 CLAUDE.md、SKILL.md、MCP 配置、hooks 文件全扫一遍，找出会导致 AI 失效的错误。

支持的工具目前最全：Claude Code、Cursor、GitHub Copilot、Kiro、Codex CLI、Gemini CLI……加起来一共有 422 条规则，而且还在以很快的速度更新。

能干什么

举几个它能抓出来的典型问题：

• Skill 名字用了大写或空格（规范要求全小写加连字符）
• SKILL.md 缺少触发词（没有 “Use when…” 描述）
• 塞了一堆 “Be helpful” “Be accurate” 这类废话，AI 本身就知道，白占 token
• MCP 配置文件格式错误
• CLAUDE.md 和 SKILL.md 之间存在语义冲突

它会输出具体行号、错误级别（error/warning）、修复建议，而且大部分问题支持 自动修复，加个 --fix 参数就行。

怎么用

安装非常方便：

npm install -g agnix   # 推荐，跨平台
# 或者
cargo install agnix-cli
# 或者
brew tap agent-sh/agnix && brew install agnix

使用也简单：

agnix .              # 校验当前目录
agnix --fix .        # 自动修复问题
agnix --strict .     # 把警告也当错误（CI 模式）
agnix --target claude-code .   # 只检 Claude Code 相关规则

适合谁

如果你同时用多个 AI 编程工具（Cursor + Claude Code + Copilot），或者团队里多人维护 Skill 配置，agnix 几乎是必备的——它能抓到那种「看起来正常但 AI 其实读不懂」的配置错误，省掉大量调试时间。

追求稳定 CI 的团队可以直接上 GitHub Action，每次 PR 自动跑一遍，配置不过关不让合并。

用 Rust 写的，性能也不错，大项目跑起来不会有负担。

GitHub：https://github.com/agent-sh/agnix

GitHub: https://github.com/agent-sh/agnix