技能说明
适合技能作者和多 Agent 项目做发布前检查、团队治理与持续集成。覆盖 Claude Code、Codex CLI、Cursor、GitHub Copilot 等；默认只检查，自动修复前应先预览并人工确认。
关于此技能
Agnix Agent 配置校验技能把 agent 配置当成可检查的工程资产，在发布或提交代码前检查 SKILL.md、CLAUDE.md、AGENTS.md、MCP 配置、Hooks、Cursor 规则和 Copilot 配置。它提供 451 条规则、问题解释和自动修复入口。
核心能力
多客户端检查
覆盖 Agent Skills、Claude Code、Codex CLI、Cursor、GitHub Copilot、Gemini CLI、Kiro、Cline、MCP 和 AGENTS.md。
问题定位与解释
按文件、行号和规则输出错误或警告，并可用 explain 查看规则依据。
安全修复流程
先用默认模式或 dry-run 预览，再按需使用 --fix 或 --fix-safe；支持 GitHub Actions 和编辑器集成。
适用场景
发布技能前自检
检查名称、描述触发词、目录匹配和格式问题，避免 Agent 静默忽略技能。
多 Agent 项目治理
统一检查 Claude、Codex、Cursor、Copilot 等客户端的配置差异。
持续集成守门
在 GitHub Actions 中自动验证配置，让错误在合并前暴露。
使用步骤
- 01
第一步：安装工具
按项目 README 选择 npm、Homebrew 或 Cargo 安装 agnix，并确认命令可用。
- 02
第二步：先做只读检查
在项目目录运行 agnix . 或指定客户端目标，阅读文件、行号和规则说明。
- 03
第三步：审阅修复
需要改动时先使用 --dry-run 或 --fix-safe 查看变更，再人工确认后重新检查。
常见问题
Agnix 是做什么的？+
它是 Agent 配置检查工具，重点是发现格式、命名、触发条件、工具配置和客户端兼容问题，不是模型或代码质量评分器。
会自动修改项目文件吗？+
默认检查不会修改；--fix 会写入修复结果，建议先 dry-run 并保留版本控制记录。
支持哪些 Agent？+
README 列出 Claude Code、Codex CLI、Cursor、GitHub Copilot、Gemini CLI 等多个工具；具体规则以当前版本文档为准。
安装前检查
把兼容性、来源和安装入口先看清楚，再放进自己的工作流。
Codex · Claude Code · Cursor
已提供来源链接
命令可直接复制
2026/08/26
安装提醒：这项技能可能涉及网络、脚本、文件或凭据权限，安装前请先阅读 SKILL.md，并确认它需要哪些权限。
npm install -g agnix