seo-schema

seo-schema 技能概览

seo-schema 技能可以帮助你检测、验证并生成 Schema.org 结构化数据，首选输出格式是 JSON-LD。它很适合 SEO 编辑、技术 SEO、内容团队，以及那些需要把页面 URL 或页面概要转成可直接使用标记、却不想靠猜测应该用哪种 schema 类型的智能体。

用户通常最关心的其实很简单：这个页面能不能具备 rich result 资格，标记是否有效，以及推荐的 schema 类型是否仍然安全可用。seo-schema 技能之所以实用，是因为它把检测、验证和类型状态判断结合在一起，而不只是写一段模板化的 JSON-LD。对于 seo-schema for SEO Content 这类工作来说，它比通用提示词更贴近实际。

seo-schema 最适合做什么

当你需要处理文章、产品、组织、本地商家、视频、活动以及类似常见实体的页面级标记时，就用 seo-schema skill。如果输入本身比较杂乱——比如一个真实 URL、零散内容，或只是一个粗略的页面意图，需要先确定 schema 选择——它尤其有用。

输出前会先检查什么

这个技能的设计思路是先看 JSON-LD，必要时再看 Microdata 和 RDFa，并验证常见 schema 问题，例如缺少 @context、无效的 @type、占位文本、相对 URL 以及错误的日期格式。也就是说，seo-schema 不只是生成工具，它同样适合做 QA。

重要的适用边界

它不是一个全局 SEO 策略工具，也不能替代人工的政策判断。如果你需要自定义业务规则、深度内容建模，或者多页面站点架构设计，更适合把它当作标记辅助工具，而不是完整的 SEO 系统。

如何使用 seo-schema 技能

安装并打开正确的文件

先在你的 skill runner 里执行 seo-schema install，然后优先阅读 SKILL.md。在这个仓库里没有配套脚本或参考文件夹，所以 skill 文件本身就是主要依据。如果你需要了解复用条件，也可以查看 LICENSE.txt。

提供可直接使用的输入简报

这个技能在提示词里包含目标 URL、页面类型和页面业务目标时效果最好。比如：“审核这篇文章页的 schema，如果有效就输出 JSON-LD”比“加上 schema”更明确。

通常更好的输入会包含：

• 页面 URL 或原始 HTML
• 内容类型，例如 Article、Product 或 LocalBusiness
• 规范名称、作者、日期、地点、价格或 offer 详情
• 目标是验证、生成还是修复

把模糊请求转成完整提示词

对于 seo-schema usage，先用一句话描述页面和你要的输出，再补充标记必须保留的事实。比如：“用 seo-schema 识别这个产品页最合适的 schema 类型，验证当前标记，并只用绝对 URL 返回修正后的 JSON-LD。”

能提升输出质量的工作流

先做检测，再做验证，只有在页面事实足够支撑时才进行生成。如果页面没有明确实体，就让技能先识别最有依据的 schema 类型，并在写标记前列出缺失字段。这样可以减少臆造属性和不稳妥的 rich result 声明。

seo-schema 技能常见问题

seo-schema 只能用于 JSON-LD 吗？

JSON-LD 是首选格式，但这个技能也可以检测 Microdata 和 RDFa。实际使用中，seo-schema 技能最适合你想输出 JSON-LD，或者想从旧标记格式平滑迁移时。

使用它一定要懂技术 SEO 吗？

不需要，但输入越准确，标记质量通常越好。初学者只要提供页面用途和源内容，就可以用它处理单个页面。技术型用户在验证边界情况、不受支持的类型，或现有标记冲突时，会得到更多价值。

什么时候不应该用 seo-schema？

当你不知道页面实体是什么，或者内容太薄，不足以支撑结构化数据时，就不要用它。如果页面只是占位页、内部草稿，或缺少稳定事实，这个技能虽然仍能识别缺口，但不应该硬套 schema。

它和普通提示词有什么不同？

普通提示词往往只是写标记。seo-schema 技能额外加入了检测、类型状态感知和验证规则，从而降低发布错误或过时 schema 的风险。这也是为什么要安装它，而不是每次临时即兴处理。

如何改进 seo-schema 技能

提供标记无法凭空生成的事实

提升质量最大的方式，是提供准确的页面事实：实体名称、作者、日期、组织信息、产品价格、库存状态或地点。只有底层页面数据足够具体且稳定，seo-schema 技能才能产出高质量 schema。

明确目标 schema 结果

如果你已经知道页面意图，就直接说出来。比如，“这是一个带作者名和发布日期的 NewsArticle”比只说“SEO schema”更有效。清晰的意图能帮助技能避免过度标记，或者选到较弱的类型。

先验证，再生成

一个很实用的 seo-schema guide 模式是：“先验证当前标记，再提出修复建议，然后生成干净版本。”这在编辑已有页面时尤其有价值，因为最常见的问题往往是必填字段缺失、URL 错误，或类型不匹配。

关注警告本身，而不只是代码

如果第一次输出提示某个类型已弃用或不受支持，不要忽略这个警告。更新页面事实，删除占位内容，再用更干净的源数据重新运行技能。最佳的 seo-schema for SEO Content 结果，来自修正内容模型，而不只是重写 JSON-LD 语法。