On-Page SEO 是一个面向单页面的站内 SEO 审计与优化技能（Skill），定位为「为搜索相关性、点击率和爬虫理解优化单个页面」，并且不绑定技术栈，官方描述为可用于任意 CMS、框架或静态站点。
用途与适用场景 它用于审计或优化单个页面，例如首页、产品页、文章或落地页；用于撰写或审阅标题标签与元描述；用于修复标题层级结构或内容层级；用于检查指向该页或由该页发出的内链；也用于提升页面在搜索结果中的点击率（CTR）。
不适用场景 官方明确列出以下情况不应使用本技能：全站级别的抓取、索引或速度问题应使用 seo-technical；关键词研究或搜索意图映射应使用 seo-keyword；竞品 SERP 分析应使用 seo-competitor；需要批量审计多个页面以做删除或合并决策时应使用 seo-content-audit。
所需输入 使用前需要提供：页面 URL，或上线前的草稿内容；主要目标查询词（页面应排名的一个短语）；页面在站点中的角色（商业、信息或导航）。如果目标查询词不明，官方建议先运行 seo-keyword，或让用户指定一个。
八个审计维度 一次完整的站内审计覆盖八个维度，每个维度按「通过 / 需改进 / 失败」评分，并记录具体修复项：
- 标题标签：同一站点内每个 URL 标题唯一；长度大致 50 到 60 个字符（过长会在搜索结果中被截断）；主要查询词靠前；品牌名在确实值得加入时放在末尾；与 H1 不同（二者常很相似，但不应逐字相同）。
- 元描述：每个 URL 描述唯一；长度大致 150 到 160 个字符；复述价值主张而非标题；在自然的位置包含软性行动号召（CTA）；把描述当作争取点击的广告文案来写。
- 标题结构：每页有且仅有一个 H1；H1 包含或改写主要查询词；H2 覆盖主要子主题；仅当 H2 确实有子要点时才使用 H3 及更深层级；不跳级（不要 H2 之后直接 H4）；标题对章节的描述要准确到读者仅凭标题即可导航。
- 正文内容：首段即回答主要用户意图；全面覆盖主题（先定义竞品的深度，再达到或超过它）；自然包含相关实体与支撑概念；避免关键词堆砌（为读者而写，而非为机器人）；可读性与受众匹配（进行可读性检查）；段落足够短以便移动端扫读（3 到 5 行）。
- 内链：至少 2 到 3 条指向紧密相关页面的出站内链；至少 2 到 3 条来自相关页面的入站内链；锚文本具有描述性，不用「点击这里」或「了解更多」；链接指向规范 URL 而非重定向；没有失效内链。
- 图片与媒体：每张有意义的图片都有描述性 alt 文本（纯装饰性图片可跳过 alt）；文件名具有描述性（如 blue-running-shoe.jpg 而非 IMG_4032.jpg）；在支持的情况下使用现代格式（WebP、AVIF）；首屏以下的图片启用懒加载；设置宽度与高度属性以避免布局偏移。
- URL slug：小写、以连字符分隔；自然包含主要查询词（不堆砌）；尽量短（最好在 60 个字符以内）；除非页面确实有时效性，否则不含日期；不含会话 ID、跟踪参数或随机哈希；符合站点 URL 模式约定。
- 页面内 schema：为内容选择合适 Schema.org 类型（Article、Product、FAQPage、HowTo、Recipe 等）；填写必填属性（参考对应类型的 Schema.org 文档）；可在 Google Rich Results Test 或同类工具中通过验证；与页面可见内容一致（不要对爬虫说谎）；内容页的作者与发布者 schema 正确关联。
工作流程
- 确认目标查询词，不清楚就问，没有目标查询词不要优化。2. 渲染页面，像用户一样查看，从头到尾阅读内容。3. 查看渲染后的 HTML，检查实际输出的标记而非仅看视觉页面，在源码中检查 <title>、<meta>、标题与 schema。4. 按八维框架逐项评分并记录具体修复项。5. 排优先级，把修复分为关键（损坏或缺失）、重要（欠佳）、锦上添花（打磨）。6. 撰写报告，使用 references/audit-template.md 中的模板。7. 主动提出起草修复，如用户需要，直接起草新标题、元描述、标题或文案。
失败模式 官方列出若干应在交付前提出异议的情况：「让它更 SEO 一点」过于模糊，应先询问目标查询词和具体问题所在；「在正文加 5 次关键词」——关键词密度并不是真实的排名信号，应优先考虑相关性与主题深度；优化不可抓取或不可索引的页面——应先检查 seo-technical，站内优化救不了被 noindex 的页面；优化没有清晰用户意图的页面——不服务真实查询的页面无论标签多好都不会排名；与站内其他页面瞄准同一查询词——这是关键词蚕食，应使用 seo-content-audit 决定哪个页面应参与排名。
输出格式 默认输出为项目根目录下的 markdown 审计文件 seo-audit-[page-slug].md，结构包括：页面摘要（URL、目标查询词、角色）、八个维度的评分、关键修复、重要修复、锦上添花打磨、以及起草的替换内容（如被请求）。审计内容控制在 1500 词以内，若页面需要更多细节，链接到更深入的附录。
参考文件 references/audit-template.md 为可填写的审计模板；references/onpage-checklist.md 为八维快速检查清单；references/title-and-meta-patterns.md 为撰写强标题与元描述的模式。
其它说明 关于该技能的收费、价格、平台支持范围与效果数据，现有资料暂未提供。