用途
agnix 用于在智能体配置出问题、影响工作流之前对其进行 lint（静态检查）与校验。当用户提出“lint agent configs”“validate skills”“check CLAUDE.md”“validate hooks”“lint MCP”“fix agent configuration issues”“check if my SKILL.md is correct”等需求时适用。它覆盖 Claude Code、Cursor、GitHub Copilot、Codex CLI、OpenCode、Gemini CLI、Cline、Windsurf、Kiro、Amp 等 10 多种 AI 工具。
主要能力
- 校验多种配置类型：Skills（如 SKILL.md）、Memory（如 CLAUDE.md、AGENTS.md）、Hooks（如 ${STATE_DIR}/settings.json）、MCP（如 .mcp.json），以及 Cursor 的 .cursor/rules/.mdc、Copilot 的 .github/copilot-instructions.md。
- 支持自动修复（--fix）。
- 支持严格模式（--strict，将警告视为错误）。
- 支持按目标工具限定规则（--target，如 claude-code、cursor）。
- 支持监听模式（--watch，变更时重新校验）。
- 支持多种输出格式：默认文本、JSON（--format json）、SARIF（--format sarif，用于 GitHub Code Scanning）。
- 提供退出码：0 表示无错误（允许有警告），1 表示发现错误，2 表示参数无效。
- 规则按前缀分类：AS-（Agent Skills：名称格式、触发词、描述）、CC-（Claude Code：Hooks、memory、plugins）、MCP-（MCP 协议：服务端配置、工具定义）、PE-（提示工程：泛化指令、冗余）、XP-（跨平台兼容性）、AGM-（AGENTS.md 结构与章节）、COP-（GitHub Copilot 指令格式）、CUR-（Cursor MDC 格式与规则）。
使用方式
前置条件：需先安装 agnix，可用 agnix --version 检查，若未安装则执行：
cargo install agnix-cli
安装后可作为独立技能直接通过 /agnix 调用。
参数解析逻辑：从命令参数中取第一个非 -- 开头参数作为目标路径（默认 .），识别 --fix、--strict，并从 --target= 读取目标工具（默认 claude-code）。
典型流程：
- 校验项目：
agnix . - 若发现问题且需要修复：
agnix --fix . - 再次校验确认：
agnix .
CLI 参考：
agnix .：校验当前项目agnix --fix .：自动修复问题agnix --strict .：将警告视为错误agnix --target claude-code .：仅使用 Claude Code 规则agnix --target cursor .：仅使用 Cursor 规则agnix --watch .：监听模式，变更时重新校验agnix --format json .：JSON 输出agnix --format sarif .：SARIF 输出，用于 GitHub Code Scanning
输出示例：
CLAUDE.md:15:1 warning: Generic instruction 'Be helpful' [fixable]
help: Remove generic instructions. Claude already knows this.
skills/review/SKILL.md:3:1 error: Invalid name [fixable]
help: Use lowercase letters and hyphens only
Found 1 error, 1 warning (2 fixable)
常见问题与修复建议
- 无效 skill 名称：使用小写字母加连字符，如 my-skill。
- 目录名与名称不匹配：将目录重命名为与 name 字段一致。
- 泛化指令：移除“be helpful”“be accurate”等。
- 缺少触发短语：在 description 中加入“Use when...”。
集成与限制
可作为独立技能直接调用。CI 集成可参考 GitHub Action（具体内容暂未提供）。其他官方链接包括 GitHub、Rules Reference、Configuration（具体地址与内容暂未提供）。收费、价格与平台支持细节暂未提供。