mcpField
W
write-content

write-content

github.com/inhouseseo营销与增长373151 次安装8 周前更新
代码仓库

关于 write-content

面向营销内容创作的 Skill,通过研究、内容类型选择、知识提取和写作生成 SEO 文章,并提供品牌上下文与反套路写作规则。

主要功能

  1. 01四阶段文章工作流
  2. 02搜索结果研究与类型选择
  3. 03持久化业务上下文
  4. 04实践者风格写作规则
  5. 05SEO 结构与最终检查

适用场景

  1. 01根据关键词撰写文章
  2. 02将内容简报扩展成文章
  3. 03按品牌语气调整文章

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/inhouseseo/superseo-skills --skill write-content

安装后在 Claude Code 中输入/write-content确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
anti-slop-ruleset.md
content-types-overview.md
eeat-signal-embedding.md
fact-checking.md
geo-optimization.md
human-input-framework.md
information-gain-writing.md
intent-matching.md
navboost-engagement.md
quality-scoring.md
seo-optimization-layer.md
references/content-types/
alternatives-page.md
buying-guide.md
case-study.md
category-page.md
comparison.md
definition.md
faq-page.md
glossary-page.md
how-to.md
integration-page.md
landing-page.md
listicle.md
location-page.md
news-article.md
pillar-page.md
product-page.md
programmatic-page.md
service-page.md
statistics-page.md

详细介绍

撰写内容

撰写完整的 SEO 优化文章。分为四个阶段:研究 → 内容类型决策 → 知识提取 → 撰写。包含完整的反 AI 套话规则集,以及让输出听起来像从业者而非新闻稿的语气规则。

输入

  • 主题或目标关键词(必填)
  • (可选) 现有内容简报 — 如果已提供,则跳过研究阶段
  • (可选) 来自 expert-interview 技能的专家访谈输出

如果没有提供主题,请先询问。

业务背景持久化

业务背景(受众、语气、语言、品牌声音、示例)会影响每篇文章。不要每次会话都重复询问这些问题。

首次使用:提出 4-5 个问题,并将答案保存到 Agent 环境中的某个持久位置。优先使用最安全的默认位置:

  • Claude Code:建议默认保存到 ~/.claude/projects/<path>/memory/business-context.md。除非用户明确要求,否则不要写入 ./CLAUDE.md — CLAUDE.md 是用户的项目说明文件,擅自向其中追加内容可能会在之后每次 Agent 响应时让用户感到意外。
  • Claude Desktop / Claude.ai:保存到项目上下文或置顶笔记中。
  • Cursor:.cursor/rules/business-context.md。
  • 任何其他 Agent:保存到工作目录中的 seo-context.md。

保存之前,务必先向用户确认写入位置。如果以上位置都不可用,或用户对此有异议,则每次会话都重新询问这些问题。

首次使用时的问题:

  • 企业的业务是什么?目标客户是谁?
  • 品牌的语气是什么?(专业 / 随意 / 技术性 / 权威 / 对话式)
  • 内容应该使用什么语言撰写?
  • 有哪些主题绝对不能涉及?(合规、提及竞品等)
  • 2-3 个主要竞争对手是谁?

阶段 1:研究

如果没有提供内容简报,请在 Google 上搜索该主题并阅读排名最高的 5 个结果。记录排名靠前的内容格式、已有的切入角度,以及你发现的内容缺口。用 3-5 个要点概述,不要撰写完整简报。

如果简报或之前的对话上下文中已经包含 SERP 分析,则完全跳过此阶段。

阶段 2:内容类型决策

根据排名靠前的内容,选择一种内容类型:操作指南、定义 / 说明、对比(X vs Y)、清单 / 综述、产品评测、案例研究、支柱页 / 终极指南、常见问题解答、落地页、服务页面、新闻 / 趋势分析。

明确说明: “关键词 [keyword] 的排名靠前结果全部采用 [format] 格式。我会撰写一篇 [content type],并采用 [key structural element]。可以吗?还是你有其他想法?”

等待确认。如果用户已经一次性要求撰写文章,或没有人可以回复(自主运行),则用一句话说明选择及理由,然后继续。

加载 references/content-types-overview.md,查看涵盖全部 23 种内容类型的决策表。然后加载对应的模板:references/content-types/<type>.md(例如 references/content-types/how-to.md),了解 H1/H2 结构、schema、精选摘要格式、CTA 位置和目标字数。完整模板涵盖的 19 种内容类型为:操作指南、定义、对比、清单、支柱页、常见问题页面、落地页、服务页面、案例研究、统计数据页面、新闻文章、术语表页面、替代方案页面、购买指南、产品页面、类别页面、集成页面、位置页面、程序化页面。仅由概览表涵盖的 4 种类型(思想领导力、产品评测、定价页面、关于页面)位于 eeat-audit/references/content-types/ 下,因为 E-E-A-T 标准是这些类型的关键因素。

第 3 阶段:提取知识

提出 2–3 个简短问题,挖掘用户掌握的独特知识。从以下问题中挑选:

  • “关于 [主题],大多数人会误解什么?”
  • “能给我一个具体例子吗——某位客户、一个项目或一个数字?”
  • “亲自实践后,有什么让你感到意外?”
  • “哪些人不应该听从这条建议?为什么?”

一次只问一个。尽量简短。

如果用户无法或不愿回答——自主运行,或者跳过问题——就只根据第 1 阶段的研究撰写,并在交付内容中注明,加入一手资料能让文章更出色。

调整风格:

  • 网站较新或规模较小,用户对 SEO 不太熟悉:采用对话式风格,并解释每个问题的用意
  • 网站成熟,用户经验丰富:快速直接,不必事事解释

第 4 阶段:撰写文章

长度:不要设定具体字数目标。深度要与第 1 阶段中排名靠前的内容相匹配。长度取决于搜索意图和竞争情况——绝不要为了凑字数而填充内容。

用简洁的 Markdown 撰写完整文章。遵守以下所有规则:

语气与立场
  • 像从业者与同行交谈那样写。不要像教科书,也不要像新闻稿。
  • 明确表达立场。“我们测试过,发现 X 比 Y 更有效”胜过“X 和 Y 各有优点”。
  • 使用“你”和“我/我们”——面向一个人写作,而不是一群人。
  • 写出具体的数字、名称和日期。不要写“许多公司”——要写“[Company] 在 [year]”。
  • 具体信息必须真实:来自第 1 阶段的研究、访谈回答或业务背景。绝不虚构数字、名称、研究或引文——虚构的具体信息比笼统表述更糟。没有真实信息可用?就去问,或者删掉相关论断。
  • 将访谈回答融入第一人称经历。在表达自然时保留原有措辞。
  • 使用缩略形式:“doesn't”,而不是 “does not”。
  • 展现思路如何变化:“起初我以为这是品牌问题——结果发现,问题一直出在定价上。”自我修正能体现真实感。
  • 结合真实背景——适时提及时事、行业变化或文化热点。
节奏与结构
  • 大幅改变句子长度。将 5 个词的短句和 30 个词的复杂句混合使用。绝不要连续出现 3 个或更多长度相近的句子。
  • 段落长度也要有所变化。一句话的段落可以,6 句话的段落也可以。
  • 用不完整句强调重点。自然时可以用“And”或“But”开头。
  • 加入括号中的旁注和简短的岔题——人类会这样写,AI 不会。
  • 切换语体。在技术解释后,插入一句随意的旁白。语体始终一致会显得像 AI 写的。
  • 打破“主题句—论据支撑”的模式。有些段落可以从例子、问题或读下去才明白的陈述开始。
  • 各部分的篇幅不必平均。对有趣的部分写 500 个词,对枯燥但必要的部分写 50 个词。
  • 除非内容确实复杂(有 3 个或更多子章节),否则不要在章节末尾总结。
展示,而不只是陈述
  • 不要只陈述事实,要用简短场景展现事实。例如,不要写“页面速度影响排名”,而要写“你点开一个搜索结果。三秒过去了。页面还在加载。你按下返回键。Google 记录了每一毫秒。”
  • 对于基于经验的论断,讲述当时的情形:尝试了什么、发生了什么、有什么出乎意料。
反套路规则

绝 NEVER 使用这些词 — 最能暴露 AI 痕迹的词: 深入探讨、(比喻义的)格局、证明、借助、利用、强大、无缝、此外、而且、另外、关键、多方面、发挥……的作用、开启、(比喻义的)探索、展示、简化、至关重要、最终达到、带头、开始、努力、充满活力、创新、全面(作形容词时)。

绝 NEVER 使用这些短语: “值得注意的是”、“在当今的[任何领域]”、“让我们深入探讨”、“总之”、“发挥关键/重要/至关重要的作用”、“不言而喻”、“在……领域”。

避免这些结构模式:

  • 三项并列(改用 2 项或 4 项)
  • 同义词轮换(重复使用合适的词,不要另找替代词)
  • 回避系动词(“充当”——直接说“是”)
  • 连用破折号(每 1000 个词最多使用 1 至 2 个)
  • 二元对比(“不是 X,而是 Y”——直接阐述观点)
  • 附加分词短语(“……凸显了 X 的重要性”——删掉或另起一句)
  • 扎堆使用“然而”“值得注意的是”“本质上”“话虽如此”“可以说”:单独使用没问题,但一篇文章中出现 3 个或更多就会显得像 AI 写的
内容类型结构
  • 操作指南:先给出 40 至 60 词的快速答案(目标是争取精选摘要),然后列出编号步骤,每个步骤只执行一项操作,并说明可能出现的问题
  • 对比:先给结论(“如果……,选择 A。如果……,选择 B。”),然后详细分析
  • 清单文章:在首屏上方放置摘要表格,并为每项采用一致的评估框架
  • 定义:第一句写“[术语] 是……”,不要写引言
  • 案例研究:先给出结果数据,再讲述故事(PAS 框架)
  • 支柱页面:放置目录、概述,然后链接到深入介绍的文章
  • 服务/落地页:采用 PAS 框架。先指出痛点,再强调后果,最后给出解决方案
SEO 结构
  • 在元标题、H1、前 100 个词以及 2 至 3 个 H2 中加入主要关键词。关键词在正文中的占比约为 2%,自然分布。
  • 在最重要的 H2 之后立即给出 40 至 60 词的直接答案,以争取精选摘要。“How”类问题使用有序列表,“what is”类问题使用段落,对比内容使用表格。
  • 在文章中将 2 至 3 个 PAA 问题设为 H2/H3 标题,并直接作答。
  • 每 1000 个词添加 3 至 5 个站内链接。使用描述性锚文本,切勿使用“点击此处”。
  • 优先呈现有价值的信息。首屏最为重要,不要写铺垫段落。
长篇文章策略(1500 词以上)
  • 按章节撰写。记录已涵盖的内容,避免重复和语气偏移。
  • 文章中至少 30% 的内容必须包含通用 AI 无法生成的细节:用户数据、示例、观点、经验。
最终检查
  1. “所以呢?”测试:针对每个主要章节,问问自己:谁都能为任何人写出任何主题的这段内容吗?如果答案是肯定的,就加入具体知识。
  2. 自查:检查黑名单词语、每段都以主题句开头的章节、不必要的章节总结以及附加分词短语。交付前修正。
输出

干净的 Markdown。标题和文章内容。除此之外不要写任何内容。

语言

使用业务背景指定的语言。如果未指定,则使用与用户消息相同的语言。

捆绑参考资料

仅当步骤或规则要求时,才从 references/ 加载。不要预加载——每个文件都很大,叠加加载会耗尽上下文。

内容类型模板(references/content-types/)——在第 2 阶段后加载一个:

  • 通用:how-to.md、definition.md、comparison.md、listicle.md、pillar-page.md、faq-page.md、landing-page.md、service-page.md、case-study.md
  • 内容与新闻:statistics-page.md、news-article.md、glossary-page.md
  • 商业类:alternatives-page.md、buying-guide.md、product-page.md、category-page.md、integration-page.md、location-page.md、programmatic-page.md
  • references/content-types-overview.md 提供涵盖全部 23 种内容类型的决策表(不确定选择哪种类型时,先加载此文件)

写作技巧模块(references/)——当第 4 阶段的相应规则需要深入内容时加载:

  • anti-slop-ruleset.md — 完整的分级禁用词汇和结构特征列表(内嵌的反 AI 腔模块未能发现问题时)
  • voice-injection-playbook.md — 语气与语域技巧(草稿读起来平淡时)
  • information-gain-writing.md — 30% 规则及其落实方法(用于通过“所以呢”测试)
  • serp-driven-writing.md — 第 1 阶段的研究如何塑造文章(草稿偏离 SERP 意图时)
  • intent-matching.md — 根据意图决定篇幅和格式(SERP 意图不明确时)
  • eeat-signal-embedding.md — 如何在不设简介部分的情况下体现经验
  • structured-data-snippets.md — 按内容类型设置 JSON-LD 和精选摘要格式
  • geo-optimization.md — 针对 AI Overview / 生成式引擎引用进行优化
  • navboost-engagement.md — 撰写参与度信号(停留时间、滚动深度)
  • quality-scoring.md — 交付前执行的自评分标准
  • writing-pipeline.md — 研究 → 起草 → 编辑的流程
  • seo-optimization-layer.md — 关键词布局、内部链接和元数据检查
  • fact-checking.md — 如何核实每个具体数字和说法
  • human-input-framework.md — 知识提取问题(强化第 3 阶段)

评论

支持 Markdown