NotFair的AGENTS.md路由表设计解析：48个技能如何自动匹配用户意图

NotFair的AGENTS.md路由表设计解析：48个技能如何自动匹配用户意图

【免费下载链接】notfair-pluginOpen-source SEO, GEO, and marketing skills for AI agents.项目地址: https://gitcode.com/gh_mirrors/to/notfair-plugin

NotFair 是一款面向 AI 编程代理（Agent）的开源插件，内置 48 个 SEO、GEO 与营销技能。它的核心设计是一份名为AGENTS.md的技能路由表：用户用自然语言提出需求（如"我的流量为什么掉了"），代理无需记忆任何技能名，路由表会自动把意图匹配到正确的SKILL.md并执行。这篇文章带你完整看懂这套路由机制的设计思路。

技能路由表解决什么问题？

一个营销代理要同时干 48 件事：SEO 全站审计、关键词研究、Google Ads 出价优化、Meta 创意疲劳诊断、GA4 流量分析……如果让模型"自己想办法"，结果往往不稳定。

NotFair 的做法是：在仓库根目录放一份 AGENTS.md，它自称是通用入口（universal entry point）——任何 AI 代理（Claude Code、Codex、Hermes、Cursor 等）读到它，就知道"哪种用户意图该走哪个技能"。

路由表的使用规则只有三步：

1. 匹配意图：把用户说的话和表中每一行（Intent 列）对照；
2. 读取技能：按表中给出的路径打开对应技能的SKILL.md；
3. 严格执行：完全按该SKILL.md里的步骤操作。

这意味着"路由"这件事不需要任何代码——它是一次纯文本的查表操作。

48个技能如何分类？

路由表按业务域分成 9 张意图表，技能分布如下：

每一行都是"意图 → 技能 → 路径"的三元组，例如：

• "Full-site SEO audit, traffic drop, GSC analysis" →seo-analysis→ seo/seo-analysis/SKILL.md
• "Wasted spend, budget allocation" →paid-ads-optimize→ paid-ads/paid-ads-optimize/SKILL.md
• "Rank in ChatGPT / Perplexity / AI Overviews" →geo-optimizer→ seo/geo-optimizer/SKILL.md

完整清单可以直接在 AGENTS.md 中按域分节查看。

自动匹配用户意图的3个设计要点

意图列写的是"人话"，不是技能名

路由表的 Intent 列不是技术术语，而是用户真实的口语化提问："why is my traffic down"、"why do they outrank me"。这让匹配变成了语义对照而非精确字符串匹配——代理读用户的句子，找到语义最接近的一行即可。

SKILL.md frontmatter 提供第二道触发保险

除了AGENTS.md查表，每个技能自身的 frontmatter 还写满了触发词。以 seo/seo-analysis/SKILL.md 为例，它的description明确列出了 "traffic down"、"LCP, INP, CLS"、"keyword cannibalization" 等数十种应触发本技能的问法，甚至写着"If in doubt, trigger"。两条发现路径互为备份：Claude 系代理靠 frontmatter 发现技能，Codex 等主机则靠 skills/ 目录下的同名包装文件（每个包装文件只做一件事——转发回规范的 SKILL.md）。

缺失即隐身：强制的登记约定

AGENTS.md 末尾的 Bookkeeping 一节定下了硬规矩：一个技能如果不在路由表和 plugin.json 的skills数组里登记，它对代理来说就是隐形的。新增技能必须同步更新路由表、版本号（VERSION）和 CHANGELOG.md。这保证了"磁盘上存在的技能 = 路由表上可触达的技能"，不会出现 49 个技能、用户只能触发 48 个的尴尬。

另外，安装器向用户文件（如工作区的AGENTS.md）写入内容时，必须包裹在<!-- notfair:managed -->围栏内，重装时只改写围栏内部——这也是一个值得参考的"最小侵入"设计。

快速上手：让代理自己完成路由

安装后不需要记任何命令，直接用自然语言提问即可触发路由，例如：

• "审计我的网站，告诉我自然流量为什么下跌" → 命中seo-analysis
• "复盘上个月广告花费，找出最安全的 ROAS 提升点" → 命中paid-ads-optimize
• "我的 Google Ads 账户健康度如何" → 命中google-ads-audit

也可以直接用斜杠命令显式指定技能，如/notfair:seo-analysis。不同主机的安装方式（Claude Code 插件市场、Codex 命令行、Gemini CLI 扩展等）见 README.md；让代理自己走安装流程的话，给它 INSTALL_FOR_AGENTS.md 即可。若需离线浏览全部技能源码：

git clone https://gitcode.com/gh_mirrors/to/notfair-plugin

总结

NotFair 的AGENTS.md用一个非常朴素的思路解决了"多技能代理的选择困难"：把路由写成一张给人也看得懂的意图表。它的优点在于——

• ✅ 零代码：查表即路由，任何读 Markdown 的代理都能用；
• ✅ 双通道发现：路由表 + SKILL.md 触发词互为保险；
• ✅ 显式登记约定：技能不登记就隐身，杜绝"僵尸技能"；
• ✅ 主机无关：同一份表同时服务 Claude Code、Codex、Hermes、Cursor。

对于正在给自己的 AI 工具集做技能调度的开发者来说，这份 AGENTS.md 是一个值得抄的设计模板。

【免费下载链接】notfair-pluginOpen-source SEO, GEO, and marketing skills for AI agents.项目地址: https://gitcode.com/gh_mirrors/to/notfair-plugin