blog-post-writing

博客文章写作

此技能可帮助 AI Agent 撰写结构清晰、引人入胜且经过 SEO 优化的博客文章，涵盖多种内容类型，包括操作指南、清单文章、观点文章、案例研究和思想领导力文章。Agent 负责完整的创作流程，从主题研究和大纲规划，到撰写、SEO 优化和最终审核，最终产出适合发布、符合目标受众和品牌调性的内容。

工作流

1. 研究主题和关键词 调查主题，了解其范围、当前讨论和搜索意图。确定一个主要关键词和 3-5 个需要覆盖的次要关键词。分析主要关键词搜索结果中排名靠前的内容，了解哪些角度、深度和格式效果较好。判断搜索意图是信息型（“如何设置 CI/CD”）、导航型（“GitHub Actions 文档”）还是交易型（“2025 年最佳 CI/CD 工具”）。

2. 选择内容格式 选择最符合主题和搜索意图的博客文章格式。对于以流程为导向的查询，使用操作指南；对于比较或汇总类查询，使用清单文章；对于思想领导力和品牌定位，使用观点文章；对于展示成果和建立可信度，使用案例研究。内容格式决定大纲的结构模板。

3. 构建大纲 创建详细大纲，包括标题（包含主要关键词）、引言的吸引点、正文的 H2 和 H3 小标题，以及带有行动号召的结尾。确保标题描述清晰，并自然融入次要关键词。规划代码块、图片、引用块、统计数据以及内部和外部链接等辅助元素的放置位置。

4. 撰写初稿 将大纲扩展为完整文章。以能引发好奇、陈述惊人事实或直接指出读者痛点的开场吸引点开篇。接着用清晰的论点句说明读者能从文章中获得什么。按照合理的顺序撰写正文各部分，并在各部分之间使用过渡句。结尾总结关键要点，并给出具体的 CTA——订阅、下载、试用产品或阅读相关文章。

5. 优化 SEO 在标题、首段、至少一个 H2 标题和元描述中放入主要关键词。根据需要在小标题和正文中自然使用次要关键词，切勿生硬堆砌。撰写 150-160 个字符的元描述，总结文章内容并包含主要关键词。为所有图片添加替代文本说明。确保 URL slug 简短且包含关键词。

6. 审核和润色 校对语法、拼写和标点。核实所有统计数据和论断均有可信来源。检查所有链接是否有效且指向正确的目标。大声朗读文章（或模拟朗读），以发现不自然的表达。确保文章达到目标字数，且没有任何部分显得内容单薄或冗长。

用法

向 Agent 提供以下信息：

• 主题——博客文章的主题或暂定标题
• 目标关键词——主要 SEO 关键词（可选；Agent 可以自行研究）
• 内容格式——操作指南、清单文章、观点文章、案例研究，或让 Agent 推荐
• 受众——文章面向的读者（开发者、营销人员、管理人员、普通大众）
• 语气——专业、轻松、对话式、权威、风趣
• 字数——目标长度（例如，800、1500、2500 个单词）
• CTA——读者阅读后应采取的行动

提示词示例：“撰写一篇 1,500 字的操作指南博客文章，介绍如何使用 GitHub Actions 设置 CI/CD 流水线。目标关键词：‘GitHub Actions CI/CD 教程’。受众：初级开发者。语气：友好且鼓励性。”

示例

示例 1：包含已填写章节的完整博客文章大纲

输入：“为一篇清单式文章撰写大纲：‘2025 年每位 Python 开发者都需要的 7 个 VS Code 扩展’。受众：中级 Python 开发者。填写引言和一个列表项作为示例。”

输出：

**标题：**2025 年每位 Python 开发者都需要的 7 个 VS Code 扩展

**元描述：**使用这 7 个必备 VS Code 扩展，提升 Python 工作流，涵盖代码检查、测试、调试等功能。2025 年更新。

**目标关键词：**VS Code extensions Python

---

引言（已填写）：

Visual Studio Code 成为最受 Python 开发者欢迎的代码编辑器是有充分理由的——它速度快、免费，而且可以无限自定义。但原版 VS Code 安装所展现的功能还只是冰山一角。合适的扩展可以将它变成一款功能齐全的 Python IDE，提供智能自动补全、实时代码检查、一键调试，以及无缝的虚拟环境管理。以下是 7 个扩展，它们会在 2025 年每天为你节省大量时间。

1. Pylance — 强化版 IntelliSense（已填写）：

Pylance 用基于 Pyright 构建的极速类型检查器和自动补全引擎，替换默认的 Python 语言服务器。它能在你运行代码前发现类型错误，在你输入时显示行内文档，还能处理默认扩展完全无法识别的复杂类型注解。如果你写任何带类型标注的 Python 代码——而你应该这样做——Pylance 就是必备之选。安装一次，你就会纳闷以前没有它时是怎么写代码的。

2. Ruff — 闪电般快速的代码检查与格式化［待填写］

3. Python Test Explorer — 可视化测试运行器［待填写］

4. GitLens — 编辑器中的 Git 历史记录［待填写］

5. Docker — 容器管理［待填写］

6. Jupyter — 在 VS Code 中使用交互式笔记本［待填写］

7. autoDocstring — 一键生成文档字符串［待填写］

**结论：**回顾这些扩展，强调配置完善的编辑器能大幅提升工作效率，并添加行动号召：“在评论中分享你最喜欢的 Python 扩展。”

示例 2：撰写带有吸引点的引言段落

输入：“为一篇标题为‘为什么你的初创公司应该从第一天起就采用基础设施即代码’的博客文章撰写引言段落。受众：非技术背景的初创公司创始人。吸引方式：令人意外的统计数据。”

输出：

在第一年经历重大基础设施故障的初创公司中，有 68% 永远无法完全挽回因此流失的客户。这并非危言耸听——这是 Datadog 在 2024 年可靠性调查中得出的结论。讽刺的是，这些故障大多源于手动配置服务器：有人不小心输错设置、忘记开放端口，或者在最关键的时候无法复现生产环境。基础设施即代码（IaC）通过将服务器、网络和部署视为受版本控制的代码，彻底消除了这类风险——这些代码可以像其运行的软件一样接受审查、测试和回滚。你不需要专门的 DevOps 团队就能开始，而越早采用，积累的技术债务就越少。在这篇文章中，我们将详细介绍 IaC 究竟是什么、为什么即使只有 5 名员工也值得采用，以及如何在一个下午内完成设置。

最佳实践

• 开篇直入主题，不要先讲背景。 读者会在前两句话内决定是否继续阅读。可以用一个令人惊讶的事实、一个发人深省的问题，或直接点明读者面临的问题来开篇。背景信息留到第二段再说。
• 使用描述性强且包含关键词的标题。 “步骤 3：配置数据库连接”比“步骤 3：配置”更好。标题应当便于读者快速浏览时独立理解。
• 拆分较长的章节。 博客文章中，任何段落都不应超过 4-5 句话。使用小标题、项目符号、代码块和引文来营造视觉节奏，方便读者快速浏览。
• 添加站内和站外链接。 站内链接能让读者留在你的网站上，并提升 SEO。指向可靠来源的站外链接则能建立信任。每 1,000 个词添加 2-3 个站内链接和 1-2 个站外链接。
• 以明确的 CTA 收尾。 每篇博客文章都应邀请读者采取行动：订阅、试用产品、发表评论或阅读下一篇文章。没有 CTA 的文章会错失机会。
• 围绕精选摘要撰写内容。 将其中一个章节写成对主要关键词查询的简洁直接回答。使用定义段落、编号列表或表格，以便 Google 将其提取为精选摘要。

边缘情况

• 没有搜索量的主题： 对于面向小众受众的思想领导力或观点文章，SEO 优化不如原创性和深度重要。应着眼于独特见解，而不是关键词密度。
• 竞争激烈的关键词： 如果搜索结果靠前的页面都来自高权威域名，可以改为针对该关键词的长尾变体（例如，使用“适用于 monorepos 的 GitHub Actions CI/CD 教程”，而不是“CI/CD 教程”），以找到有机会获得排名的小众领域。
• 有时效性的内容： 提及特定工具版本、定价或活动的文章应注明“最后更新”日期，并说明相关信息可能已发生变化。应计划定期更新内容。
• 多作者博客： 为已有固定风格的博客撰稿时，应先阅读 2-3 篇近期发布的文章，以匹配其现有语气、句式风格和格式规范。
• 超长文章（3,000 词以上）： 在顶部添加带锚点链接的目录。考虑是否应将文章拆分为系列，以提升可读性并保持读者的持续参与。