Agent Skills
返回列表
🤖

代理配置 lint 与自愈

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/lint-and-autofix-agent-config-files-before-broken-prompts-hooks-or-mcp-settings-derail-runs-with-agnix。

技能介绍

要解决的问题

代理配置文件的损坏往往是"隐形"的：SKILL.md 里残留了一条空泛的通用指令、CLAUDE.md 的模板说明忘了删、hooks 的 JSON 结构有误、MCP 配置指向了一个不存在的命令。这类错误不会在启动阶段报错，而是等到 agnix 运行到一半才暴露——agent 行为跑偏或者直接中断，此时再回头排查，调试成本已经很高了。

技能如何工作

核心思路是把 agnix CLI 当作静态检查器，在运行前对代理配置文件做一轮校验和修复：

  • 覆盖范围：SKILL.md、CLAUDE.md、AGENTS.md、hooks 定义以及 MCP 配置文件，即 agent 工作流的全部关键接线
  • 问题分类：一类是结构问题，比如格式错误、无效字段；另一类是内容问题，比如空泛的通用指令，它们虽合法但会让模型行为退化
  • 修复策略：每个问题都会标注是否可自动修复（[fixable]）；你可以选择只做只读 lint，确认无误后再开启自动修复
  • 可定位的输出：校验结果带文件路径和行号，例如：
Validating .
CLAUDE.md:15:1 warning: Generic instruction 'Be helpful and accurate' [fixable]

这样的输出可以直接拿去 review，修复前先确认改动内容是否符合预期。

适用边界与注意点

  • 规则集来自 agnix 上游，覆盖度取决于其规则的成熟程度；不同 agent 框架的私有约定未必都能识别
  • 自动修复只处理标记为 [fixable] 的问题，语义层面的冲突仍需要人工判断
  • 它不替代版本控制——建议先提交当前状态，再跑修复，便于回滚
  • agnix 需要在你的运行环境中可用（终端、Neovim 等路径不同），且上游文档可能随版本变化

使用场景

  • CI 流水线触发前对仓库内 `CLAUDE.md`、`AGENTS.md` 做静态检查，避免坏元数据进入主干
  • 团队共享的 hooks 配置被改坏，需要在本地跑 lint 定位 `[fixable]` 项后一键修复
  • 接入新 MCP server 后先校验 `mcp.json`，防止运行中才暴露配置问题
  • 发布 `SKILL.md` 前做只读检查，确认没有触发 agnix 警告的通用指令

适合人员

  • 负责 agent 工作流稳定性的 SRE，需要把配置校验嵌入 CI 和本地开发流程
  • 维护 `SKILL.md`、`AGENTS.md` 的插件作者，希望发布前拦截格式与语义问题
  • 接入多个 MCP server 的后端工程师，需要快速定位 `mcp.json` 接线错误
  • 搭建 Neovim agent 环境的开发者，希望在 `require('agnix').setup()` 后有持续的配置体检