Blog Schema：博客 JSON-LD 结构化数据生成器
为博客文章生成并校验完整的 JSON-LD 结构化数据。
技能仅生成JSON-LD，未声明工具权限、凭证访问或外部网络操作，未见恶意行为；但允许按用户偏好将结果保存到博客文件，缺少明确的写入确认、备份与回滚说明，也未透明说明外部URL和用户内容的数据流，因此扣分。
工作流和示例覆盖主要成功路径，字段与引用检查也有明确清单；但没有针对本技能生成流程的专门测试、异常输入处理或失败反馈规范，且“验证”主要是文字要求而非可复现实现，因此扣分。
触发词、输入文件路径和输出形式较清楚，适合博客结构化数据生成；但未声明不适用场景、缺失字段时的边界行为、中文内容支持或不同CMS限制，且FAQ和视频元数据依赖额外信息，因此扣分。
具备标准前置元数据、MIT许可、分步结构、示例和部分限制说明；但技能文件没有自身版本、变更记录、维护责任或更新路径，安装和依赖说明也主要存在于仓库级文档而非本技能，因此扣分。
模板可帮助用户生成包含多实体的可直接嵌入JSON-LD，核心任务基本覆盖；但输出正确性依赖人工补全站点、作者、图片和视频元数据，FAQ规则及AI引用收益缺乏证据，且保存行为和CMS兼容性不够明确，因此扣分。
仓库提供通用CI和测试材料，但给定文件中没有针对blog-schema生成、引用解析或Google验证的专门可复现测试，也没有第三方执行证据；静态材料仅支持有限可审计性，因此低分。
- 技能没有明确要求在覆盖原博客文件前征得确认，实际使用时应先输出独立文件或保留备份。
- “验证Google要求”、FAQ至少两题、以及“提高约13% AI引用概率”等说法在所给材料中没有针对本技能的可核验证据。
- 日期、图片尺寸、作者社交链接和视频统计等字段可能缺失或无法可靠提取，生成结果应经过人工和实际结构化数据工具复核。
- 未说明中文内容、不同CMS和不可访问外部图片或YouTube元数据时的降级行为。
这个 Skill 能做什么，适合哪些场景？
Blog Schema 是 claude-blog 仓库中的独立 Agent Skill，专门为博客文章生成 JSON-LD 结构化数据。它读取文章内容，提取标题、作者、日期、描述、图片、FAQ、分类和 slug 等信息，并使用 @graph 组合多个实体。输出可包含 BlogPosting、Person、Organization、BreadcrumbList、FAQPage、ImageObject 和 VideoObject。它适合需要规范化博客结构化数据的内容团队，但不负责完整的博客写作、SEO 策略或其他兄弟技能的工作。
读取博客文章及其可用元数据，提取标题、作者资料、发布日期和修改日期、元描述、FAQ 问答、图片信息、组织信息、近似字数、标签分类和 slug。根据这些数据生成 BlogPosting、Person、Organization、BreadcrumbList、FAQPage 和主图 ImageObject；文章包含 YouTube 视频时，可生成 VideoObject。它使用稳定的 @id 进行实体关联，将结果合并为一个包含 @context 和 @graph 的 JSON-LD 脚本，并检查日期顺序、标题长度、描述长度、绝对 URL、图片尺寸、面包屑顺序、FAQ 数量和已弃用类型。
- 博客作者发布新文章时，需要从文章文件自动生成可嵌入页面的 JSON-LD。
- SEO 或内容团队审核现有文章的 BlogPosting、作者、组织、面包屑和 FAQ 结构化数据。
- 使用 FAQ 内容并希望为搜索引擎和 AI 引用系统提供更清晰内容结构的网站团队。
- 文章包含 YouTube 视频和主图，需要补充 VideoObject 与 ImageObject 标记的发布团队。
- 维护多个博客页面，需要通过稳定的 @id 统一关联作者、发布组织和文章实体的开发者。
这个 Skill 有哪些优点和局限？
- 覆盖博客文章常见的文章、作者、组织、面包屑、FAQ 和图片实体。
- 使用 @graph 和稳定 @id 进行实体关联，便于维护。
- 包含 Google 要求和推荐属性的校验规则，并主动警告已弃用类型。
- 可输出嵌入 HTML、独立 JSON 或 MDX 组件格式。
- 只负责博客结构化数据，不提供完整的内容写作、关键词研究或整站 SEO 审计。
- FAQPage 校验要求至少有两个问题；没有足够 FAQ 内容时无法满足该检查。
- 视频流程主要针对 YouTube，视频元数据依赖文章嵌入信息或可用的 blog-google 数据。
- SKILL.md 没有提供独立测试套件、具体 CMS 适配步骤或单独安装流程。
- README 中关于 AI 引用提升约 13% 的说法在该技能材料内未提供验证方法。
如何安装这个 Skill？
该技能随 AgriciDaniel/claude-blog 集合安装。Claude Code 1.0.33+ 中可执行：/plugin marketplace add AgriciDaniel/claude-blog，然后执行 /plugin install claude-blog@agricidaniel-claude-blog。技能文件位于 skills/blog-schema/SKILL.md。README 未说明单独安装该子技能的命令。
如何使用这个 Skill？
在 Claude Code 中对博客文件使用 /blog schema <file>，或在请求中明确说“schema”“blog schema”“json-ld”“structured data”或“schema markup”。技能会读取指定文章并生成 JSON-LD。输出可以是嵌入 HTML、独立 JSON 或 MDX 组件；具体保存到原文章还是单独 schema 文件，需要按用户偏好决定。
这个 Skill 与同类方案有什么区别？
README 提到可选的 /seo-schema companion skill，用于更深入的 schema 验证与生成；Blog Schema 则专注于从博客文章内容生成完整的 JSON-LD @graph。