Agnix agent config linter

Agnix agent config linter

一句话结论

agent-sh/agnix 把 CLAUDE.md、AGENTS.md、SKILL.md、hooks、MCP 配置等 agent 配置文件当成可 lint 的工程制品，而不是“给模型看的自然语言”。这对 llm-wiki 的意义是：agent instructions 正在从提示词资产升级为需要 schema、规则、CI 和 autofix 的软件工程对象。

为什么对用户重要

用户的 Hermes 依赖 skills、cron prompt、wiki schema、AGENTS.md 风格规则来维持长期行为一致性。问题在于这些文件一旦格式错、字段错、触发描述过泛或跨工具语义不兼容，agent 往往不会报错，而是静默忽略或产生“差一点正确”的行为。Agnix 的核心价值正是把这种静默失败变成可见诊断。

这与 Harness-Engineering 的方向一致：harness 不只包括工具调用和执行门禁，也包括对 agent 配置本身的静态约束。没有配置 lint，技能生态会出现“看似安装、实际不触发”“一个工具可用、另一个工具失效”“错误规则被模型进一步放大”等隐性风险。

机制 / 一阶原理

Agnix 声称覆盖多种 agent 配置：Claude Code、Codex CLI、OpenCode、Cursor、Copilot 等，检查 CLAUDE.md、AGENTS.md、SKILL.md、hooks、MCP 配置和相关 agent 文件。README 给出的示例包括：

• 泛化无效指令如 “Be helpful and accurate” 被标为 warning；
• skill 名称不符合小写 hyphen 格式被标为 error；
• 部分问题可 --fix 自动修复；
• 支持 CLI、编辑器扩展、CI / GitHub Action 和 playground。

一阶原理是：当 agent 行为越来越依赖外部可编辑配置时，配置错误的成本会被 agent 自动化放大；因此配置层必须像代码一样具备静态检查、版本化、自动修复和 CI gate。

与既有 wiki 概念的关系

• 对 External-Agent-Skills-Design-Patterns：补充“设计 checklist 需要机器校验”。过去 checklist 多由人或 agent 审读；Agnix 指向 lintable skills。
• 对 Agent-Skill-Discovery：发现外部技能后不应直接安装，应该先跑配置 lint 或至少按 lint 规则审查触发、schema、权限边界。
• 对 AGENTS.md-Context-Files：证明 AGENTS.md 已经成为跨工具 context/control 文件，随之需要规范与校验。
• 对 Agentic-Coding：agentic coding 的稳定性不仅取决于模型与代码评测，也取决于 instructions 配置是否被正确加载。

对 Hermes / llm-wiki 的可执行启发

1. 后续在安装或改写外部 skill 前，把“agent config lint”作为检查项；若没有安装 Agnix，也应在 wiki 页面中手工记录触发字段、禁止场景、frontmatter/schema、权限边界和验证方式。
2. llm-wiki 的技能/cron prompt 可逐步形成自己的 lint checklist：是否有明确触发、是否要求 orientation、是否禁止编造、是否规定 raw/hash/index/log/reindex、是否有 [SILENT] 条件。
3. 对用户的 agent workflows，可把 prompt 与 rules 纳入 CI 思维：不是“写完就相信”，而是通过 lint、样例触发测试、真实任务回放来验证。
4. 对跨工具技能生态，优先关注那些同时提供 schema、lint、package manager、lockfile 或 CI 的项目；单纯堆 skills 数量的仓库应降权。

失败模式与边界

• 规则覆盖不等于语义正确：lint 能发现格式与常见坏味道，不能证明 skill 会在真实任务中产生好结果。
• 过度 autofix 风险：自动修复 agent instructions 可能改变语义，低风险格式修复可以自动化，高语义修复仍需人工/agent review。
• 跨平台规范漂移：不同 agent 平台的配置格式会快速变化，lint 规则若不更新也会误报或漏报。
• 工具信任边界：Agnix 本身是外部工具，正式接入 Hermes 流程前应审查发布来源、安装方式和最小权限。

深度判断

值得晋升为 source 页面，因为它不是单个工具新闻，而是揭示了 agent 工程化的一条趋势：prompt/skill/context 文件正在变成可验证配置层。该趋势能直接改进用户的 llm-wiki 自我维护流程，尤其是减少“cron prompt 看似正确但执行偏移”“skill 看似安装但不触发”的长期隐性成本。

写入记录

• 2026-07-01 15:00 CST：新增 source 页面，分析 Agnix 对 agent 配置 lint、技能生态质量门禁和 Hermes 工作流 QA 的启发。