AgentKit SEO Web 作品集
概述
使用此技能来改善个人网站被搜索引擎和 AI 系统抓取、渲染、总结和信任的方式。
参考资料选择
- 可抓取性、站点地图、机器人、上线、URL 结构: references/indexing-and-architecture.md
- 标题、规范标签、Schema、JavaScript 渲染: references/metadata-structured-data-and-js.md
- 首页、关于页、项目页、元数据、
llms.txt文案: references/section-recipes.md - 案例研究、性能、AI 检索约定: references/content-performance-and-aeo.md
- 现有网站审计或维护: references/portfolio-audit-and-maintenance.md
Wiki 上下文
- 当任务涉及
llms.txt、AI 检索、证据标签、来源置信度、平台约束或已知的代理失败模式时,请阅读 wiki/index.md。 - 仅当 wiki/index.md 将当前任务路由到 wiki/knowledge.md 后,才阅读它。
- 如果在旧版安装中某个 wiki 文件不可用,请继续使用相关的
references/文件,并在其影响置信度时将 wiki 特定的指导标记为不可用。
Token 规约
- 对于 URL 审计,首先检查首页、robots.txt、站点地图以及仅限优先级页面。
- 对于本地源代码工作,在打开广泛文件之前,先搜索元数据、路由、布局和结构化数据。
- 不要为解决技术性抓取问题加载内容写作参考资料。
- 在阅读大量内容文件之前,优先使用渲染后的/公开的 HTML、路由元数据、站点地图、robots.txt 和页面模板。
- 保持源代码清单紧凑:列出输入组,而不是每个资产或路由。
- 如果范围有限,请标明下一次检查的内容。
深度契约
使用最小诚实的审计深度:
快速扫描: 首页、robots.txt、站点地图、标题/元/规范标签基础、主导航以及可见定位。默认审计: 快速扫描加上最多 2 个用户指定或可见的优先级页面、结构化数据、开放图谱、内部链接,以及可用时的顶部项目页面。深度审计: 完整路由清单、构建的 HTML/源代码模板、性能/移动端检查、重定向/状态码、Schema 验证、损坏的链接和代码编辑。
对于广泛的作品集审计,默认使用 默认审计。当当前答案需要更多证据时,可提供 深度审计 作为可选的下一步。除非用户要求进行全站审计、精确代码更改、上线验证或检查每个重要路由,否则不要默默选择 深度审计。
工作流程
- 如果用户提供公开的作品集 URL,在工具允许的情况下,获取并检查首页、重要页面、元数据、规范标签、站点地图、robots.txt、结构化数据和可见文案。
- 如果作品集源代码在本地可用且用户要求实施,则检查源代码,并优先对元数据、结构化数据、语义 HTML、链接和内容进行直接代码编辑。对于仅审计请求,除非用户要求编辑,否则返回可修补的建议。
- 如果公开抓取被阻止或网站未部署,请询问本地源代码路径、构建的 HTML、截图、页面清单或粘贴的页面文案。
- 如果网站文案依赖于传记、项目声明或职业事实,建议在重写前使用代理上下文文件。
- 不要为了填充作品集页面而虚构项目、推荐信、指标、雇主或证书。
规则
- 将已记录的标准与新兴约定(如
llms.txt)区分开。 - 将从公开页面或本地来源验证的事实,与用户上下文材料提供的事实,以及从这些事实推断出的建议区分开。
- 优先选择能改善可抓取性、信息线索和摘要质量的更改,避免使用炒作。
- 不要将非官方的 AI 或 SEO 提案作为普遍标准。
- 保持元数据、结构化数据和可见文案对齐。
- 确保同一页面的标题、描述、规范 URL、开放图谱、X/Twitter 卡片、JSON-LD URL、JSON-LD 名称或标题、JSON-LD 描述和代表性图片保持一致。
- 将结构化数据与页面目的相匹配。仅对具有受支持的作者、日期和正文内容的可见文章类页面使用文章类 Schema。
- 将排名、富媒体摘要、图片缩略图、摘要和索引速度视为资格结果,而非保证。
- 确保页面目的、URL 结构、内部链接和证明资产保持一致,以便每个重要声明都能解析到一个可抓取的页面。
- 当事实缺失时,在虚构作品集文案或结构化数据之前,先询问规范 URL、页面清单或源代码内容。
- 编辑作品集代码时,除非用户明确要求重新设计,否则保留现有的样式和应用程序逻辑。在布局更改之前,优先进行元数据、结构化数据、语义 HTML、可抓取性和内容的更改。
- 对于直接代码编辑,当项目提供可用命令时,运行构建、lint、测试或预览命令,并报告任何无法运行的验证。
响应格式
返回:
- 被检查的 URL 或本地文件
- 可抓取性、元数据、结构化数据和内容问题
- 直接代码编辑或页面就绪文案
- 已运行的验证或仍需要的检查
- 影响公开声明的上下文文件缺口
对于审计,当声明可能不明确时,使用简洁的标签,例如 已验证、来自源代码、来自上下文、推断 和 不可访问。将不受支持的责任、指标、资历、客户、推荐信或结果标记为缺口,而不是将其转化为元数据、Schema 或文案。当审计故意限制范围时,包括一行 深度注释,说明未检查的内容以及更深层次的检查将增加什么。
人肉操作脚本: hub/web-portfolio/README.md。