mcpField
A
agnix

agnix

github.com/agent-sh测试与质量462137 次安装今天更新
代码仓库

关于 agnix

agnix 是用于检查 Agent 配置文件的命令行 Linter，适合在多种编码和 Agent 工具中验证工作流。它检查技能、钩子、MCP、记忆和插件配置，并可预览或应用安全修复。

主要功能

  1. 01检查 Agent 配置文件
  2. 02验证技能、钩子、MCP 和记忆
  3. 03指定目标编码工具
  4. 04预览或应用安全修复
  5. 05监视文件并输出 JSON

适用场景

  1. 01工作流变更前检查配置
  2. 02验证 MCP 配置文件
  3. 03发现技能命名和触发问题
  4. 04预览项目中的修复

MCP 相关

agnix 会在 Agent 配置检查中验证 *.mcp.json 等 MCP 配置文件。它本身并非 MCP 服务或客户端。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agent-sh/agnix --skill agnix

安装后在 Claude Code 中输入/agnix确认已加载。

详细介绍

agnix

在工作流出问题之前，检查 Claude Code、Codex CLI、OpenCode、Kiro、Cursor、GitHub Copilot 和其他工具中的 Agent 配置（技能、钩子、MCP、记忆、插件）。

运行

  1. 运行 agnix --version。如果尚未安装，请使用 npm install -g agnix 或 cargo install agnix-cli 安装。
  2. 运行 agnix .（或用户指定的路径）。
  3. 如果用户要求修复：运行 agnix --fix .，然后再次执行步骤 2，确认剩余问题。否则不要更改任何文件；agnix --dry-run . 可预览修复内容。

CLI 参考

命令描述
agnix .验证当前项目
agnix --fix .应用安全的自动修复
agnix --dry-run .显示将要修复的内容，不做任何更改
agnix --strict .将警告视为错误
agnix --target claude-code .针对单个工具：generic（默认）、claude-code、cursor、codex、kiro
agnix --watch .监视模式
agnix --format json .JSON 输出

支持的文件

文件类型示例
技能SKILL.md
记忆CLAUDE.md、AGENTS.md
钩子.claude/settings.json
MCP*.mcp.json
Cursor.cursor/rules/*.mdc
Copilot.github/copilot-instructions.md

输出

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)

常见修复

问题解决方案
技能名称无效使用小写字母和连字符：my-skill
指令过于笼统删除“be helpful”“be accurate”
缺少触发短语在描述中添加“Use when...”
目录与名称不匹配重命名目录，使其与 name: 字段一致

链接

评论

支持 Markdown