agnix
Agent 配置文件 lint 工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agnix。 它的用途是：Agent 配置文件 lint 工具 完整的 Skill 内容见：https://321skill.com/skills/agnix/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
对 AI 说：'检查当前项目中的所有 Agent 配置文件是否合规，使用 agnix 进行 lint。' 它会自动扫描并输出报告中每个文件的错误类型、行号及建议修复方式。你也可以在 VS Code 中打开 CLAUDE.md 文件，agnix 扩展会实时高亮显示不规范的字段，并提示修改方向。
介绍
这个 Skill 解决了 Agent 配置因语法错误而被 AI 工具静默忽略的问题。Vercel 的研究发现，技能在不正确的语法下触发率为 0%，而开发者常因一个字段写错导致整个配置失效却毫无察觉。agnix 提供 437 条规则，覆盖 Claude Code、Codex CLI、OpenCode、Cursor、Copilot 等主流 AI 工具的 CLAUDE.md、SKILL.md、hooks、MCP 配置等文件格式，从根源上避免“几乎正确”的配置陷阱。
使用方式非常简单：你可以通过 CLI 命令 npx agnix 或 agnix 对当前目录下的 Agent 配置文件进行扫描，它会自动识别并报告所有不合规项，并支持 --fix 自动修复。此外，它还提供了 VS Code、JetBrains、Neovim、Zed 等编辑器插件，让你在编辑时实时获得 lint 反馈。你也可以将它集成到 CI/CD 中（GitHub Action），确保每次提交的配置都经过校验。
它非常适合使用多 AI 工具组合的团队或个人开发者，尤其是那些同时使用 Cursor、Claude Code、Copilot 等工具，需要统一管理 Agent 配置的人群。对于智能体开发者、全栈工程师和运维工程师来说，agnix 能有效减少因配置错误导致的调试时间浪费，提升团队协作中配置的一致性。
建议在项目初始化时就引入 agnix，并配合 Git Hook 或 CI 自动运行。需要注意的是，它主要针对 Agent 配置文件的语法和语义规则校验，不涉及代码逻辑或业务功能的测试。如果你的配置文件中使用了自定义字段或非标准语法，可能需要先对照官方规范确认。
常见问题
agnix 能检查哪些文件？
支持 CLAUDE.md、SKILL.md、hooks、MCP 配置文件以及 Copilot 的 .github/copilot-instructions.md 等，覆盖 437 条规则。
可以自动修复错误吗？
是的，使用 --fix 参数可以自动修复大部分语法和格式错误，但部分语义问题需要人工确认。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agnix/raw/index.md 读取 agnix 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agnix/raw/index.md（查看排版版本）