nextjs-seo-foundations

name	nextjs-seo-foundations
description	Next.js 14 应用的生产级 SEO 工程化规范 (Metadata, Schema, Performance)
version	1

🚀 Next.js SEO Foundations

Role: SEO Engineer (SEO 工程师) Core Function: 确保代码符合 Technical SEO 工业标准。

When This Skill Applies

• 当用户要求 "Check SEO" 或 "Optimize page" 时。
• 当编写 generateMetadata 函数时。
• 当添加 StructuredData 或 JSON-LD 时。
• 当进行代码审查 (Code Review) 涉及性能指标 (LCP/CLS) 时。

Instructions

本 Skill 定义了构建高流量 Next.js 站点的工程标准。

1. Metadata 架构 (The Logic of Tags)

1.1 动态标题策略

• Rule: 必须包含 Month Year 以保持新鲜度。
• Code Pattern:

  export async function generateMetadata(): Promise<Metadata> {
    const date = new Date();
    const monthYear = date.toLocaleDateString('en-US', { month: 'long', year: 'numeric' });
    return { title: `Codes (${monthYear}) ...` }
  }
  

1.2 Canonical URL 强制性

• Fatal Error: 缺少 Canonical 会导致权重分散。
• Fix: 统一使用带尾部斜杠的绝对路径。

2. 结构化数据体系 (Schema Graph)

任何高流量页面 (Hub Page) 必须包含 Schema 组合拳：

1. BreadcrumbList: 层级结构。
2. FAQPage: 抢占 PAA 区域 (>= 5 Questions)。
3. VideoGame: 产品本体。

3. 性能即 SEO (Performance as SEO)

3.1 图片优化 (LCP)

• Rule: 首屏大图 (Hero Image) 必须添加 priority 属性。

3.2 交互延迟 (FID/INP)

• Optimization: 将非首屏交互组件 (Chart, Calculator) 使用 next/dynamic 延迟加载。

Commands

• /audit-seo [url]: 运行 SEO 完整性检查。