技能介绍

痛点：手写结构化数据又慢又容易出错

页面上线前，工程师需要在 <head> 里塞一段合法的 JSON-LD，让搜索结果展示富媒体摘要。手写这段标记的麻烦在于：Schema.org 的字段命名规约分散在大量文档里，不同业务类型（文章、商品、FAQ）的属性差异很大；写完后还得手动跑到 Google Rich Results Test 去验证，一旦字段缺失或类型不对，搜索引擎可能直接忽略整段标记，SEO 投入等于白做。

核心能力与工作方式

这个技能把生成和校验两个环节串成一条流水线：

以 schema-dts 的 TypeScript 定义为基准，确保生成的 JSON-LD 字段符合 Schema.org 规范，避免拼写错误或属性错位
支持 Article、Product、FAQ、HowTo、LocalBusiness 五种常用 schema 类型，覆盖内容站点、电商、问答和服务类业务的主要场景
生成的标记可直接投递到 Google Rich Results Test API 做自动化校验，在合并代码前就拿到机器可读的验证结果

典型流程是：传入业务类型和字段数据 → 技能按 schema-dts 类型定义组装 JSON-LD → 调用 Rich Results Test API 检查 → 返回通过验证的标记片段，直接粘贴进页面模板。

适用边界与注意点

类型覆盖有限：只支持上述五种 schema，Event、Review、BreadcrumbList 等类型不在范围内，需要另找方案
依赖 Schema.org 规范：生成的标记正确性以 schema.org 为准，若 Google 对某类型的渲染要求与规范有差异，需自行对照 Rich Results Test 的报错调整
上游说明缺失：SKILL.md 中没有自动提取到完整的安装和使用说明，建议在正式接入生产流程前先审阅原始项目文档，确认调用方式和权限要求
验证接口依赖网络：Rich Results Test API 需要在线调用，离线或内网环境需要提前确认网络策略