打造在各种 AI 智能体工具中都能运行的 SEO 研究技能组

## 只用所有工具都懂的写法，每个技能只写一份 将每项研究技能编写为规范且与平台无关的源文件。核心契约仅使用所有目标智能体环境都能解释的功能。 要求每项技能定义提供： - 稳定的名称和清晰的说明； - 仅在主机支持时使用的可选模型声明和工具声明； - 正文中的完整操作指南； - 明确的输入、输出、约束和失败条件。 将平台专用控制项视为可选扩展。如果主机可能忽略某项扩展，但不必因此拒绝其他方面可移植的技能，兼容性检查器应发出警告。 编辑规范源文件，而不是生成的平台副本。在打包或分发前验证所有技能定义，以便尽早发现元数据缺失和不受支持的语法并判定失败。 ## 查清每个 AI 智能体工具从哪里读取指令和技能 梳理每个目标环境发现项目指令和可复用技能的方式。常见模式包括根目录指令文件、专用规则目录、原生技能文件夹、生成的调度器和文档回退路径。 为每个主机记录： - 会话开始时自动读取的文件； - 必须复制、链接或安装可复用技能的位置； - 激活是自动完成还是需要明确命令； - 不支持委派时如何回退到内联执行； - 哪份项目文档充当最终回退路径。 不要假定一种安装布局能在所有环境中运行。在保持单一语义源文件的同时，使发现、激活和打包方式符合主机经过验证的行为。 ## 用通用操作描述步骤，再对应到各工具的名称 以中性操作来编写流程，例如读取、写入、编辑、执行命令、列出文件、搜索文本和获取网页内容。 维护一份经过验证的兼容性映射，将这些操作对应到每个主机的工具名称。当主机支持自动映射时，让适配器转换别名。某项能力不可用时，应定义有文档说明的回退方式，而不是默默省略该步骤。 将工具转换与研究逻辑分离。页面分析流程应说明需要受保护的获取操作和 HTML 解析器，而不能依赖某个供应商的工具标签。 每当主机更改工具接口时，都要重新检查映射。不要只因名称相似就声称兼容；应实际执行已映射的操作。 ## 由一个小的入口技能挑选要加载的研究技能 使用小型编排器对请求分类，并仅加载相关能力。将详细分析逻辑放在职责明确的模块中，而不是放进一个过大的指令文件。 将系统划分为： - 选择工作流程的路由技能； - 具备完整分析标准的专项研究技能； - 用于独立或并行工作的可选专家智能体； - 用于确定性执行的本地脚本； - 用于结构化搜索元数据的模式模板； - 用于主机专用打包的适配器； - 用于可选提供商和高成本能力的扩展。 让扩展置于核心依赖路径之外。缺少扩展时，只能缩小可选覆盖范围，不能破坏基础研究。 ## 为每个问题选择范围最小的 SEO 检查 选择能够回答研究问题的最小范围能力： - 使用全站审核进行广泛发现和优先级排序； - 使用单页分析深入检查一个 URL； - 使用技术分析检查可抓取性、索引、性能和相关基础设施； - 使用内容分析检查质量、信任、专业知识和经验信号； - 使用结构化数据分析进行检测、验证和生成； - 使用站点地图分析检查 XML 覆盖范围并生成站点地图； - 使用图像分析检查页面内元数据、搜索结果可见性和文件优化； - 使用 AI 搜索分析检查生成式搜索可见性和答案引擎优化。 只有当发现跨越多个能力边界时，才扩大为更广泛的审核。对于每项外部主张，都要保留原始 URL、证据来源、观察时间和不确定性。 ## SEO 规划单独处理，并与基准记录对比追踪变化 为战略规划、语义关键词聚类、搜索体验分析和内容架构提供不同的工作流程。不要将这些规划任务并入技术诊断。 明确记录监控状态： 1. 捕获稳定的基线； 2. 将后续观察结果与该基线比较； 3. 保留历史记录，以便区分重复变化与一次性噪声。 为电商、程序化落地页、竞争对手比较页、本地搜索、地图可见性、国际语言定位、第一方搜索数据、页面体验和反向链接分析使用专用模块。 将外部数据提供商、大规模抓取和素材生成视为可选扩展。调用前，标明提供商要求、凭据、成本和覆盖范围限制。 ## 抓取前先检查 URL，不把 API 密钥写进技能 使用本地脚本完成受保护的页面获取、HTML 解析、性能检查、基线捕获和结构化导出等确定性工作。 所有面向网络的辅助程序都必须在发出请求前验证目标 URL，以降低服务器端请求伪造风险。保留证书验证；应调查证书故障，而不是禁用传输安全。 将 API 凭据保存在用户级配置位置或注入的环境中，绝不能放入规范技能、示例输出或生成的软件包。不要编造值；缺少凭据时，应给出明确结果并停止。 通过已配置的语言环境和依赖项管理器运行辅助程序。当云主机没有在 `PATH` 中公开该环境时，使用经过验证的可执行文件绝对路径。 当另一个模块会使用结果时，返回机器可读结果。对于写入临时目录的屏幕截图或其他文件，保留绝对路径。 ## 分享前在每个支持的 AI 智能体工具中测试 打包前，对每项规范技能运行可移植性扫描。确认必需的元数据、有效结构和已知的主机专用功能。 在每个受支持的环境中测试： - 根目录指令发现； - 技能安装或链接； - 明确激活路径和自动激活路径； - 工具名称转换； - 无法委派给智能体时的内联回退方式； - 本地辅助程序执行； - 生成的路由和文档回退路径。 警告必须指出相关功能、受影响的主机和预期的功能降低。被忽略的可选字段仍可能保持兼容；缺少必需指令或无法执行核心操作则不兼容。 ## 排查工具特有的错误，但不关闭安全检查 将主机专用故障视为环境证据，而不是削弱保护措施的许可。 - 更改代码前，调查证书链或名称解析故障。 - 默认命令路径缺少依赖项时，使用经过验证的虚拟环境可执行文件。 - 工作目录中没有屏幕截图或报告时，检查文档规定的临时目录。 - 产物跨越进程或容器边界时，使用绝对路径。 - 只有当文档规定的本地辅助程序能够提供同等证据时，才用它替代不可用的远程集成。 记录限制影响的是发现、执行、委派、网络连接还是产物位置。将解决方法保留在适配器或操作说明中，不要污染规范研究逻辑。 ## 在真实工具中测试并更新文档后再完成更改 在宣布跨平台研究更改完成前： - 检查规范技能和每个受影响的适配器； - 重新构建生成的路由和软件包； - 运行可移植性扫描和相关辅助程序测试； - 在代表性主机上实际执行，而不能只依赖语法检查； - 更新能力目录、安装指南和架构说明； - 确认可选扩展仍保持隔离； - 检查结果中是否含有凭据、不受支持的主张或缺失的证据。 报告已更改的能力、已验证的主机、通过的检查、观察到的警告、使用的回退方式以及无法运行的验证。当主机忽略必需行为或只测试了一个环境时，不要声称完全一致。