mcpField
B
blog-rewrite

blog-rewrite

github.com/infrasity-labs营销与增长15194 次安装18 周前更新
代码仓库

关于 blog-rewrite

blog-rewrite 是用于审查和改写现有博客文章的技能,关注搜索表现和 AI 引用准备度。它评估内容质量、提交优化计划供确认,并在保留作者风格与原有优点的基础上改写。

主要功能

  1. 01审查内容、SEO 与引用准备度
  2. 02扫描 AI 写作模式
  3. 03检查视频嵌入和关键词重叠
  4. 04研究替换数据与视觉素材
  5. 05保留作者风格改写文章

适用场景

  1. 01修改前审查现有博客文章
  2. 02用有来源的数据替换无依据的统计
  3. 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:审核(只读)
  1. 阅读博客文章 — 检测格式(MDX、markdown、HTML)
  2. 根据 references/quality-scoring.md 运行质量检查清单:
    • 统计虚构数据与有来源的数据
    • 检查答案优先的格式(H2 下的第一句话是否包含统计数据?)
    • 统计图片和图表数量(类型是否多样?)
    • 衡量段落长度(是否有超过 150 个单词的段落?)
    • 检查标题层级(H1 → H2 → H3,是否没有跳级?)
    • 查找 FAQ schema
    • 检查时效性信号(lastUpdated、dateModified)
    • 评估自我推广程度
    • 评估引用来源的等级质量
  3. 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。
  4. 视频嵌入检查:
    • 统计文章中现有的 YouTube 嵌入数量
    • 如果嵌入数量为 0,标记:“没有视频嵌入。YouTube 与 AI 可见性的相关性最强(0.737)”
    • 如果存在嵌入,检查:是否启用了延迟加载?是否有 aria-label?是否有 noscript 后备内容?是否有 VideoObject schema?
  5. 蚕食检查:
    • 根据标题、H1 和第一段确定文章的主要关键词
    • 搜索博客目录,查找其他以相同关键词为目标的文章:
      • 对所有博客文章的标题和元描述进行 grep 搜索
      • 标记关键词重叠显著的文章
    • 如果发现蚕食,报告:
      • 哪些文章在竞争相同的关键词
      • 建议:合并(合并为一篇更有力的文章)或区分(将其中一篇转向相关但不同的关键词)
  6. 计算当前得分,涵盖 5 个类别:
    • 对 5 个类别评分(内容质量 30、SEO 优化 25、E-E-A-T 信号 15、技术要素 15、AI 引用就绪度 15)
    • 总分:0–100
  7. 提供审计摘要,列出具体发现、AI 检测结果、视频状态、蚕食状态和得分
  8. 进入计划模式 — 提供逐章节优化计划 等待用户批准后再继续。
阶段 2:研究
  1. 根据现有内容确定博客的核心主题
  2. 为任何编造或无来源的数据寻找替代统计数据:
    • 搜索:[topic] study 2025 2026 data statistics
    • 仅选择第 1 至第 3 级来源
  3. 如果文章中的图片少于 3 张,则查找图片:
    • Pixabay:site:pixabay.com [topic keywords]
    • Unsplash:site:unsplash.com [topic keywords]
    • 确认每个 URL 均返回 HTTP 200
    • 如果已配置 nanobanana-mcp,则通过 blog-image 提议为缺失或不足的图片使用 AI 生成
  4. 如果文章中的图表少于 2 个,则规划图表:
    • 找出适合可视化的数据
    • 选择多样化的图表类型
阶段 3:图表生成(内置)

当文章需要更多视觉元素时,调用 blog-chart 子技能:

  1. 根据多样性规则选择图表类型(每篇文章中不得重复)
  2. 传入:图表类型、标题、数据值、来源、平台格式
  3. 将返回的 SVG 直接嵌入 <figure> 包装元素中
  4. 每篇 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:验证

改写后,确认所有质量门槛均已通过:

核心质量门槛
  1. 每个 H2 章节均以一项统计数据和来源开头
  2. 每个段落不超过 150 词
  3. 不得编造统计数据
  4. 标题层级清晰
  5. 包含带 schema 的 FAQ 章节
  6. 图片具有描述性 alt 文本
  7. frontmatter 中包含封面图片(coverImage + ogImage)
  8. 如果是 MDX:构建项目以确认没有编译错误
新增要素验证
  1. 引言后包含 TL;DR 框(40-60 词,含统计数据)
  2. 至少包含 2-3 个信息增益标记
  3. 主要 H2 章节中包含引文胶囊(40-60 词,内容独立完整)
  4. 标记内部链接区域或添加实际链接(每 2,000 词 5-10 个)
  5. 不再包含禁止列表中的 AI 检测短语
变化度与自然度检查
  1. 句长差异:标准差 > 6(长短句结合)
  2. 全文自然使用缩略形式
  3. 包含设问(每 200-300 个词 1 个)
  4. AI 内容估算值较审计基线有所降低
  5. 与第 1 阶段审计相比,所有 5 个类别的评分均有所提高
  6. 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 道关卡的交付契约。契约对改写的适用方式与对新文章相同:用户绝不能是第一位审阅者。

步骤:

  1. 主图检查:如果现有文章已引用主图且该图片仍在磁盘上,请保留。如果改写后的主题有重大变化,或主图缺失,请通过 python scripts/generate_hero.py --topic "<new title>" --tags "<tags>" --out <folder> 重新生成。
  2. 重新渲染:运行 python scripts/blog_render.py --md <slug>.md --out-dir <folder>,根据更新后的 .md 刷新 .html 和 .pdf。
  3. 分派审阅者:针对渲染后的 .html 分派 blog-reviewer Agent。门槛:得分达到 90/100 或更高,且没有 P0 问题。
  4. 预检:运行 python scripts/blog_preflight.py --draft <folder> --strict。退出码为 0 = 可发布;退出码为 1 = 阻止发布。
  5. 失败后迭代:最多迭代 3 次。第 3 次仍失败后,停止并提交 <folder>/preflight-report.json 中的诊断信息。

改写的隐含门槛更高,因为现有草稿可能已经发布。提交比原文更差的内容不可接受。如果改写后的得分低于原文得分,本身即构成 P0 问题。

更新模式

以 /blog update <file> 调用时,重点关注内容时效性:

  1. 将统计数据更新为最新可用数据(2025-2026)
  2. 补充上次更新以来的新进展
  3. 更新超过 1 年的图片
  4. 更新 frontmatter 中的 lastUpdated
  5. 保留现有结构,尽量减少改写
  6. 目标:至少更改 30% 的内容,以便 AI 爬虫将其识别为“新鲜”内容

评论

支持 Markdown