教程文档【免费下载链接】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技能把这条链路标准化为一套可直接复用的模板与九步执行流程——本文以 草稿模板 为主体结合 技能定义 与 提纲模板完整拆解这套写作流水线。读完你既能逐段掌握草稿模板的骨架与填充规范也能理解从研究、提纲、初稿到版本迭代的完整工作流并能在 Claude Code 中直接安装使用。一、模板定位draft-template.md 解决什么问题blog-draft是 claude-howto 在 03-skills 目录下提供的一个 Agent Skill其description明确说明适用场景Draft a blog post from ideas and resources. Use when users want to write a blog post, create content from research, or draft articles. Guides through research, brainstorming, outlining, and iterative drafting with version control.整套技能由三个文件组成见 INDEX.md 的目录说明blog-draft/ ├── SKILL.md # 技能定义与九步执行流程 └── templates/ ├── draft-template.md # 博客草稿模板本文核心 └── outline-template.md # 博客提纲模板draft-template.md的本质是一个填充式fill-in-the-blank结构骨架它不替你写内容而是把一篇专业博客的固定结构——标题区、开头三件套、正文小节、结论、参考文献、元信息页脚——全部用占位符标注出来。它的价值有三点消除空白页焦虑所有结构问题这一节写什么、下一节写什么在动笔前已被模板回答作者只需逐块填充结构一致性同一团队、同一作者的多篇文章遵循同一骨架读者阅读成本低Agent 可执行性模板中的占位符本身就是给 Claude 的任务清单配合SKILL.md的流程指令Claude 可以按部就班地把想法 资料转化为成稿。二、逐段拆解草稿模板从标题到元信息页脚打开 draft-template.md全文 75 行可以看到一条清晰的自上而下信息链。下面逐段说明每一块的用途与填充方法。2.1 头部区标题、副标题与作者信息模板开头三行对应 draft-template.md# [Blog Post Title] *[Subtitle or tagline - optional]* **[Author Name]** | [Date]H1 标题[Blog Post Title]是占位符实际写作时应替换为具体标题。从 claude-howto 自身的写作实践看好的标题会直接点明技术主题与价值例如本项目 README 采用Master Claude Code in a Weekend这类明确、可检索的写法副标题用*斜体*包裹可选。作用是在主标题之外补充一句说明性或吸引性的短语作者与日期行**[Author Name]** | [Date]用加粗与竖线分隔建立文章署名与时间锚点。2.2 开头三件套钩子、背景与论点模板在第一条分隔线后固定了三段开头结构draft-template.md[Opening hook - grab attention immediately] [Context and background - why this matters] [Thesis statement - what this post will cover]Opening hook钩子第一句话的目标是立刻抓住读者。blog-draft技能的Tips for Quality一节给出了四种可选项以问题开场question that resonates、抛出惊人数据surprising statistic or fact、讲一个简短的场景故事brief story or scenario、或给出一个大胆判断bold statementContext and background背景解释为什么这个话题现在重要为读者建立必要的知识前提Thesis statement论点声明明确声明这篇文章将覆盖什么让读者带着预期阅读。这三段是模板中信息密度最高的部分也是决定文章能否被继续读下去的关键——模板用占位符强制作者在展开正文前先想清楚凭什么开场、为什么重要、要讲什么。2.3 正文小节主论点、证据与过渡模板用## [Section N Title]组织正文draft-template.md每个小节的内部结构是## [Section 1 Title] [Section content with clear, engaging prose] [Include evidence, examples, or data to support points] Relevant quote from research - Source [Transition to next section]这里体现了三个写作规范证据优先每个论点都要附带 evidence、examples 或 data 支撑不能只有观点引用块模板专门给出了 Relevant quote from research - Source的格式要求对研究资料的关键引语注明来源显式过渡每个小节末尾要有[Transition to next section]保证段落之间逻辑衔接而不是各段孤立。模板还给出了两种正文增强元素Key takeaway在重要小节中用加粗或提示框形式高亮关键结论例如**Key takeaway:** [Highlight important points in bold or callout boxes]子小节用### Subsection (if needed)处理需要细分的内容保持主标题下的层次清晰。2.4 结论总结、强化与收尾## Conclusion一节固定三段draft-template.md[Summarize the key points covered] [Reinforce the main takeaway] [Call to action or thought-provoking final statement]即先总结全文要点再强化核心信息最后以行动号召或引发思考的语句收尾。这与SKILL.md中End with a clear call-to-action or thought-provoking question的质量要求完全对应。2.5 参考文献与作者信息## References 1. [Source Title](#) 2. [Source Title](#) 3. [Source Title](#)参考文献使用编号列表配合正文中的内联引用见下文第五节形成可追溯的证据链。之后是可选的作者简介或相关文章推荐*[Optional: Author bio or related posts suggestion]*。2.6 元信息页脚可维护性与版本锚点模板最后一屏是完整的元信息区draft-template.md**Last Updated**: August 4, 2026 **Claude Code Version**: 2.1.220 **Sources**: - [来源链接占位] **Compatible Models**: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5这个页脚是 claude-howto 全仓库文档的通用惯例仓库内 03-skills 下几乎所有 SKILL.md 和模板都以相同的四行元信息收尾Last Updated文档最后更新时间便于读者判断时效性Claude Code Version该内容所适配验证的 Claude Code 版本号模板中记录为 2.1.220Sources内容依据的来源列表Compatible Models经过验证的兼容模型清单例如模板记录的 Claude Fable 5、Claude Opus 5、Claude Sonnet 5、Claude Sonnet 4.6、Claude Opus 4.8、Claude Haiku 4.5。对一篇技术博客而言这个页脚让文章是什么时候写的、基于哪个版本、依据哪些资料一目了然既方便读者评估也方便日后回滚修订。三、先提纲后成稿outline-template.md 支撑的两阶段写作blog-draft技能把一次性写出全文拆成了**提纲Outline→ 草稿Draft**两个阶段对应两套模板。提纲阶段使用 outline-template.md其结构与草稿模板互补3.1 Meta Information写作前先锁定约束提纲模板开头的元信息表强制作者在动笔前明确五个参数Attribute说明Target Audience这篇文章写给谁Tone正式 / 轻松 / 技术向 / 对话式Target Length目标字数区间Main Takeaway一句话读者应该记住什么Keywords若适用列出 SEO 关键词这五个字段把写作意图显式化——Claude 与作者在进入正文前先对齐目标读者、语气、篇幅、核心结论避免写成四不像。3.2 Proposed Structure逐节规划要点与证据提纲正文按### 1. Introduction / Hook、### 2. [Section Title]等编号小节展开每个小节固定包含Key Points本节的要点列表Point A / Point B…Supporting Evidence来自哪个来源的哪条数据或引语Transition to next section如何过渡到下一节。引言部分还提供了四种钩子选项的勾选清单- [ ] Question that resonates with reader等方便作者在规划阶段就选定开场策略。3.3 Sources to Cite 与 Notes for Drafting提纲末尾的Sources to Cite以编号形式预先登记所有要引用的资料及各自用途Used for: [what information]Notes for Drafting则记录写作的特殊要求、要强调的内容和要避免的东西。这些约束在成稿阶段会被SKILL.md的 Step 6 严格执行——Follow the structure from OUTLINE.md exactly。从仓库文件可以看到提纲模板与草稿模板形成了清晰的上下游关系提纲确定结构outline-template → OUTLINE.md→ 草稿填充内容draft-template → draft-v0.1.md。四、九步执行流水线SKILL.md 如何驱动模板落地模板只是静态骨架真正让写作过程可重复、可控制的是 blog-draft/SKILL.md 中定义的九步执行流程。整个流程按顺序推进且在关键节点要求用户确认。Step 0创建项目文件夹以YYYY-MM-DD-short-topic-name命名如2026-10-10-claude-skillstopic 转成小写、连字符分隔、不超过 5 个词的 URL 友好 slug。目录结构为blog-posts/ └── YYYY-MM-DD-short-topic-name/ └── resources/Step 1研究与资料收集对用户提供的每个资源URL / 文件 / 主题进行处理并在resources/下生成编号摘要文件source-1-[short-name].md、source-2-[short-name].md等。每个摘要文件固定包含三部分见 SKILL.md# Source: [Title/URL] ## Key Points - Point 1 - Point 2 ## Relevant Quotes/Data - Quote or statistic 1 ## How This Relates to Topic Brief explanation of relevance摘要文件为后续提纲提供了可引用的证据池。Step 2头脑风暴与澄清基于研究结果向用户展示主主题main themes、可选切入角度potential angles、应覆盖的要点key points和信息缺口gaps并提问主要 takeaways 是什么、哪些研究点需要强调、目标篇幅短 500–800 字 / 中 1000–1500 / 长 2000、要排除哪些内容。此步必须等待用户回复。Step 3–4提出提纲并保存使用 outline-template 生成结构化提纲含 Meta Information、Proposed Structure、Sources to Cite提交用户审批获批后保存为OUTLINE.md。Step 5 与 Step 7git 提交检查点若当前目录是 git 仓库则在提纲保存后提交docs: Add outline for blog post - [topic-name]在草稿完成后再次提交docs: Add draft v0.1 for blog post - [topic-name]不是 git 仓库则跳过并告知用户。这两个提交点让整个写作过程可回滚、可追踪。Step 6撰写草稿严格按 OUTLINE.md 的结构写完整草稿保存为draft-v0.1.md。此步的硬性要求包括吸引人的引言钩子、清晰的章节标题、来自研究资料的证据与示例、小节间的平滑过渡、强结论以及所有数据点、统计、对比都必须内联标注来源。Step 8–9评审与迭代Step 8 将草稿提交用户评审征求总体印象、需扩写/缩减的章节、语气调整、缺失信息、具体修改意见然后等待用户响应。Step 9 根据反馈分支用户要求修改 → 回到 Step 6版本号递增v0.2、v0.3…保存为新文件draft-v[X.Y].md重复 Steps 7–8用户批准 → 确认最终版本可选重命名为final.md并总结全过程总版本数、各版本关键变更、最终字数、创建的文件。版本跟踪与输出结构所有草稿以递增版本号保留便于追溯演进与回退SKILL.mdblog-posts/ └── YYYY-MM-DD-topic-name/ ├── resources/ │ ├── source-1-name.md │ └── ... ├── OUTLINE.md ├── draft-v0.1.md ├── draft-v0.2.md (if iterations) └── draft-v0.3.md (if more iterations)draft-v0.1.md是初始草稿draft-v0.2.md是第一轮反馈后依此类推。五、引用规范把证据变成硬约束blog-draft技能对引用的要求是全流程最严格的环节这一要求直接对应草稿模板中引用块 编号参考文献的结构设计必须引用的内容所有统计与数据点如 According to [Source], 75% of...、产品/方案/框架之间的对比如 X performs 2x faster than Y [Source]、关于市场趋势/研究结论/基准测试的事实性陈述引用格式支持编号引用[1]、[2]或命名引用[Source Name]、[Author, Year]并需在文末 References 部分建立对应条目。技能给出了正反示例Studies show that 65% of developers prefer TypeScript [1]正React outperforms Vue in rendering speed by 20% [React Benchmarks 2024]正。结合模板的 Relevant quote from research - Source引用块和编号参考文献区这条研究 → 摘要 → 引用的证据链覆盖了从资料收集到成稿的全过程。六、安装与使用在 Claude Code 中启用 blog-draftblog-draft被仓库归类为User 作用域的技能见 CATALOG.md 的技能表安装命令为cp -r 03-skills/blog-draft ~/.claude/skills/安装到个人技能目录cp -r 03-skills/blog-draft ~/.claude/skills/安装后向 Claude 提出类似 Write a blog post、Draft an article 的请求即可触发该技能这与description中声明的触发词一致。技能启动时用户应提供以下输入见 SKILL.mdIdea/Topic博客文章的核心主题必填ResourcesURL、文件或参考资料可选但推荐Target audience目标读者可选Tone/Style正式、轻松、技术向等可选。值得注意的一个快捷路径如果用户请求的是更新已有博客文章技能会跳过 Steps 0–8直接从 Step 9 开始——先读取现有草稿文件再进入迭代流程避免为修改一篇旧文重建整套目录与提纲。七、在仓库中的定位模板如何与其它能力协同从 INDEX.md 的说明看blog-draft的定位是Draft blog posts with consistent structure以一致的结构起草博客文章它与 03-skills 目录下的其它技能形成了互补生态brand-voice03-skills/brand-voice/SKILL.md负责语气与品牌一致性。它定义了Dos / Donts清单如用主动语态、句子控制在 20 词内、避免 corporate jargon并以user-invocable: false作为后台知识自动生效——写博客时由它把关措辞由 draft-template 把关结构doc-generator03-skills/doc-generator/SKILL.md擅长生成 API 文档类内容其每个 Endpoint 一段文档的模板思想与博客模板异曲同工claude-md03-skills/claude-md/SKILL.md负责项目记忆文件可为博客写作提供项目上下文。从 Skills 的通用机制看见 03-skills/README.md这套模板体系还受益于渐进式披露progressive disclosure架构SKILL.md与模板属于 Level 2被触发时才加载的指令通常控制在 5k token 内resources/摘要文件属于 Level 3按需加载的捆绑文件因此安装大量技能不会带来显著的上下文开销。八、结语从单文件视角看draft-template.md只是一个 75 行的填充骨架但放在blog-draft技能体系中它是一套完整写作流水线的终点产物格式——上游有 outline-template 锁定结构与证据SKILL.md 提供九步可审批的执行流程、资源摘要规范、内联引用硬约束和draft-v0.1 → draft-vX.Y的版本化迭代。这套组合把写技术博客从一次性的灵感行为变成了可复制、可评审、可回滚的工程流程。如果你想在自己的 Claude Code 环境中落地这套方法只需要两步把03-skills/blog-draft复制到~/.claude/skills/然后向 Claude 提出一个主题与参考资料即可。下一次面对空白页面时模板会替你完成最难的那一步——把结构先立起来。参考仓库文件草稿模板提纲模板技能定义与执行流程技能总览技能目录索引目录结构说明赞分享教程文档【免费下载链接】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 技能在 Claude Code 中写出结构化的技术文章claude howto 博客草稿模板解析用 blog draft 技能在 Claude Code 中写出结构化的技术文章 导读 claude howto教程文档claude-howto 实战用 blog-draft Skill 与 draft-template 模板搭建技术博客写作工作流claude howto 实战用 blog draft Skill 与 draft template 模板搭建技术博客写作工作流 本文以 claude how教程文档claude-howto 实战用 blog-draft 提纲模板把博客写作变成一条可复用的 Agent 流水线claude howto 实战用 blog draft 提纲模板把博客写作变成一条可复用的 Agent 流水线 博客文章质量的高低往往在动笔之前就已经注定教程文档创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考