blog-audit

博客审计：全站健康状况评估

对项目中的所有文章进行全面的博客健康状况评估。 扫描内容质量评分、孤立页面、主题蚕食、过时内容 以及 AI 引用就绪度。使用并行子 Agent 高效分析，并 生成按优先级排序的行动队列。

审计流程

步骤 1：发现博客文件

扫描项目中的所有博客内容文件：

• 在常见博客目录中查找 *.md、*.mdx、*.html
• 检查以下常见路径：
  • content/
  • posts/
  • blog/
  • src/content/
  • _posts/
  • pages/blog/
  • articles/
  • src/pages/blog/
• 筛除非博客文件：README、CHANGELOG、LICENSE、配置文件、 SKILL.md、package.json、node_modules
• 报告：“在 [directories] 中找到 N 个博客文件”

如果在标准位置未找到博客文件，则搜索整个项目根目录， 查找带有博客类 frontmatter（title、date、description）的 Markdown 文件。

步骤 2：并行分析

通过 Task 工具生成子 Agent，对所有已发现的博客文件进行并行处理：

内容质量 Agent

• 按 30 分制的内容质量标准为每篇文章评分
• 检查段落长度（目标为 40-80 个单词，上限为 150 个单词）
• 检查句子长度（目标为 15-20 个单词）
• 评估标题结构及疑问句式标题
• 评估可读性（Flesch 阅读易读性目标为 60-70）

SEO 优化 Agent

• 检查每篇文章的页面 SEO 要素：
  • Title 标签长度（50-60 个字符）
  • Meta description（150-160 个字符，包含统计数据）
  • H1 是否存在且唯一
  • 图片 alt 文本覆盖情况
  • 内部链接和外部链接数量
  • URL slug 质量

Schema 验证 Agent

• 检测所有文章中的结构化数据
• 验证 BlogPosting schema 的完整性
• 检查 FAQ schema 是否存在且格式正确
• 验证 dateModified 是否与 frontmatter 中的 lastUpdated 匹配
• 标记缺失或格式错误的 schema

链接健康度 Agent

• 映射所有文章中的内部链接
• 构建有向链接图
• 检测孤立页面（没有入站内部链接）
• 检测死胡同页面（没有出站内部链接）
• 检查失效的内部链接目标
• 推荐双向链接机会

内容新鲜度检查 Agent

• 从每篇文章的 frontmatter 中读取 lastUpdated 或 dateModified
• 计算距上次更新的天数
• 标记 90 天以上未更新的文章
• 按刷新优先级分类

AI 就绪度 Agent

• 为每篇文章评估 AI 引用就绪度
• 检查段落级可引用性（120-180 个单词的章节）
• 评估问答格式和实体清晰度
• 检查 TL;DR 说明框和引用摘要
• 评估 AI 爬虫的访问能力

步骤 3：检测主题蚕食

分析所有文章，查找关键词竞争：

1. 从每篇文章中提取主要关键词/主题：
   • 标题文本
   • H1 标题
   • Meta description
   • 第一段
2. 规范化关键词（转为小写，移除停用词）
3. 检测是否有多篇文章瞄准相同的主要关键词
4. 对存在竞争的文章标记以下建议之一：
   • 合并：将两篇较弱的文章合并为一篇更有力的文章
   • 重定向：将较弱文章 301 重定向至较强的文章
   • 区分：调整文章侧重点，使其瞄准不同的搜索意图

步骤 4：检测孤立页面

构建并分析内部链接图：

1. 提取每篇博客文章中的所有内部链接（相对链接和绝对链接）
2. 构建邻接映射：{ page -> [pages it links to] }
3. 构建反向映射：{ page -> [pages linking to it] }
4. 识别孤立页面：没有入站内部链接的文章
5. 识别死胡同页面：没有出站内部链接的文章
6. 对每个孤立页面，根据主题相关性推荐 2-3 篇 应添加指向该页面链接的现有文章

步骤 5：过时内容检测

审查所有文章的内容时效性：

1. 读取 frontmatter 字段：lastUpdated、dateModified、date、updated
2. 计算每篇文章距上次更新的天数
3. 按刷新优先级分类：
   • 高（>180 天）：可能已过时，统计数据可能已陈旧
   • 中（90-180 天）：检查准确性，更新统计数据
   • 低（<90 天）：近期已更新，无需立即处理
4. 估算每篇文章的刷新工作量：
   • 轻度刷新：更新统计数据、检查链接（1-2 小时）
   • 中度刷新：重写部分章节、添加新数据（3-4 小时）
   • 重度刷新：建议全面重写（5 小时以上）

步骤 6：生成全站报告

汇总所有结果，生成一份全面的报告：

概览仪表板

## Blog Audit Report

**Audit Date:** [date]
**Total Posts:** N
**Average Score:** XX/100

### Health Overview
| Metric | Count |
|--------|-------|
| Posts Scoring 90+ (Excellent) | N |
| Posts Scoring 70-89 (Good) | N |
| Posts Scoring 50-69 (Needs Work) | N |
| Posts Scoring <50 (Poor) | N |
| Orphan Pages | N |
| Dead-End Pages | N |
| Cannibalization Issues | N |
| Stale Content (90+ days) | N |

单篇文章表格

### Per-Post Scores
| Post | Score | Content | SEO | E-E-A-T | Technical | AI Citation | Issues |
|------|-------|---------|-----|---------|-----------|-------------|--------|
| [filename] | XX/100 | X/25 | X/20 | X/20 | X/15 | X/20 | [count] |

优先处理队列

### Prioritized Action Queue (Lowest Score First)
| Priority | Post | Score | Top Issue | Recommended Action |
|----------|------|-------|-----------|--------------------|
| 1 | [file] | XX | [issue] | [action] |
| 2 | [file] | XX | [issue] | [action] |

关键词蚕食报告

### Topic Cannibalization
| Keyword | Competing Posts | Recommendation |
|---------|----------------|----------------|
| [keyword] | post-a.md, post-b.md | Merge / Redirect / Differentiate |

孤立页面

### Orphan Pages (No Inbound Links)
| Page | Inbound Links | Recommended Link Sources |
|------|---------------|--------------------------|
| [file] | 0 | post-a.md, post-b.md, post-c.md |

过时内容

### Stale Content
| Post | Last Updated | Days Stale | Priority | Refresh Effort |
|------|-------------|------------|----------|----------------|
| [file] | [date] | [N] | High/Med/Low | Light/Moderate/Heavy |

步骤 7：保存报告

将完整报告保存到项目根目录下的 blog-audit-report.md。

保存后，告知用户：

• 报告位置：[project-root]/blog-audit-report.md
• 发现摘要（文章总数、平均分、严重问题数量）
• 建议先对得分最低的文章运行 /blog analyze <file>
• 建议对重要文章运行 /blog geo <file>，以优化 AI 引用效果

交叉参考

如需获取超越本站全站健康检查的循证审计提示词，请参阅 /blog flow optimize（可见度、CTR、架构标记、内容提取审计）和 /blog flow win（双渠道评分卡、转化审计）。