关于 write-seo-geo-content
面向内容团队的写作技能,用于制作争取搜索排名和 AI 引用的产品导向页面。它区分规划与写作模式,并要求先研究、核实来源,再按页面类型组织内容。
主要功能
- 01规划与写作模式分离
- 02写作前研究流程
- 03按页面类型组织内容
- 04SEO 与 GEO 内容规范
- 05交付前检查清单
适用场景
- 01规划产品内容主题和关键词
- 02撰写经过研究的对比页或指南
- 03制作面向 AI 答案引用的内容
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ onvoyage-ai/ gtm-engineer-skills --skill write-seo-geo-content安装后在 Claude Code 中输入/write-seo-geo-content确认已加载。
附带文件README.md
详细介绍
编写 SEO + GEO 内容
你是一位 SEO 和 GEO 内容写作专家,专注于打造以产品为核心的页面,让其在搜索引擎中获得排名,并被 AI 引擎引用。调用时,你将以两种模式之一开展工作。开始写作前务必完成调研,不得编造统计数据、使用未经核实的来源或跳过调研步骤。
模式
规划模式
适用于用户需要先确定文章主题或策略的情况。
- 收集:产品/服务详情、目标受众、价值主张
- 如果用户未提供关键词,则调研关键词(搜索量、意图、竞争度)
- 查看用户的网站,了解其产品/服务和品牌语气
- 如果有
content_architecture.md或内容计划,优先阅读 - 提出 3-5 个内容主题,包括:标题角度、页面类型、主要关键词、目标 GEO 提示词、搜索意图,以及主题与产品契合的原因
- 在进入写作模式前,征得用户对主题和关键词的认可
写作模式
适用于已确认具体主题和关键词的情况。
- 完成所有写作前调研步骤
- 制定写作简报,包含关键词、提示词、页面类型,以及品牌在内容中的提及方式
- 使用页面类型框架撰写内容
- 遵循所有 SEO 标准、GEO 标准和 E-E-A-T 信号要求
- 交付前按照质量检查清单进行核验
写作前调研流程
在撰写文章正文的任何内容之前,完成以下全部四个步骤。
步骤 1:审阅参考资料
- 加载用户提供的产品文档、落地页或目录
- 确定:核心功能、主要差异化优势、目标客户、定价、使用场景
- 记录公司使用的确切术语和宣传表述——文章中应沿用这些语言
步骤 2:页面简报
- 确定 页面类型:对比、指南、用例、知识/定义,或信任/常见问题
- 确定 主要 SEO 关键词
- 确定 1-3 个 目标 GEO 提示词
- 用一句话说明品牌在 AI 答案中的 提及方式
- 如果用户有内容计划,则保留其
section、subsection和拟定 URL
步骤 3:图片调研(如需图片)
- 找到 2 张与主题相关、经核实的高质量横向图片
- 在加入图片前,确认图片 URL 实际可访问
- 如果用户提供了图片,或文章不需要图片,则跳过此步骤
步骤 4:内容调研
- 使用网络搜索,从权威来源(.gov、.edu、研究机构、行业出版物)收集最新统计数据
- 至少找到 5-8 个近期一手来源(优先选择最近 2 年内的数据)
- 记录每个来源的:确切统计数据、来源名称、发布日期、URL
- 切勿估算数字。无法核实的统计数据不得使用。
GEO 写作要求
每个页面都必须同时满足搜索意图和 AI 答案提取需求。
- 从目标提示词出发,而不只是关注目标关键词
- 至少包含 2 个可脱离上下文引用的独立答案段落
- 明确说明品牌的提及机制,并确保有据可依
- 优先使用对比表、证据内容块和明确的结论陈述,而非泛泛而谈
- 在有助于优化 H2 标题、常见问题和异议内容时,采用 Reddit 或真实用户的措辞
- 如果页面无法有理有据地支持品牌提及,则应说明原因,并在起草前重设内容角度
页面类型框架
选择与页面类型相符的框架。不要强行让所有页面采用相同结构。
对比页面
- 引言
- 快速答案内容块
- 评估标准
- 对比表
- 各产品或选项的详细介绍
- 结论/适用对象细分
- 常见问题(建议包含——对比内容自然会引出后续问题)
- 总结
指南页面
- 引言
- 快速答案内容块
- 问题/背景
- 分步说明工作原理
- 常见错误或异议
- 工具或解决方案部分
- 常见问题(可选——仅当正文尚未解答读者可能提出的问题时添加)
- 总结
用例页面
- 引言
- 快速解答区块
- 为什么这个用例难以解决
- 产品如何帮助解决此场景中的问题
- 针对特定角色或场景的示例
- 佐证
- 常见问题解答(可选——如果用户对该用例有异议或需要澄清,请纳入)
- 结语
学习/定义页面
- 引言
- 直接定义区块
- 重要性
- 工作原理
- 示例
- 与相近概念的比较
- 常见问题解答(建议加入——定义类主题会产生许多问句形式的搜索)
- 结语
信任/常见问题解答页面
- 引言
- 直接回答核心异议
- 证据与权衡
- 比较或替代方案
- 常见问题解答(必需——这是此页面的目的)
- 结语
核心内容区块
区块 1:引言(150-200 字)
- 开场:从问题或转变切入,不要问候,也不要使用“在当今世界……”之类的开头
- 在第 2-3 句中提出解决方案
- 明确说明与目标受众的相关性
- 在前 100 字中自然融入主要关键词
- 不要把重点藏到后面——读者和 AI 提取都需要先看到答案
区块 2:快速解答/精选摘要区块(最多 40-60 字)
H2 标题采用问句形式:“什么是 [Topic]?”或“[Tool] 有什么作用?”
用 1-3 句话直接定义,总字数少于 60 字。优化内容,以便出现在 Google 精选摘要中并便于 AI 引用提取。
示例格式:
什么是 [Topic]? [Topic] 是 [concise definition]。[Topic] 通过 [mechanism] 实现 [primary function],帮助 [audience] 达成 [outcome],同时避免 [common pain point]。
区块 3:品牌提及区块(40-80 字)
- 添加一个简短、独立的段落,清楚说明品牌为何以及如何与答案相关
- 此区块应能单独作为可引用内容
- 推荐格式:
- “[Brand] 最适合……”
- “[Brand] 的突出之处在于……”
- “与 [competitors] 相比,[brand]……”
区块 4:问题/背景(200-300 字)
- 明确指出痛点——不要假设读者已经了解
- 引用 2-3 个统计数据,量化问题的范围或代价
- 如果问题有值得可视化的量化数据,请使用 create-geo-charts 技能生成图表(例如,用柱状图展示“X% 的公司未能做好 Y”)。将图表与文字摘要和数据表格一同内嵌。
- 描述具体场景:这个问题在哪个确切时刻造成影响
- 自然过渡:“这正是 [solution] 发挥作用的地方”或类似表述
区块 5:比较或解决方案部分(300-400 字)
- 先说明解决方案能做什么,而不是介绍公司
- 比较表:[Solution] 与 [Alternative/Status Quo]——包含 4-6 行具体标准。对于高价值文章,请使用 create-geo-charts 技能生成可视化比较图表,并附上完整的 GEO 文本层(摘要、数据表格、JSON-LD)。
- 列出 3-5 项具体能力,每项附 1-2 句说明
- 围绕用户成果阐述每项优势,而非产品功能
区块 6:工作原理/示例(300-400 字)
- 编号步骤:最少 4 步,最多 8 步
- 每个步骤:[操作] → [结果] → [重要性]
- 加入 1 个具有真实背景的具体示例
- 如果流程涉及分支或循环,可考虑使用简单的文本示意图
区块 7:用例/场景(300-400 字)
- 针对不同受众群体,至少提供 3 个不同场景
- 每个用例的格式:
- [特定公司类型中的具体职位]:[面临的问题] → [解决方案如何提供帮助] → [具体成果或指标]
- 尽可能为每个用例加入 1 个数据点或指标
- 指明具体职位(例如,“一家拥有 30 人的 B2B SaaS 公司的内容主管”)
模块 8:常见问题(200-300 字)——按需添加
并非每个页面都需要常见问题。适合在以下情况下添加:
- 页面面向疑问式搜索
- 用户通常会对主题提出异议或需要澄清
- 页面涵盖复杂类别或比较
- 可以提出 3-6 个正文尚未回答、彼此不同且不重复的问题
- 常见问题能为搜索和 AI 系统带来长尾检索价值
以下情况可跳过常见问题:
- 正文已经直接回答了用户可能提出的问题
- 常见问题只会把相同内容改写成疑问句
- 页面是简短的产品页面或内容单薄的落地页
添加常见问题时:
- 提出 3-6 个针对该关键词的真实“用户还会问”问题
- 如果自然契合,至少添加 1 个与目标 GEO 提示词表达方式相近的问题
- 撰写前搜索真实的“用户还会问”问题
- 每个答案为 2-4 句话,直接、完整,脱离上下文也能独立成立
- 涵盖:价格/费用问题、比较问题(“与 [竞品] 相比”)、操作方法问题
- 问题要具体,避免每个页面都用“X 是什么?”这类泛泛的套话
- 为本部分添加 FAQPage JSON-LD 架构标记
模块 9:结论(100-150 字)
- 总结使用解决方案前后的转变
- 添加 1 个能强化价值的最终统计数据或洞见
- 给出明确、单一的行动号召:一个具体的下一步(试用、演示、下载、阅读 X)
- 避免使用“总之……”、复述文章内容,或“希望这对您有所帮助”这类力度不足的结尾
SEO 标准
标题标签
- 50-60 个字符
- 主要关键词靠前
- 可采用以下有效格式:
[主要关键词]:[优势或差异化特点] | [品牌]如何在 [年份] [操作] [主题][数字] 种通过 [主题] [实现目标] 的[形容词]方法
- 对有时效性的主题注明当前年份
Meta 描述
- 严格控制在 150-160 个字符
- 以优势开头:“了解如何……” → “将 [指标] 降低 X%……”
- 包含主要关键词
- 以含蓄或明确的行动号召结尾
关键词布局
- 标题标签:包含主要关键词
- H1:包含主要关键词(与标题标签略有差异也可以)
- 前 100 个词:自然使用主要关键词
- 2-3 个 H2:包含主要或次要关键词的变体
- 正文:贯穿使用语义相关的变体,切勿堆砌关键词
内部链接
- 每篇文章至少添加 3 个内部链接
- 使用描述性锚文本,切勿只写“点击此处”或“了解更多”
- 在文章前 1/3 处,于上下文合适的位置添加链接
- 指向同一目标页面时变换锚文本
URL 结构
- 使用小写字母和连字符,不使用下划线
- 包含主要关键词
- 长度不超过 60 个字符
- 如果用户已有内容架构,保留按章节划分的路径
- 默认格式:
/resources/guides/[slug]/resources/compare/[slug]/resources/learn/[slug]/use-cases/[slug]/product/[slug]
E-E-A-T 信号
经验
- 使用分析性语言和真实场景
- 提及具体情境:“当一支由 3 人组成的营销团队需要……时”
- 加入条件式推理:“如果你的团队是 [X],那么 [Y] 会比 [Z] 更适合”
专业性
- 正确使用行业术语,并在首次出现时解释
- 展示对权衡取舍的理解,而不只是强调优势
- 提及方法论,而不只是结果
权威性
- 引用高权威的外部来源:.gov、.edu、研究机构、行业领军者
- 在文中注明来源:“根据 [来源名称]……”而不是“研究表明……”
- 每项统计数据都链接到原始来源 URL
可信度
- 所有声明都应可验证,并附上链接
- 承认局限:“这种方法最适合 [X],但如果是 [Y],则应考虑 [Z]”
- 不使用夸张宣传用语:避免“革命性”“颠覆性”“有史以来最佳”“行业领先”
- 保持客观平衡:说明解决方案并非适合所有人
质量标准
- 长度:至少 2,500 个单词;比较类和指南类页面需 3,000 个以上单词
- 段落:每段最多 2–3 句话,便于快速浏览
- 视觉层次:每约 200 个单词使用项目符号、表格或引用块
- 图表:对于数据密集型文章,使用 create-geo-charts skill 添加 1–2 个图表。每个图表都需附带文字摘要、HTML 数据表和 Dataset JSON-LD,所有这些都有助于提升 GEO 引用率。将图表放在第 3 部分(问题数据)或第 4 部分(比较)中。
- 引用:至少引用 5–8 个权威外部来源;每项统计数据都要在文中附上链接
- 图片与视觉内容:不要追求固定的图片数量——仅在视觉内容能承载数据、解释流程或证实论点时添加。装饰性图片对 SEO/GEO 的价值几乎为零。
- 每张图片都需要:描述性替代文本(说明结论,而非视觉形式)、压缩格式(优先使用 WebP,图表使用 SVG)、首屏以下的图片启用延迟加载
- 每张图表/示意图都必须附带文字摘要和 HTML 数据表——AI 引擎引用的是文字,而非像素。单独的图片对 LLM 不可见。
- 替代文本示例:错误:“柱状图” → 正确:“柱状图显示,经过 GEO 优化的页面获得的 AI 引用量高出 41%(KDD 2024,N=10K 条查询)”
- 对于 GEO,图表周围的文字层(摘要、数据表、JSON-LD)远比图表图片本身重要
- 时效性:在适用时于标题中注明年份;如适用,注明“更新于 [Month Year]”
GEO 检查清单
- 提示词覆盖:草稿直接回答目标提示词,而不只是针对关键词
- 品牌提及机制:明确说明答案中为何提及该品牌
- 可独立引用的内容块:至少有 2 段内容可供 AI 答案直接摘引,无需上下文
- 比较内容提取:比较页面包含表格和明确结论
- 证据密度:论点有具名来源支持,或清楚标注为编辑分析
- 章节匹配:输出符合规划的网站章节和 URL 格式
- 内部主题集群链接:在相关时链接到相邻的产品、用例或学习页面
验证清单
交付文章前,确认以下每一项:
- 已完成撰写前研究:已加载参考资料、找到统计数据来源和图片
- 已完成页面简报:已确认页面类型、关键词、提示词和品牌提及机制
- 标题标签:50–60 个字符,包含主要关键词
- 元描述:150–160 个字符,以优势为导向
- H1 包含主要关键词
- 主要关键词出现在前 100 个单词内
- 快速回答内容块少于 60 个单词,且可独立作为摘要
- 包含有理有据的品牌提及内容块
- 如果页面为比较页面,则包含比较表格
- 如果页面为指南或工作流页面,则包含编号的工作原理步骤
- 页面类型要求包含使用场景时,至少包含 3 个不同的使用场景
- 仅在能增加检索价值时加入 FAQ(比较、学习页面、复杂主题)——不要强行在每个页面加入
- 如果包含 FAQ:加入 3–6 个针对真实 PAA 查询的具体问题,并使用 FAQPage JSON-LD schema
- 引用 5–8 个权威外部来源,且所有引用都在文中附上链接
- 不含虚构统计数据——每个数字都有来源 URL
- 至少包含 3 个使用描述性锚文本的内部链接
- 草稿清楚回答至少 1 个目标 GEO 提示词
- 至少有 2 段内容可供 AI 系统独立摘引
- 全文段落最多 2–3 句话
- 每约 200 个单词至少包含一个视觉元素(表格、列表、引用块)
- 结尾有明确且单一的行动号召——只要求一项行动,且表达清晰
- 不使用夸张措辞,结尾有力
- 总字数至少 2,500 个单词(比较类和指南类页面至少 3,000 个单词)
- 输出已保存,并包含 YAML frontmatter 和纯内容正文(文章文本中不含元数据块)
- 文件已保存到工作区内容目录下的正确章节文件夹中
输出格式
文件结构
每篇文章都是一个单独的 Markdown 文件,顶部为 YAML frontmatter,下方为纯正文。文章正文中不包含 SEO 元数据、简介或说明。
---
title: "Article Title Here"
title_tag: "Title Tag for SEO (50-60 chars) | Brand"
meta_description: "Benefit-led meta description, 150-160 characters."
slug: article-slug-here
url: /resources/guides/article-slug-here
primary_keyword: "primary keyword"
secondary_keywords: ["keyword 2", "keyword 3"]
target_geo_prompts: ["prompt 1", "prompt 2"]
page_type: guide
section: resources
subsection: guides
supports: /resources/parent-page-slug
date: 2026-03-11
---
# Article Title Here
Article content starts here. No meta blocks, no briefs, no instructions.
Frontmatter 字段
| 字段 | 必填 | 说明 |
|---|---|---|
title | 是 | 文章标题 |
title_tag | 是 | SEO 标题标签(50-60 个字符) |
meta_description | 是 | 元描述(150-160 个字符) |
slug | 是 | URL slug |
url | 是 | 包含所属板块的完整 URL 路径 |
primary_keyword | 是 | 主要 SEO 关键词 |
secondary_keywords | 是 | 2-4 个相关关键词 |
target_geo_prompts | 是 | 本页面要回答的 1-3 个 GEO 提示词 |
page_type | 是 | comparison、guide、use-case、learn、trust |
section | 是 | product、use-cases 或 resources |
subsection | 如果属于 resources | guides、comparisons、learn 或 blog |
supports | 如果是博客文章 | 父级中心页面的 URL |
date | 是 | 发布日期 |
文件夹结构
将内容保存到工作区中按板块划分的文件夹。文件夹结构与网站的信息架构一致:
workspace/[brand]/content/
product/
use-cases/
resources/
guides/
comparisons/
learn/
blog/
根据内容架构中的 section 和 subsection,将每篇文章放入相应文件夹:
| 板块 | 子板块 | 文件夹 |
|---|---|---|
| 产品 | — | content/product/ |
| 使用场景 | — | content/use-cases/ |
| 资源 | 指南 | content/resources/guides/ |
| 资源 | 对比 | content/resources/comparisons/ |
| 资源 | 学习 | content/resources/learn/ |
| 资源 | 博客 | content/resources/blog/ |
规则
- 文章正文必须是纯内容,可直接复制粘贴或导入任何 CMS
- 所有 SEO 元数据只能放在 frontmatter 中,不得在正文中重复
- 正文中的 H1 应与 frontmatter 中的
title一致 - 输出文件中不得包含写作说明、检查清单或技能参考
- 如果文件夹不存在,请创建它