最近发现一个挺有意思的趋势：越来越多网站、产品和文档站开始主动提供 Markdown 格式的入口，给 AI Agent 读取或执行。
比如：
- 告诉 Agent 怎么注册、鉴权、拿 API Key
- 告诉 Agent 怎么调用 API 或发现资源
- 提供
skill.md、guide.md、getting-started.md 之类的专用入口
- 明确说明“这是给 AI Agent 用的文档”
所以我整理了一个小项目：awesome-guide.md。
这个项目是什么
awesome-guide.md 是一个列表，用来收集互联网上那些“网站主动暴露给 AI Agent 的 Markdown 指南入口”。
它不是普通 API 文档导航，也不是又一个大而全的 awesome-list 。收录标准会更窄一点：
- 必须是网站、产品、服务或文档站公开提供的 Markdown 指南
- 必须能指导 AI Agent 完成接入、注册、鉴权、调用、集成、资源发现或理解服务
- 必须能从公开网页、官方文档、官方仓库或可信公开资料中验证来源
- 只收录
.md 或明确以 Markdown 形式提供的页面
- 普通 API 文档不收，除非它明确是面向 AI Agent 的
目前已经收录的一些例子
项目里目前收了一些比较典型的入口，例如：
- Moltbook 的
skill.md
- Telnyx 的
getting-started.md
- Hookdeck 的 AI Agent Resources
- Redis 的 AI Agent Resources Markdown 入口
- Inkbox 的 agent signup 文档
- 搭桥的
guide.md
- doc2md.cn 的
api.md
这些入口的共同点是：它们不只是“给人看的文档”，而是更接近“给 Agent 读完后可以直接行动的说明书”。
为什么想做这个
我觉得这类 Markdown 指南可能会变成未来服务接入的一种轻量协议。
以前是：
人打开网页 -> 看文档 -> 写代码调用 API
现在可能逐渐变成：
Agent 读取 Markdown 指南 -> 理解接入方式 -> 完成注册、鉴权、调用或集成
这中间会出现很多新的约定，比如：
- 文件应该叫
guide.md、skill.md 还是 llms.txt 关联的某个入口？
- Agent 专用文档应该写到什么粒度？
- 是否需要包含 OpenAPI 、MCP 、CLI 、权限说明、速率限制？
- 如何证明这个入口确实是官方公开提供的？
- 哪些内容适合给 Agent 自动执行，哪些必须留给用户确认？
awesome-guide.md 想先把这些案例收集起来，方便大家观察这个方向到底在怎么演化。
适合谁看
如果你在做这些事情，可能会感兴趣：
- 给自己的产品设计 AI Agent 接入文档
- 研究
llms.txt、MCP 、Agent skill 、Markdown docs
- 想看看哪些服务已经开始主动面向 Agent 提供入口
- 做爬虫、文档索引、Agent 工具调用、自动化集成
- 想给自己的服务加一个“Agent 友好”的接入说明
欢迎提交
如果你知道类似的公开入口，欢迎提 Issue：
项目地址：https://github.com/YUHAI0/awesome-guide.md
