关于 blog-rewrite
blog-rewrite 是用于审查和改写现有博客文章的技能,关注搜索表现和 AI 引用准备度。它评估内容质量、提交优化计划供确认,并在保留作者风格与原有优点的基础上改写。
主要功能
- 01审查内容、SEO 与引用准备度
- 02扫描 AI 写作模式
- 03检查视频嵌入和关键词重叠
- 04研究替换数据与视觉素材
- 05保留作者风格改写文章
适用场景
- 01修改前审查现有博客文章
- 02用有来源的数据替换无依据的统计
- 03提升文章的搜索和 AI 引用准备度
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ infrasity-labs/ dev-gtm-claude-skills --skill blog-rewrite安装后在 Claude Code 中输入/blog-rewrite确认已加载。
详细介绍
博客改写器:优化现有文章
改写并优化现有博客文章,实现双重排名:Google 搜索和 AI 引用平台。保留作者的语气,同时应用 6 大优化支柱。
关键参考资料:
references/quality-scoring.md- 5 类评分(内容 30、SEO 25、E-E-A-T 15、技术 15、AI 引用 15)references/eeat-signals.md- 经验、专业知识、权威性和信任标记references/internal-linking.md- 链接策略和锚文本规则references/visual-media.md- 图片来源和图表样式skills/blog/references/synthesis-contract.md- 重写期间保持引用卫生的 6 条 LAWs(v1.8.0;跨技能参考资料位于编排器的 references 目录中)skills/blog/references/research-quality.md- 用于替换统计数据研究的跨来源聚类(v1.8.0)
交叉参考
有关 21 个以证据为导向、可直接用于改写工作的优化提示词(AI 检测器测试、CTR 审核、schema、PAA 改写、技术审核、ChatGPT 可见度),请参阅 /blog flow optimize。
工作流
阶段 1:审核(只读)
- 阅读博客文章 — 检测格式(MDX、markdown、HTML)
- 根据
references/quality-scoring.md运行质量检查清单:- 统计虚构数据与有来源的数据
- 检查答案优先的格式(H2 下的第一句话是否包含统计数据?)
- 统计图片和图表数量(类型是否多样?)
- 衡量段落长度(是否有超过 150 个单词的段落?)
- 检查标题层级(H1 → H2 → H3,是否没有跳级?)
- 查找 FAQ schema
- 检查时效性信号(lastUpdated、dateModified)
- 评估自我推广程度
- 评估引用来源的等级质量
- AI 内容检测扫描:
- 突发性分数 — 衡量全文句子长度的差异。差异较低(大多数句子长度相差不超过 3–5 个单词)是强烈的 AI 信号。 计算方法:句子单词数的标准差。目标:SD > 6。
- 已知 AI 短语扫描 — 检查以下高频 AI 短语:
- “in today's digital landscape”、“it's important to note”、“dive into”
- “game-changer”、“navigate the landscape”、“revolutionize”、“seamlessly”
- “cutting-edge”、“harness the power of”、“leverage”(作动词时)
- “delve”、“crucial”、“elevate”、“foster”、“landscape”(过度使用时)
- “multifaceted”、“robust”、“tapestry”、“embark”
- 完整列表见
agents/blog-writer.md
- 词汇多样性 — 计算词元-词型比(TTR):不同词数 / 总词数。TTR 较低(< 0.40)表示措辞重复,可能由 AI 生成。自然文本的目标 TTR > 0.50。
- AI 内容百分比估算 — 根据突发性、短语密度和 TTR,估算内容中读起来像 AI 生成的百分比(0–100%)。 报告格式:“AI content estimate: ~X%”
- 二阶结构反射扫描(v1.8.0)— 上述一阶检查针对词汇层面。二阶检查则捕捉经过这些检查后仍残留的内容:LLM 在替换掉明显词汇后仍会默认采用的结构和节奏习惯。根据
skills/blog/references/ai-slop-detection.md运行。至少标记以下情况:- 以疑问句形式出现的 H2 超过标题总数的 70%
- 以 “Here...” 开头的段落达到 3 段或更多
- 任意一个 200 词窗口中,三分句节奏的句子超过 50%
- 任意一个 20 词跨度内,模糊限定词(“may”、“often”、“typically”、“generally”)超过 2 个
- 对称列表膨胀(列表项词数的 SD 低于 5)
- 总结性修辞问句(“What does this mean for...?”)超过 2 个
- 超过一半的 H2 开头使用过渡词
- 以 “The key insight is...” 或 “What's important here is...” 开头的句子
- 列表文章在列表前的引言超过 250 词
- 开头词重复:出现频率最高的三个首词占比超过 25%
- 段落形态的 SD 低于 25(视觉单调)
只有两轮检查都通过,草稿才能标记为“通过 AI 检测”。使用两套术语(用于检测低质 AI 内容的一阶/二阶,以及用于来源权威性的 Tier 1/2/3)是有意为之:关于标签在 v1.8.1 中分化的原因,请参阅
skills/blog/references/ai-slop-detection.md。
- 视频嵌入检查:
- 统计文章中现有的 YouTube 嵌入数量
- 如果嵌入数量为 0,标记:“没有视频嵌入。YouTube 与 AI 可见性的相关性最强(0.737)”
- 如果存在嵌入,检查:是否启用了延迟加载?是否有 aria-label?是否有 noscript 后备内容?是否有 VideoObject schema?
- 蚕食检查:
- 根据标题、H1 和第一段确定文章的主要关键词
- 搜索博客目录,查找其他以相同关键词为目标的文章:
- 对所有博客文章的标题和元描述进行 grep 搜索
- 标记关键词重叠显著的文章
- 如果发现蚕食,报告:
- 哪些文章在竞争相同的关键词
- 建议:合并(合并为一篇更有力的文章)或区分(将其中一篇转向相关但不同的关键词)
- 计算当前得分,涵盖 5 个类别:
- 对 5 个类别评分(内容质量 30、SEO 优化 25、E-E-A-T 信号 15、技术要素 15、AI 引用就绪度 15)
- 总分:0–100
- 提供审计摘要,列出具体发现、AI 检测结果、视频状态、蚕食状态和得分
- 进入计划模式 — 提供逐章节优化计划 等待用户批准后再继续。
阶段 2:研究
- 根据现有内容确定博客的核心主题
- 为任何编造或无来源的数据寻找替代统计数据:
- 搜索:
[topic] study 2025 2026 data statistics - 仅选择第 1 至第 3 级来源
- 搜索:
- 如果文章中的图片少于 3 张,则查找图片:
- Pixabay:
site:pixabay.com [topic keywords] - Unsplash:
site:unsplash.com [topic keywords] - 确认每个 URL 均返回 HTTP 200
- 如果已配置 nanobanana-mcp,则通过
blog-image提议为缺失或不足的图片使用 AI 生成
- Pixabay:
- 如果文章中的图表少于 2 个,则规划图表:
- 找出适合可视化的数据
- 选择多样化的图表类型
阶段 3:图表生成(内置)
当文章需要更多视觉元素时,调用 blog-chart 子技能:
- 根据多样性规则选择图表类型(每篇文章中不得重复)
- 传入:图表类型、标题、数据值、来源、平台格式
- 将返回的 SVG 直接嵌入
<figure>包装元素中 - 每篇 2,000 字的文章以添加 2-4 个图表为目标
图表类型选择和样式规则请参见 references/visual-media.md。
阶段 4:重写内容
按以下顺序进行修改:
4a. 保留有效内容
- 保留作者的语气和独特视角
- 保留原创见解和第一手经验
- 保留现有的优质图片和图表
- 保留站内链接
4b. 修正 Frontmatter
- 添加
lastUpdated: "YYYY-MM-DD"(今天的日期) - 保持原始
date不变 - 修正文案描述:信息密集,150-160 个字符,并包含 1 项统计数据
- 如果缺少
coverImage、coverImageAlt或ogImage,则添加- 在 Pixabay/Unsplash/Pexels 搜索横向主视觉图片(1200x630)
- 或通过
blog-chart生成自定义 SVG 封面(渐变背景上的文字,包含关键统计数据) - 或通过
blog-image子技能生成自定义 AI 图片(如果已配置 nanobanana-mcp)
- 确认标签/分类合适
4c. 应用答案优先的格式
每个 H2 小节都必须以一段 40-60 词的文字开篇,其中包含:
- 至少一项有来源说明的具体统计数据
- 对标题所隐含问题的直接回答
4d. 替换编造的统计数据
- 搜索以下模式:“X% 的……”“Y 人中有 X 人……”以及无来源的断言
- 用第 1 至第 3 级来源的真实数据替换
- 始终添加行内来源标注:
([Source Name](url), year)
4e. 改进标题
- 自然情况下,将陈述式标题改为疑问式标题(目标占比 60%-70%)
- 保留 2-3 个陈述式标题,以增加多样性
- 确保关键词自然出现在 2-3 个标题中
4f. 调整段落长度
- 拆分所有超过 150 词的段落
- 每段以 40-80 词为目标
- 确保每段都以最重要的句子开头
4g. 添加视觉元素
- 在 H2 标题后嵌入新图片,并均匀分布
- 在相关小节中嵌入图表
- 如果已配置 nanobanana-mcp,则为缺少合适图库图片的小节生成自定义图片(通过 Task 调用
blog-image子技能) - 根据检测到的平台调整嵌入格式(MDX、markdown 或 HTML)
4h. 添加视频嵌入
如果文章没有嵌入 YouTube 视频:
- 根据
references/video-embeds.md中的质量标准搜索 2-3 个相关视频 - 使用适合平台的格式嵌入(srcdoc 延迟加载)
- 放置位置:引言后 1 个,文章中段小节后 1-2 个
- 添加 noscript 回退内容,供 AI 爬虫使用
4i. 添加/改进常见问题解答
- 如果没有常见问题解答,则添加一个(3-5 个问题)
- 如果已有常见问题解答,则确保答案为 40-60 词,并包含统计数据
- 添加适合平台的 FAQ 结构化数据标记
4j. 减少自我宣传
- 品牌名称最多提及 1 次(仅限作者简介)
- 删除“在 [Company],我们……”这类表述
- 将宣传性小节改为教育性内容
4k. 引文胶囊注入
为每个 H2 章节生成(或改进现有的)引文胶囊:
- 每个 H2 章节包含一段 40-60 词的独立内容
- 包含:一项具体主张、一项数据点和来源归属
- 使用陈述式写法,便于 AI 系统直接提取和引用
- 自然地放在章节正文中,而非作为单独的提示框
示例:
According to a 2026 Gartner study, 58% of enterprise buyers now consult AI
assistants before contacting a vendor ([Gartner](https://www.gartner.com), 2026).
This shift means B2B content must answer specific questions concisely enough
for AI systems to extract and cite in their responses.
引文胶囊对应 references/quality-scoring.md 中“AI 引用就绪度”类别(15 分)。
4l. 反 AI 检测模式
应用以下转换,以减少容易被 AI 检测到的写作模式:
- 消除 em dash - 将每个 em dash(-)替换为逗号、连字符(-)、冒号或句号。必要时拆分句子。em dash 是 AI 写作的明显特征。
- 替换标记短语 - 将检测到的每个 AI 短语(来自阶段 1 步骤 3 的扫描)替换为自然表达。例如:
- “it's important to note” -> “值得注意的是”或“请记住”
- “in today's digital landscape” -> “眼下”或“在[具体年份]”
- “leverage” -> “使用”“应用”“利用”
- “delve” -> “看看”“探索”“深入研究”
- “robust” -> “强大”“稳健”“可靠”
- “crucial” -> “关键”“必要”“至关重要”(或重构句子)
- 有意变换句子长度 - 改写后检查每个段落。在较长句子(18-25 词)之间插入简短有力的句子(5-10 词)。目标:连续句子的长度相差不超过 5 词的情况,不多于 3 句。
- 加入反问句 - 每 200-300 词至少加入一个反问句,打破陈述句的单调感。
- 自然使用缩略形式 - 在听起来自然的地方,将正式表达替换为缩略形式:“it is” -> “it's”,“we have” -> “we've”,“do not” -> “don't”,“is not” -> “isn't”。
- 加入保留性表达 - 加入体现真实经验的第一人称谨慎表达:“根据我们的经验”“我们发现”“据我们观察”“通常会”“这取决于”。
4m. 摘要框(关键要点)
如果文章没有摘要框,请在引言后立即添加:
> **Key Takeaways**
> - [Core finding with statistic and source]
> - [Second key insight or recommendation]
> - [Third actionable takeaway]
> (3-5 bullets, 40-60 words combined. Self-contained - reader gets
> the core value without reading the full article.)
默认标签为“关键要点”,但可根据人物设定或品牌语气进行配置(例如:“核心结论”“快速摘要”“须知内容”)。
如果已有 TL;DR 框,请将其转换为项目符号形式的“关键要点”。确认其满足 40-60 词的要求,并至少包含一项带来源归属的统计数据。
4n. 信息增益标记注入
检查文章是否包含原创价值,并为其添加标记:
[ORIGINAL DATA]- 作者亲自收集的专有数据、调查结果、实验或案例研究指标[PERSONAL EXPERIENCE]- 第一手观察和经验教训[UNIQUE INSIGHT]- 有数据支持的新颖分析或反主流观点
如果文章缺少原创价值标记:
- 请作者提供可纳入的第一手数据或经验
- 至少加入将现有研究以新方式关联起来的分析见解
- 目标:每篇文章至少添加 2-3 个标记
根据文章风格,使用 HTML 注释(``)或可见提示框。
阶段 5:验证
改写后,确认所有质量门槛均已通过:
核心质量门槛
- 每个 H2 章节均以一项统计数据和来源开头
- 每个段落不超过 150 词
- 不得编造统计数据
- 标题层级清晰
- 包含带 schema 的 FAQ 章节
- 图片具有描述性 alt 文本
- frontmatter 中包含封面图片(coverImage + ogImage)
- 如果是 MDX:构建项目以确认没有编译错误
新增要素验证
- 引言后包含 TL;DR 框(40-60 词,含统计数据)
- 至少包含 2-3 个信息增益标记
- 主要 H2 章节中包含引文胶囊(40-60 词,内容独立完整)
- 标记内部链接区域或添加实际链接(每 2,000 词 5-10 个)
- 不再包含禁止列表中的 AI 检测短语
变化度与自然度检查
- 句长差异:标准差 > 6(长短句结合)
- 全文自然使用缩略形式
- 包含设问(每 200-300 个词 1 个)
- AI 内容估算值较审计基线有所降低
- 与第 1 阶段审计相比,所有 5 个类别的评分均有所提高
- YouTube 视频嵌入包含延迟加载、aria-label 和 noscript 备用方案
第 6 阶段:总结
## Blog Optimization Complete: [Title]
### Score Change
- Before: [X]/100 ([Rating])
- Content Quality: [X]/30
- SEO Optimization: [X]/25
- E-E-A-T Signals: [X]/15
- Technical Elements: [X]/15
- AI Citation Readiness: [X]/15
- After: [Y]/100 ([Rating])
- Content Quality: [Y]/30
- SEO Optimization: [Y]/25
- E-E-A-T Signals: [Y]/15
- Technical Elements: [Y]/15
- AI Citation Readiness: [Y]/15
### AI Detection
- Before: ~[X]% AI-detected content
- After: ~[Y]% AI-detected content
- Phrases replaced: [N]
- Burstiness improved: [before SD] -> [after SD]
### Cannibalization
- [Status: none found / flagged N posts / resolved]
### Changes Made
- [X] statistics replaced with sourced data
- [X] SVG charts added (types: ...)
- [X] images added from Pixabay/Unsplash
- Answer-first formatting applied to [N] H2 sections
- FAQ schema injected with [N] questions
- TL;DR box: [added/updated]
- Information gain markers: [N] ([types])
- Citation capsules: [N] across H2 sections
- AI phrases replaced: [N]
- lastUpdated set to [date]
- Self-promotion reduced to [N] mentions
### Visual Elements
- Charts: [count] ([types])
- Images: [count]
- YouTube videos: [count] ([titles])
### Ready for
- `/blog analyze <file>` to verify final score
- Publishing / deploying
第 5.5 阶段:交付契约强制执行
在提交改写后的草稿之前,按照 skills/blog/references/blog-delivery-contract.md 执行 5 道关卡的交付契约。契约对改写的适用方式与对新文章相同:用户绝不能是第一位审阅者。
步骤:
- 主图检查:如果现有文章已引用主图且该图片仍在磁盘上,请保留。如果改写后的主题有重大变化,或主图缺失,请通过
python scripts/generate_hero.py --topic "<new title>" --tags "<tags>" --out <folder>重新生成。 - 重新渲染:运行
python scripts/blog_render.py --md <slug>.md --out-dir <folder>,根据更新后的.md刷新.html和.pdf。 - 分派审阅者:针对渲染后的
.html分派blog-reviewerAgent。门槛:得分达到 90/100 或更高,且没有 P0 问题。 - 预检:运行
python scripts/blog_preflight.py --draft <folder> --strict。退出码为 0 = 可发布;退出码为 1 = 阻止发布。 - 失败后迭代:最多迭代 3 次。第 3 次仍失败后,停止并提交
<folder>/preflight-report.json中的诊断信息。
改写的隐含门槛更高,因为现有草稿可能已经发布。提交比原文更差的内容不可接受。如果改写后的得分低于原文得分,本身即构成 P0 问题。
更新模式
以 /blog update <file> 调用时,重点关注内容时效性:
- 将统计数据更新为最新可用数据(2025-2026)
- 补充上次更新以来的新进展
- 更新超过 1 年的图片
- 更新 frontmatter 中的
lastUpdated - 保留现有结构,尽量减少改写
- 目标:至少更改 30% 的内容,以便 AI 爬虫将其识别为“新鲜”内容