关于 write-content
面向营销内容创作的 Skill,通过研究、内容类型选择、知识提取和写作生成 SEO 文章,并提供品牌上下文与反套路写作规则。
主要功能
- 01四阶段文章工作流
- 02搜索结果研究与类型选择
- 03持久化业务上下文
- 04实践者风格写作规则
- 05SEO 结构与最终检查
适用场景
- 01根据关键词撰写文章
- 02将内容简报扩展成文章
- 03按品牌语气调整文章
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ inhouseseo/ superseo-skills --skill write-content安装后在 Claude Code 中输入/write-content确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/anti-slop-ruleset.mdcontent-types-overview.mdeeat-signal-embedding.mdfact-checking.mdgeo-optimization.mdhuman-input-framework.mdinformation-gain-writing.mdintent-matching.mdnavboost-engagement.mdquality-scoring.mdseo-optimization-layer.mdreferences/content-types/alternatives-page.mdbuying-guide.mdcase-study.mdcategory-page.mdcomparison.mddefinition.mdfaq-page.mdglossary-page.mdhow-to.mdintegration-page.mdlanding-page.mdlisticle.mdlocation-page.mdnews-article.mdpillar-page.mdproduct-page.mdprogrammatic-page.mdservice-page.mdstatistics-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 无法生成的细节:用户数据、示例、观点、经验。
最终检查
- “所以呢?”测试:针对每个主要章节,问问自己:谁都能为任何人写出任何主题的这段内容吗?如果答案是肯定的,就加入具体知识。
- 自查:检查黑名单词语、每段都以主题句开头的章节、不必要的章节总结以及附加分词短语。交付前修正。
输出
干净的 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 阶段)