用途:在信息架构 SEO 已定义页面角色之后、上线回归验证之前,为公开可抓取页面设计确定性的技术 SEO 与 schema.org 元数据指导。
主要能力:定义 title 与 meta description 规则及回退与长度指引;基于 URL 映射定义 canonical 与 hreflang 标签;定义 JSON-LD schema 模式;定义 OpenGraph 与 Twitter 卡片元数据;定义 sitemap、news-sitemap、RSS、robots.txt 与 llms.txt 的输出策略;定义发布者 logo 与 ImageObject 回退策略;产出页面类型元数据检查清单。设计完整元数据或 JSON-LD 模板前需先阅读 references/schema-patterns.md,并可使用 assets/jsonld-templates.md 与 assets/head-metadata.template.html。
工作流:读取 url-map.yaml、页面角色、内容模型、语言分组与可见内容要求;按页面角色选择元数据与 schema;定义标题/元描述回退与长度;从 URL 映射定义 canonical 与 hreflang;定义与可见页面内容一致的 JSON-LD 节点;定义 OG/Twitter 图片策略;定义站点地图/RSS/robots/llms.txt 收录规则;产出 schema/head 指导;将验证移交 seo-regression-validator。
硬性约束:schema 必须匹配可见内容;FAQ 块不可见时不得添加 FAQPage;不得添加缺失或无依据的 review、rating、price、author、publisher、date、image 或 source 声明;不得用 JSON-LD 隐藏额外关键词、实体或替代事实;NewsArticle.image 必须解析到媒体、海报或稳定的回退 ImageObject;canonical 与 hreflang 必须遵循 URL 架构;生产变更前需按 Google/schema.org/爬虫当前规则做一手来源核验。
安全与隐私边界:不得在元数据、schema、站点地图、RSS、robots 或 llms.txt 中暴露管理端、API、私有面板、原始分析、原始 IP 日志、密钥文件、令牌、未发布草稿或暂存 URL;不得为可抓取性削弱认证、访问控制、CSP、CORS、cookie、速率限制或私有内容边界;不得在面向 LLM 的公开文件中放置私有指令或内部规划笔记;robots.txt 不能当作敏感内容的保密机制;安全、隐私、法律准确性、可访问性与用户可见理解优先于 SEO 或 LLM 可见性策略。
验证:每个页面类型需有 title、description、canonical、OG、Twitter 与 schema 指导;每个 schema 类型需有所需可见内容字段;每个新闻/文章页需有图片回退策略;每个 hreflang 组需基于 URL 映射等价页;站点地图与 news-sitemap 规则只包含预期的公开 canonical URL;robots 与 llms.txt 规则避开私有/管理/API 面;拒绝隐藏 schema 与重复 canonical 模式。技能编辑用以下命令校验:python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/technical-seo-schema-engineer 与 python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL。转发测试位于 evals.json。
输出形态:页面类型元数据矩阵、schema 节点与所需可见字段、canonical/hreflang 规则、站点地图/RSS/robots/llms.txt 收录策略、验证清单与向回归验证器的移交。