Codex 插件【Agent Ready】：AI 智能体就绪度扫描

Agent Ready 插件就像一个面向 AI 智能体的网站检查助手。它可以在 Codex 中扫描网站，判断页面、说明文件和智能体协议是否容易被 ChatGPT、Claude、Codex 等 AI 系统发现、解析和调用，并针对未通过的检查项给出修改建议。

它适合检查官方网站、产品文档、API 平台、MCP 服务和面向 AI 智能体开放的在线应用。

一、Agent Ready 能做什么

图 1：Agent Ready 扫描并改进智能体就绪度的基本流程

1、扫描网站的智能体可读性

用户提供网站地址后，Agent Ready 可以抓取相关页面并执行就绪度检查。

它关注的不只是页面能否被普通浏览器打开，还会检查 AI 智能体能否发现网站内容、理解页面结构，并找到可以进一步调用的服务入口。

2、检查发现与说明文件

AI 智能体通常需要通过特定文件了解网站结构和使用方式。

Agent Ready 可以检查 llms.txt、llms-full.txt、robots.txt、sitemap.xml、sitemap.md 和 AGENTS.md 等文件是否存在，以及格式和内容是否符合相应规范。

例如，llms.txt 可以为大语言模型提供网站内容索引，AGENTS.md 则可说明项目的安装、测试、开发约定和禁止修改的范围。

3、检查页面结构

插件可以检查标题层级、元数据、规范链接、结构化数据、代码块语言标记、Markdown 镜像和内容协商等页面特征。

这些结构能够帮助 AI 智能体更准确地识别页面主题、提取内容并引用信息。对于严重依赖 JavaScript 渲染的页面，扫描结果也可能指出内容读取方面的问题。

4、检查智能体协议

Agent Ready 还可以检查网站是否提供 MCP Server Card、A2A Agent Card、agents.json、agent-permissions.json、UCP、x402 和 NLWeb 等智能体协议或清单。

这些文件和协议分别用于描述工具能力、智能体身份、可执行操作、权限范围、商业交易和自然语言查询接口。

5、生成评分与整改建议

扫描完成后，插件可以汇总通过和未通过的检查项，形成智能体可读性评分，并说明每个问题应如何修复。

还可以让 Codex按照影响范围和修改成本整理整改顺序，例如先补充缺失文件，再修正页面结构，最后完善 MCP、A2A 等协议入口。Agent Ready 也支持通过 REST API、MCP、CLI 和 GitHub Action 接入自动化流程。

二、怎样把任务说清楚

使用 Agent Ready 时，应说明扫描目标、网站类型、检查重点和期望输出。

至少应提供以下信息：

1、目标地址：首页、文档站、API 站点或具体页面。

2、网站用途：企业官网、开发者平台、电商网站、MCP 服务或 AI 应用。

3、检查重点：内容发现、页面结构、llms.txt、AGENTS.md、MCP、A2A 或权限配置。

4、整改范围：只生成报告，还是同时修改当前代码仓库。

5、输出方式：问题清单、优先级、修改方案、代码差异或复查结果。

可以使用下面的模板：

请使用 Agent Ready 插件检查网站的 AI 智能体就绪度。

目标地址：[网站地址]

网站类型：[官网 / 文档站 / API 平台 / MCP 服务等]

主要用户：[普通用户、开发者或 AI 智能体]

检查重点：[发现文件、页面结构、智能体协议等]

整改范围：[仅分析 / 生成修改方案 / 修改当前项目]

完成后请说明：总体评分、主要问题、影响范围、整改优先级、建议修改的文件和复查方法。

三、场景示例

示例 1：检查企业官网

扫描企业官网，检查 AI 智能体能否发现主要产品、服务、联系方式和结构化信息，并生成优先整改清单。

示例 2：完善开发者文档

检查 API 文档站的标题结构、代码块标记、Markdown 内容、OpenAPI 入口和 llms.txt，提高文档被 AI 系统解析和引用的能力。

示例 3：检查 AGENTS.md

检查代码仓库中的 AGENTS.md 是否包含项目说明、安装命令、测试方法、编码规范和禁止修改的目录，并补充缺失内容。

示例 4：验证 MCP 或 A2A 服务

检查服务是否正确发布 MCP Server Card 或 A2A Agent Card，以及工具描述、身份验证和能力声明是否完整。

示例 5：上线前后对比

在网站改版前后分别执行扫描，对比评分和失败项，确认新版本是否引入缺失元数据、无效链接或协议配置退化。

四、使用时要注意

1、不要把评分等同于整体质量

智能体就绪度主要反映 AI 系统发现和读取网站的难易程度，不能替代安全审计、性能测试、无障碍检查和传统搜索引擎优化。

2、优先修复系统性问题

如果所有页面都缺少规范链接、标题结构或结构化数据，影响通常高于单个页面中的局部问题，应优先统一修改模板。

3、保证扫描目标可以访问

登录后页面、内部网络和受到严格访问限制的内容，可能无法被完整抓取。扫描前应明确公开范围和测试环境。

4、谨慎修改权限与协议文件

robots.txt、agent-permissions.json、身份验证配置和支付协议会影响访问边界。自动生成的修改应经过人工审核后再部署。

5、定期重新扫描

网站内容、框架和协议规范会持续变化。重大改版、文档更新或服务发布后，应重新扫描，并将关键检查接入部署流程。

小结

Agent Ready 插件用于检查网站的 AI 智能体可读性与就绪度，覆盖发现文件、页面结构、智能体协议、权限配置和整改建议。明确扫描范围并按优先级修复问题，有助于让网站更容易被 AI 智能体发现、理解和调用。

“点赞有美意，赞赏是鼓励”