Claude Code 博客写作提纲模板解析：用 outline-template.md 结构化你的技术文章-编程实验室

Claude Code 博客写作提纲模板解析：用 outline-template.md 结构化你的技术文章

【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto

导读

本文讲解 claude-howto 仓库中 blog-draft Skill 配套的 outline-template.md 博客提纲模板，从元信息设计、五段式结构、来源管理与撰写约束四个层面拆解其设计逻辑，并结合 blog-draft 的完整工作流说明它在"调研 → 头脑风暴 → 提纲 → 草稿 → 迭代"闭环中的位置。读完本文，你将掌握如何在 Claude Code 中用该模板产出结构统一、证据充分、可落地成稿的技术博客提纲，并能把同一方法论迁移到其他写作场景。

一、模板定位：提纲是整个写作流程的"施工图"

在 claude-howto 的 Agent Skills 体系中，blog-draft 是一个以"根据想法和资料撰写博客草稿"为目标的 Skill，其执行流程包含九个步骤：

步骤 0-1：创建blog-posts/YYYY-MM-DD-short-topic-name/resources/目录结构，并针对每个 URL、文件或主题产出source-N-[short-name].md研究摘要；
步骤 2：基于研究结果头脑风暴主要主题、切入角度、关键点与信息缺口，并向用户提出澄清问题；
步骤 3：产出结构化提纲并请求批准；
步骤 4-5：将批准后的提纲保存为OUTLINE.md，若在 git 仓库中则提交（提交信息如docs: Add outline for blog post - [topic-name]）；
步骤 6-8：严格按OUTLINE.md的结构撰写draft-v0.1.md，提交后展示给用户审阅；
步骤 9：按反馈迭代，版本递增为draft-v0.2.md、draft-v0.3.md……

outline-template.md 正是步骤 3 中"结构化提纲"的标准范本，也是步骤 4 保存为OUTLINE.md时的直接蓝本。它与 draft-template.md（草稿成文模板）构成一对"提纲先行、草稿跟进"的组合：先由模板锁死结构与论点，再由草稿模板把每个部分扩写为完整段落。

从仓库目录看，该模板由SKILL.md定义与templates/目录（含outline-template.md与draft-template.md）组成，在 zh/INDEX.md 中被归类为"博客草稿 Skill（3 个文件）"，用途是"生成结构统一的博客草稿"。

二、元信息表：先回答"写给谁、怎么写、写完记住什么"

模板第一小节是元信息表，通过五个属性在动笔前锁定文章的定位：

属性	填写要点	作用
目标读者	明确读者画像，如"初学 Claude Code 的开发者"	决定术语密度、示例深度与铺垫多寡
语气	正式 / 轻松 / 技术 / 对话式	全文风格统一的前提，避免前后割裂
目标长度	给出字数范围	控制每个部分的篇幅配比
核心结论	一句话说明读者应该记住什么	提纲的"北极星"，所有论点最终都要收敛到它
关键词	如有需要，填写 SEO 关键词	为搜索引擎与后续检索提供主题锚点

这与 blog-draft Skill 步骤 2 中向用户提出的澄清问题一一对应："你希望读者最终带走的核心结论是什么？""目标长度是多少？（短：500-800 字，中：1000-1500 字，长：2000+ 字）"。也就是说，元信息表不是可有可无的装饰，而是把用户需求翻译成写作约束的契约层。

在需要被搜索引擎、Agent 和 LLM 检索的场景下，元信息中的"核心结论"与"关键词"尤其重要——它让提纲本身也成为一个可被索引的语义摘要，而不是只有人眼才能读懂的过程文件。

三、五段式结构：从钩子到行动号召的完整叙事弧

模板的"建议结构"采用五段式框架，每一段都配有固定的论证要素：

3.1 引言 / 开场钩子

引言部分提供四种可勾选的开场方式（勾选框[ ]表示写作时从中选用一种）：

与读者产生共鸣的问题；
令人惊讶的统计或事实；
一个简短故事或场景；
大胆的陈述。

随后是背景铺垫（需要提供的背景信息、为什么这个主题现在很重要）和论点陈述（明确说明这篇文章要讲什么）。

在 draft-template.md 中，这一部分被扩写为"开场钩子——立即抓住注意力"、"背景与上下文——说明为什么这件事重要"、"论点陈述"三段正文，可见提纲中的钩子选项在成稿时就是开篇段落的骨架。

3.2-3.4 正文部分：关键点 + 支撑证据 + 过渡

每个正文小节都遵循固定三段式：

关键点：要点 A、要点 B（每条附简要说明）；
支撑证据：来自[source]的相关数据或引文；
过渡到下一部分：明确写出本部分如何与下一部分衔接。

这种设计有两层用意。其一，证据前置：提纲阶段就把每个论点的数据、引文挂到具体来源上，避免成稿时"临时找证据"或出现无依据的论断。其二，过渡显式化：把"段落之间自然流畅的过渡"这一写作要求前置到提纲层，成稿时只需按既定过渡线扩写。

模板允许正文部分按需增减（"如有需要可继续添加"），适用于长文或教程类文章的分节规划。

3.5 结论：总结 + 行动号召

结论部分包含两个固定要素：

关键点总结：回顾要点 1、2、3（与正文各小节一一对应）；
最终思考 / 行动号召：明确读者接下来应该做什么或思考什么。

这与 blog-draft Skill 的质量建议中的 CTA 要求（"以明确的行动号召或发人深省的问题收尾"）完全一致。

四、来源清单与撰写备注：写作前的最后两道闸门

需要引用的来源

模板要求以编号列表列出所有待引用来源，并为每条注明用途（"用于：对应信息"）。这与 blog-draft Skill 步骤 6 的引用要求呼应——成稿时"所有比较、统计数据和事实性陈述都必须引用原始来源"，且使用[1]、[2]或[Source Name]行内引用，在文末参考资料区链接。提纲中的来源清单正是这套引用体系的前置登记表，能有效防止成稿阶段出现"无出处数据"。

撰写备注

模板最后提供自由填写的备注区：

任何特别要求或限制；
需要强调的内容；
需要避免的内容。

这为提纲附加了"约束上下文"——例如品牌词规范、禁用的对比表述、需要强调的差异化卖点等，成稿时这些备注会直接影响 draft-template.md 中对应部分的扩写方向。

五、模板在仓库中的完整用法

结合仓库现状，实际使用该模板的推荐路径如下：

定位文件：模板位于 zh/03-skills/blog-draft/templates/outline-template.md（英文原版在 03-skills/blog-draft/templates/outline-template.md，多语言版本位于ja/、uk/、vi/对应目录）；
安装 Skill：将 blog-draft 复制到~/.claude/skills/或项目.claude/skills/目录（参考 zh/INDEX.md 的安装路径说明）；
触发流程：在 Claude Code 中调用/blog-draft，提供想法、资源、目标读者与语气；
产出提纲：Claude 按本模板结构生成提纲，经用户批准后保存为OUTLINE.md，再进入草稿撰写与版本迭代阶段。