SuperAPI AI 工具集

optimize-seo

写作与研究

查看项目

更新于 10-16 01:14

技能介绍

用途:作为 Azure 技术文档的 SEO 元数据校验器,确保 frontmatter 元数据有利于搜索发现,并正确标明文章类型。

主要检查项:

  1. description 长度:应为 75-160 字符。过短(<75)需基于文章内容扩充,说明文章目的;过长(>160)优先删减而非重写。不应以文章标题或产品名逐字开头,应说明读者将学到或完成什么,且必须以句号结尾。
  2. title 与 H1 匹配:frontmatter 的 title 应与正文第一个 # H1 标题高度一致。允许细微差异(title 可为 SEO 略短);主题或框架明显不符需标记。title 建议不超过 60 字符以利于搜索展示。标题中不得使用缩写或首字母缩略词。
  3. ms.topic 分类:应与文章类型匹配,可选 conceptual / concept-article(说明概念)、how-to / how-to-guide(分步操作)、tutorial(引导学习)、reference(API/CLI/配置参考)、overview(高层介绍)、architecture / solution-idea(架构或设计指导)、quickstart(10 分钟内入门)、sample(代码示例讲解)、troubleshooting(诊断与修复问题)。不得在等价取值之间改动(如 conceptual 与 concept-article 互换)。

忽略项:ms.date、ms.service、ms.subservice(由 metadata-updater 处理);author、ms.author、ms.reviewer 等人员字段;YAML frontmatter 之外的全部内容;无 YAML frontmatter 的文章。

使用规则:不要仅为风格而改动 title 或 description,只修真正的 SEO 问题;description 略长时优先删减;扩充短 description 时必须依据文章实际内容。

限制:该技能聚焦元数据校验,不涉及正文写作或其他元数据字段处理;具体安装与调用方式资料暂未提供。