# Blog Draft

根据想法和资料撰写博客草稿。适用于用户想写博客、基于研究创建内容，或起草文章的场景。流程会引导你完成调研、头脑风暴、提纲编写和带版本控制的迭代撰写。

- Repository: https://github.com/luongnv89/claude-howto (46363 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add luongnv89/claude-howto --skill blog-draft -g -a claude-code -y`
Codex: `npx skills add luongnv89/claude-howto --skill blog-draft -g -a codex -y`
Cursor: `npx skills add luongnv89/claude-howto --skill blog-draft -g -a cursor -y`
Gemini CLI: `npx skills add luongnv89/claude-howto --skill blog-draft -g -a gemini-cli -y`

## Description

根据想法和资料撰写博客草稿。适用于用户想写博客、基于研究创建内容，或起草文章的场景。流程会引导你完成调研、头脑风暴、提纲编写和带版本控制的迭代撰写。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## 用户输入

```text
$ARGUMENTS
```

在继续之前，你**必须**先考虑用户输入。用户应提供：
- **想法/主题**：博客文章的核心概念或主题
- **资源**：用于研究的 URL、文件或参考资料（可选，但推荐）
- **目标读者**：这篇博客是写给谁看的（可选）
- **语气/风格**：正式、轻松、技术向等（可选）

**重要**：如果用户是在请求更新一篇**已有博客文章**，请跳过步骤 0-8，直接从**步骤 9** 开始。先阅读现有草稿文件，再继续迭代流程。

## 执行流程

请按顺序执行以下步骤。**不要跳步，也不要在未获得用户批准的情况下继续执行标明需要确认的步骤。**

### 步骤 0：创建项目文件夹

1. 使用以下格式生成文件夹名称：`YYYY-MM-DD-short-topic-name`
   - 使用今天的日期
   - 根据主题生成一个简短、适合 URL 的 slug（小写、连字符连接，最多 5 个词）

2. 创建文件夹结构：
   ```text
   blog-posts/
   └── YYYY-MM-DD-short-topic-name/
       └── resources/
   ```

3. 在继续前，先向用户确认文件夹已创建。

### 步骤 1：研究与资源收集

1. 在博客文章目录中创建 `resources/` 子文件夹

2. 对于每个提供的资源：
   - **URL**：抓取关键内容并保存到 `resources/` 下的 markdown 文件中
   - **文件**：读取并在 `resources/` 中做摘要
   - **主题**：使用网络搜索收集最新信息

3. 为每个资源在 `resources/` 中创建摘要文件：
   - `resources/source-1-[short-name].md`
   - `resources/source-2-[short-name].md`
   - 以此类推

4. 每个摘要都应包含：
   ```markdown
   # 来源：[标题/URL]

   ## 要点
   - 要点 1
   - 要点 2

   ## 相关引文/数据
   - 引文或统计 1
   - 引文或统计 2

   ## 与主题的关联
   简要说明其相关性
   ```

5. 向用户展示研究摘要。

### 步骤 2：头脑风暴与澄清

1. 基于想法和已研究的资源，展示：
   - 从研究中识别出的**主要主题**
   - 博客文章的**可能切入角度**
   - 应该覆盖的**关键点**
   - 仍需进一步澄清的**信息缺口**

2. 提出澄清问题：
   - 你希望读者最终带走的核心结论是什么？
   - 研究中有没有哪些点是你希望重点强调的？
   - 目标长度是多少？（短：500-800 字，中：1000-1500 字，长：2000+ 字）
   - 有没有哪些内容你希望排除？

3. **在继续之前，等待用户回复。**

### 步骤 3：提出提纲

1. 创建一个结构化提纲，包括：

   ```markdown
   # 博客文章提纲：[标题]

   ## 元信息
   - **目标读者**：[谁]
   - **语气**：[风格]
   - **目标长度**：[字数]
   - **核心结论**：[关键信息]

   ## 建议结构

   ### 开场/引子
   - 开场钩子思路
   - 背景铺垫
   - 论点陈述

   ### 第一部分：[标题]
   - 关键点 A
   - 关键点 B
   - 来自 [来源] 的支撑证据

   ### 第二部分：[标题]
   - 关键点 A
   - 关键点 B

   [继续列出所有部分...]

   ### 结论
   - 关键点总结
   - 行动号召或最终思考

   ## 需要引用的来源
   - 来源 1
   - 来源 2
   ```

2. 向用户展示提纲，并**请求批准或修改意见**。

### 步骤 4：保存已批准的提纲

1. 用户批准提纲后，将其保存为博客文章文件夹中的 `OUTLINE.md`。

2. 确认提纲已保存。

### 步骤 5：提交提纲（如果在 git 仓库中）

1. 检查当前目录是否为 git 仓库。

The rest: https://github.com/luongnv89/claude-howto/blob/HEAD/zh/03-skills/blog-draft/SKILL.md