SuperAPI AI 工具集

technical-seo-schema-engineer

营销与增长

查看项目

更新于 10-16 09:24

技能介绍

Technical SEO Schema Engineer 是一个面向公开可爬取页面的技术 SEO 与 schema.org 结构化数据设计技能。根据资料,该技能应在 information-architecture-seo 已定义页面角色之后、上线回归验证之前使用,并在设计完整元数据或 JSON-LD 模板前先阅读 references/schema-patterns.md。

【用途与定位】 该技能为公开页面提供确定性的技术 SEO 与 schema.org 指导,覆盖元数据、结构化数据以及面向爬虫与 LLM 的输出文件策略。它属于 SEO 与 LLM 技能簇的一部分,强调在信息架构确定后、回归验证前完成元数据与结构化数据设计。

【主要能力(Owns)】

  • title 与 meta description 规则;
  • canonical 与 hreflang 标签模板;
  • JSON-LD schema 模式;
  • OpenGraph 与 Twitter 卡片元数据;
  • sitemap、news-sitemap、RSS、robots.txt 与 llms.txt 输出策略;
  • 发布者 logo 与 ImageObject 回退策略;
  • 页面类型元数据清单。

【不负责范围(Does Not Own)】

  • 语义核心;
  • 最终 URL 架构;
  • 内部链接图;
  • 实时审计执行;
  • 隐藏内容;
  • 视觉页面布局。

【工作流(Workflow)】

  1. 读取 url-map.yaml、页面角色、内容模型、语言分组与可见内容要求。
  2. 按页面角色选择元数据与 schema。
  3. 定义 title/meta 回退与长度指引。
  4. 从 URL map 定义 canonical 与 hreflang 标签。
  5. 定义与可见页面内容匹配的 JSON-LD 节点。
  6. 定义 OG/Twitter 图片策略:media、video poster、publisher card 或 fallback OG card。
  7. 定义 sitemap/RSS/robots/llms.txt 收录规则。
  8. 使用 assets/jsonld-templates.md 与 assets/head-metadata.template.html 产出 schema/head 指导。
  9. 将验证交接给 seo-regression-validator。

【硬性要求(Non-Negotiables)】

  • Schema 必须与可见内容匹配。
  • 除非 FAQ 区块对用户可见,否则不得添加 FAQPage。
  • 不得添加缺失或不支持的 review、rating、price、author、publisher、date、image 或 source 声明。
  • 不得使用 JSON-LD 隐藏额外关键词、额外实体或替代事实。
  • NewsArticle.image 必须解析到 media、poster 或稳定的 fallback ImageObject。
  • canonical 与 hreflang 必须遵循 URL 架构。
  • 当前的 Google/schema.org/爬虫规则要求在生产变更前进行一手来源验证。

【安全与隐私边界(Safety And Privacy Boundaries)】

  • 不得在元数据、schema、站点地图、RSS、robots 或 llms.txt 中暴露 admin、API、私有仪表盘、原始分析数据、原始 IP 日志、密钥文件、令牌、未发布草稿或 staging URL。
  • 不得为提升可爬取性而削弱认证、访问控制、CSP、CORS、cookie、速率限制或私有内容边界。
  • 不得在公开的面向 LLM 的文件中放置私有指令或内部规划备注。
  • 不得将 robots.txt 视为敏感内容的保密机制。
  • 安全、隐私、法律准确性、可访问性与可见用户理解优先于 SEO 或 LLM 可见性策略。

【验证(Validation)】 在标记工作完成前需满足:

  • 每个页面类型都有 title、description、canonical、OG、Twitter 与 schema 指导;
  • 每个 schema 类型都有必需的可见内容字段;
  • 每个新闻/文章页面都有图片回退策略;
  • 每个 hreflang 分组都基于 URL map 等价项;
  • sitemap 与 news-sitemap 规则只包含预期的公开 canonical URL;
  • robots 与 llms.txt 规则避免 private/admin/API 面;
  • 拒绝隐藏 schema 与重复 canonical 模式。

技能编辑需通过以下命令验证: python3 <codex-skills-dir>/senior-skill-architect/scripts/lint_production_skill.py ./skills/technical-seo-schema-engineer python3 ./plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py .

Forward tests 位于 evals.json。

【输出形态(Output Shape)】 返回:

  • 页面类型元数据矩阵;
  • schema 节点与必需可见字段;
  • canonical/hreflang 规则;
  • sitemap/RSS/robots/llms.txt 收录策略;
  • 验证清单与向回归验证器的交接。