Skills

Blog Draft

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

Install

npx skills add luongnv89/claude-howto --skill blog-draft -g -a claude-code -y
Repository
luongnv89/claude-howto46.4k
Category
Engineering
Updated
7d ago
License
MIT
Context cost
Lightabout 1,028 tokens
Runs scripts
No, instructions only

What it does

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

用户输入

$ARGUMENTS

在继续之前,你必须先考虑用户输入。用户应提供:

  • 想法/主题:博客文章的核心概念或主题
  • 资源:用于研究的 URL、文件或参考资料(可选,但推荐)
  • 目标读者:这篇博客是写给谁看的(可选)
  • 语气/风格:正式、轻松、技术向等(可选)

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

执行流程

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

步骤 0:创建项目文件夹

  1. 使用以下格式生成文件夹名称:YYYY-MM-DD-short-topic-name

    • 使用今天的日期
    • 根据主题生成一个简短、适合 URL 的 slug(小写、连字符连接,最多 5 个词)
  2. 创建文件夹结构:

    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. 每个摘要都应包含:

    # 来源:[标题/URL]
    
    ## 要点
    - 要点 1
    - 要点 2
    
    ## 相关引文/数据
    - 引文或统计 1
    - 引文或统计 2
    
    ## 与主题的关联
    简要说明其相关性
    
  5. 向用户展示研究摘要。

步骤 2:头脑风暴与澄清

  1. 基于想法和已研究的资源,展示:

    • 从研究中识别出的主要主题
    • 博客文章的可能切入角度
    • 应该覆盖的关键点
    • 仍需进一步澄清的信息缺口
  2. 提出澄清问题:

    • 你希望读者最终带走的核心结论是什么?
    • 研究中有没有哪些点是你希望重点强调的?
    • 目标长度是多少?(短:500-800 字,中:1000-1500 字,长:2000+ 字)
    • 有没有哪些内容你希望排除?
  3. 在继续之前,等待用户回复。

步骤 3:提出提纲

  1. 创建一个结构化提纲,包括:

    # 博客文章提纲:[标题]
    
    ## 元信息
    - **目标读者**:[谁]
    - **语气**:[风格]
    - **目标长度**:[字数]
    - **核心结论**:[关键信息]
    
    ## 建议结构
    
    ### 开场/引子
    - 开场钩子思路
    - 背景铺垫
    - 论点陈述
    
    ### 第一部分:[标题]
    - 关键点 A
    - 关键点 B
    - 来自 [来源] 的支撑证据
    
    ### 第二部分:[标题]
    - 关键点 A
    - 关键点 B
    
    [继续列出所有部分...]
    
    ### 结论
    - 关键点总结
    - 行动号召或最终思考
    
    ## 需要引用的来源
    - 来源 1
    - 来源 2
    
  2. 向用户展示提纲,并请求批准或修改意见。

步骤 4:保存已批准的提纲

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

  2. 确认提纲已保存。

步骤 5:提交提纲(如果在 git 仓库中)

  1. 检查当前目录是否为 git 仓库。
Read the whole SKILL.md on GitHub

More in Engineering