• Skill 名称：agnix
• 简称：agnix
• 来源：社区第三方（由 agent-sh 开发）
• 运行宿主：Claude-Code CLI
• 核心定位：用于对 AI Agent 配置文件进行静态检测与自动修复，支持多达 447 条校验规则，适用于开发、调试和 CI 流程中的配置质量保障。

🧩 内部核心组成

agnix 主要通过 CLI 工具提供核心能力，内部包含以下组成部分：

• 校验引擎：基于 Rust 编写的核心校验逻辑，支持多类型配置文件分析
• 规则库：内置 447 条校验规则，涵盖语法、命名、结构等多个维度
• 自动修复机制：支持对可修复问题的一键自动处理

支持校验的文件类型：

主要 CLI 命令：

🛠 安装与启用方式

前置依赖：

• Rust 工具链（用于源码编译安装）
• 或直接下载预编译二进制文件

安装步骤：

# 通过 Cargo 安装
cargo install agnix-cli

# 验证安装
agnix --version

启用方式：

在项目根目录执行校验命令：

agnix .          # 基础校验
agnix --fix .    # 校验并自动修复

📋 标准工作流

1. 用户触发：用户在 CLI 中请求校验 Agent 配置（如"lint my agent configs"）
2. 环境检查：Skill 检查 agnix CLI 是否已安装，如未安装则提示安装
3. 配置扫描：递归扫描项目目录下的所有支持配置文件
4. 规则应用：对每个文件应用相应的 447 条校验规则
5. 问题报告：输出详细的错误和警告信息，包括文件位置、问题类型和修复建议
6. 自动修复：如使用 --fix 参数，自动修复可修复的问题
7. 验证确认：修复后重新校验确认问题已解决

⚠️ 关键限制、缺陷、注意事项

• 平台限制：仅支持 Claude-Code CLI 环境，不支持其他 Agent 平台
• 依赖要求：需要 Rust 环境或预编译二进制，增加部署复杂度
• 规则覆盖：虽然规则数量多（447条），但可能无法覆盖所有自定义配置场景
• 修复能力：自动修复仅适用于部分规则，复杂问题仍需手动处理
• 生产环境：适合开发和测试环境使用，生产环境需谨慎评估修复操作的影响
• 性能考虑：大型项目可能存在扫描性能问题，建议在 CI 中分阶段使用

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景：

• AI Agent 项目开发阶段的配置质量检查
• 团队协作时的配置规范统一
• CI/CD 流水线中的自动配置校验
• 新手学习 Agent 配置时的错误排查
• 多项目间的配置标准化迁移

❌ 不适合场景：

• 非 Claude-Code CLI 的 Agent 项目
• 高度定制化、非标准配置的项目
• 对自动修复有严格管控要求的生产环境
• 需要实时校验的交互式开发场景（watch 模式除外）
• 缺乏 Rust 环境或无法安装二进制文件的受限环境