---
description: 对整个项目进行全面 SEO 审计
argument-hint: [directory]
---

执行完整的 SEO 审计，扫描所有页面和组件，生成详细报告和 SEO 评分（0-100 分）。

## 功能

全面的 SEO 审计包括：
- ✅ 元数据优化分析
- ✅ 结构化数据检查
- ✅ 内容质量评估
- ✅ E-E-A-T 权威性审计 ⭐
- ✅ 内容策略分析 ⭐
- ✅ 技术 SEO 检查
- ✅ 100 分制评分系统（6 个维度）
- ✅ 优先级修复建议

## 参数

- `$1` 或 `$ARGUMENTS`: 可选的项目目录路径
  - 如果不提供，检查当前工作目录
  - 应该是 Next.js 项目的根目录
  - 支持相对路径和绝对路径

## 使用示例

### 示例 1：审计当前目录

```bash
/seo-audit
```

输出：
```
🔍 开始全面 SEO 审计...

✓ 检测到项目类型：Next.js App Router
✓ 扫描目录：app/
✓ 发现页面：15 个
✓ 发现组件：23 个
✓ 分析配置文件
✓ 检测语言：中文（75%）

📊 正在计算 SEO 评分...

═════════════════════════════════════════════════════
                    SEO 审计报告
═════════════════════════════════════════════════════

📈 总体评分：78/100 ⭐⭐⭐⭐

评级：良好 - 你的网站 SEO 基础较好，但仍有改进空间

═════════════════════════════════════════════════════

📋 详细得分：

1️⃣  元数据完整性：18/20 ✅
   ├─ Title: 7/8
   │  ├─ ✓ 所有页面都有 Title
   │  ├─ ⚠️ 3 个页面标题过长
   │  └─ ⚠️ 2 个页面缺少目标关键词
   ├─ Description: 8/8 ✅
   └─ OG & Twitter: 3/4
      └─ ⚠️ 缺少 Twitter Cards

2️⃣  结构化数据：12/15 ⚠️
   ├─ JSON-LD 存在: 7/7 ✅
   ├─ 必需字段: 3/4
   │  └─ ⚠️ 部分页面缺少 datePublished
   └─ 验证通过: 2/4
      └─ ❌ 有警告需要修复

3️⃣  内容质量：20/25 ⚠️
   ├─ 标题结构: 5/6
   │  └─ ⚠️ 1 个页面有多个 H1
   ├─ 内容长度: 5/6 ✅
   ├─ 关键词使用: 3/4
   ├─ 链接质量: 4/4 ✅
   ├─ 多媒体: 1/3
   │  └─ ❌ 缺少视频和图表
   └─ Featured Snippets: 2/2 ✅

4️⃣  E-E-A-T 权威性：14/20 ⚠️
   ├─ 专业度展示: 4/7
   │  ├─ ❌ 缺少具体案例研究 (1/3)
   │  ├─ ✓ 技术准确性良好 (2/2)
   │  └─ ⚠️ 作者信息不完整 (1/2)
   ├─ 权威性建立: 5/7
   │  ├─ ⚠️ 外部引用不足 (2/3)
   │  ├─ ✓ 内容独特 (2/2)
   │  └─ ⚠️ 支柱页面需要完善 (1/2)
   └─ 信任度建设: 5/6 ✅
      ├─ ✓ 更新频率良好
      ├─ ✓ 数据来源透明
      └─ ⚠️ 缺少关于页面 (1/2)

5️⃣  内容策略：6/10 ⚠️
   ├─ 集群结构: 2/4
   │  └─ ❌ 内部链接不足
   ├─ 内容日历: 2/3 ✅
   └─ 关键词蚕食: 2/3 ✅

6️⃣  技术 SEO：8/10 ✅
   ├─ robots.txt: 3/3 ✅
   ├─ 图片优化: 2/3
   │  └─ ⚠️ 部分图片缺少 alt
   ├─ URL 结构: 2/2 ✅
   └─ 移动友好: 1/2
      └─ ⚠️ 响应式问题

═════════════════════════════════════════════════════

🎯 优先修复建议（按影响排序）

🔴 高优先级（+3 分以上）
   1. [E-E-A-T] 添加案例研究和实际经验展示 (+2 分)
      → 在博客文章中添加真实案例
      → 分享实践经验教训
   2. [E-E-A-T] 完善作者信息和关于页面 (+2 分)
      → 创建详细的作者简介页面
      → 添加关于页面
   3. [内容策略] 优化集群内容的内部链接结构 (+2 分)
      → 确保所有相关内容互相链接

🟡 中优先级（+1-2 分）
   4. [内容质量] 添加图表和视频内容 (+2 分)
   5. [元数据] 添加 Twitter Cards 标签 (+1 分)
   6. [结构化数据] 修复 JSON-LD 验证警告 (+2 分)

🟢 低优先级（+1 分以下）
   7. [技术 SEO] 为图片添加 alt 文本 (+1 分)
   8. [技术 SEO] 修复移动端响应式问题 (+1 分)

═════════════════════════════════════════════════════

📈 改进路线图

第 1 周：权威性建设
  [ ] 添加 3 个案例研究
  [ ] 创建作者简介页面
  [ ] 添加关于页面

第 2 周：内容优化
  [ ] 优化内部链接结构
  [ ] 添加图表和视频

第 3 周：技术完善
  [ ] 添加 Twitter Cards
  [ ] 修复结构化数据

预期提升：78 分 → 90+ 分

═════════════════════════════════════════════════════

💡 下一步建议

需要我为任何建议提供详细的实施指导吗？
使用以下命令获取更多帮助：
  /ee-audit --detailed    # 详细 E-E-A-T 分析
  /content-strategy       # 内容策略建议
  /pillar-pages --analyze # 支柱页面分析
```

### 示例 2：审计指定目录

```bash
/seo-audit ./my-app
```

输出：
```
🔍 开始全面 SEO 审计...

✓ 检测到项目类型：Next.js Pages Router
✓ 扫描目录：./my-app/pages/
✓ 发现页面：22 个
✓ 发现组件：31 个
✓ 检测语言：英文

📊 正在计算 SEO 评分...

[完整的审计报告...]
```

### 示例 3：中文项目审计

```bash
/seo-audit
```

输出：
```
🔍 开始全面 SEO 审计...

✓ 检测项目类型：Next.js App Router
✓ 扫描目录：app/
✓ 发现页面：18 个
✓ 检测语言：中文（82%）

📊 正在计算 SEO 评分...

═════════════════════════════════════════════════════
                    SEO 审计报告
═════════════════════════════════════════════════════

📈 总体评分：82/100 ⭐⭐⭐⭐

语言：中文项目
搜索引擎：百度、搜狗、Google

[中文特定的分析和建议...]
```

## 审计流程

### 1. 项目检测

```
检测项目类型：
- App Router（app/ 目录）
- Pages Router（pages/ 目录）
- 语言（中文/英文）
- 项目规模
```

### 2. 全面扫描

```
扫描文件类型：
- 页面文件（page.tsx, page.js）
- 组件文件
- 配置文件（next.config.js, robots.txt）
- 静态资源
```

### 3. 六维评分

```
计算 6 个维度的得分：
1. 元数据完整性（20 分）
2. 结构化数据（15 分）
3. 内容质量（25 分）
4. E-E-A-T 权威性（20 分）
5. 内容策略（10 分）
6. 技术 SEO（10 分）
```

### 4. 报告生成

```
生成完整的审计报告：
- 总体评分
- 详细得分分析
- 优先级建议
- 改进路线图
```

## 输出文件

可选地将审计报告保存为文件：

```bash
/seo-audit --output report.md
```

生成文件：
- `seo-audit-report.md` - Markdown 格式报告
- `seo-audit-report.json` - JSON 格式数据

## 详细模式

使用 `--detailed` 标志获取更详细的分析：

```bash
/seo-audit --detailed
```

包含额外信息：
- 每个页面的详细得分
- 逐个文件的问题列表
- 竞争对手对比（如果提供）
- 技术性能指标

## 比较模式

比较两次审计的结果：

```bash
# 首次审计
/seo-audit --save baseline

# 后续审计
/seo-audit --compare baseline
```

输出改进对比：
```
📊 SEO 评分对比

上次评分：65/100
当前评分：78/100
提升：+13 分 ⬆️

改进项目：
✓ 元数据完整性：12/20 → 18/20 (+6)
✓ 内容质量：15/25 → 20/25 (+5)
⚠️  E-E-A-T 权威性：12/20 → 14/20 (+2)
```

## 集成工具

审计过程会使用：
- Glob - 文件搜索
- Grep - 模式匹配
- Read - 内容分析
- Bash - 配置验证

## 性能考虑

- 并行处理多个文件
- 智能缓存机制
- 增量扫描支持
- 快速跳过已检查文件

## 评分等级

```
⭐⭐⭐⭐⭐  90-100  优秀
⭐⭐⭐⭐    75-89  良好
⭐⭐⭐      60-74  一般
⭐⭐        40-59  需要改进
⭐           0-39  急需改进
```

## 后续操作

基于审计结果，推荐使用：

```markdown
📊 深度分析
  /ee-audit --detailed          # E-E-A-T 详细审计
  /content-strategy --deep      # 内容策略分析
  /pillar-pages --analyze       # 支柱页面分析
  /topic-clusters --analyze     # 集群内容分析

🔧 立即修复
  /metadata [文件路径]          # 优化元数据
  /structured-data [文件路径]   # 添加结构化数据
  /author-bio [作者名]           # 生成作者简介

📈 长期改进
  Agent: seo-analyzer           # 深度 SEO 分析
  Agent: content-optimizer      # 内容优化专家
```

## 注意事项

- 完整审计可能需要较长时间（大型项目）
- 审计结果基于当前项目状态
- 建议定期审计（每月一次）
- 评分基于 SEO 最佳实践
- 不同行业可能有特殊要求

## 相关命令

- `/seo-check` - 快速 SEO 检查
- `/ee-audit` - E-E-A-T 详细审计
- `/content-strategy` - 内容策略分析
- `/pillar-pages` - 支柱页面分析
- `Agent: seo-analyzer` - 深度分析

## 最佳实践

1. **定期审计** - 每月或重大更新后审计
2. **跟踪进度** - 保存审计结果对比
3. **优先修复** - 按影响程度修复问题
4. **持续改进** - 建立改进计划
5. **测试验证** - 使用工具验证修改
