agnix
在代理配置破坏工作流之前对其进行校验。支持对 Claude Code、Cursor、GitHub Copilot 和 Codex CLI 中的 Skills、Hooks、MCP、Memory、Plugins 进行验证。
使用时机
当用户要求以下内容时调用：
- "检查我的代理配置"
- "验证我的技能"
- "检查我的 CLAUDE.md"
- "验证钩子"
- "检查 MCP 配置"
- "修复代理配置问题"
支持的文件
| 文件类型 | 示例 |
|---|---|
| Skills | SKILL.md |
| Memory | CLAUDE.md, AGENTS.md |
| Hooks | .claude/settings.json |
| MCP | *.mcp.json |
| Cursor | .cursor/rules/*.mdc |
| Copilot | .github/copilot-instructions.md |
执行步骤
1. 检查 agnix 是否已安装
agnix --version
如果未找到，请安装：
cargo install agnix-cli
2. 进行校验
agnix .
3. 如果发现问题且请求了 --fix
agnix --fix .
4. 重新校验以确认
agnix .
CLI 参考
| 命令 | 描述 |
|---|---|
agnix . | 校验当前项目 |
agnix --fix . | 自动修复问题 |
agnix --strict . | 将警告视为错误 |
agnix --target claude-code . | 仅使用 Claude Code 规则 |
agnix --target cursor . | 仅使用 Cursor 规则 |
agnix --watch . | 监听模式 |
agnix --format json . | JSON 格式输出 |
输出格式
CLAUDE.md:15:1 warning: 通用指令“要有帮助” [可修复]
help: 移除通用指令。Claude 已经知道这一点。
skills/review/SKILL.md:3:1 error: 无效名称 [可修复]
help: 仅使用小写字母和连字符
发现 1 个错误，1 个警告（2 个可修复）
常见问题及修复
| 问题 | 解决方案 |
|---|---|
| 无效的技能名称 | 使用小写字母和连字符：my-skill |
| 通用指令 | 移除“要有帮助”、“要准确”等 |
| 缺少触发短语 | 在描述中添加“使用时机：...” |
| 目录/名称不匹配 | 将目录重命名为与 name: 字段一致 |