根据想法和资料撰写博客草稿。适用于用户想写博客、基于研究创建内容,或起草文章的场景。流程会引导你完成调研、头脑风暴、提纲编写和带版本控制的迭代撰写。
$ARGUMENTS
在继续之前,你必须先考虑用户输入。用户应提供:
重要:如果用户是在请求更新一篇已有博客文章,请跳过步骤 0-8,直接从步骤 9 开始。先阅读现有草稿文件,再继续迭代流程。
请按顺序执行以下步骤。不要跳步,也不要在未获得用户批准的情况下继续执行标明需要确认的步骤。
使用以下格式生成文件夹名称:YYYY-MM-DD-short-topic-name
创建文件夹结构:
blog-posts/
└── YYYY-MM-DD-short-topic-name/
└── resources/
在继续前,先向用户确认文件夹已创建。
在博客文章目录中创建 resources/ 子文件夹
对于每个提供的资源:
resources/ 下的 markdown 文件中resources/ 中做摘要为每个资源在 resources/ 中创建摘要文件:
resources/source-1-[short-name].mdresources/source-2-[short-name].md每个摘要都应包含:
# 来源:[标题/URL]
## 要点
- 要点 1
- 要点 2
## 相关引文/数据
- 引文或统计 1
- 引文或统计 2
## 与主题的关联
简要说明其相关性
向用户展示研究摘要。
基于想法和已研究的资源,展示:
提出澄清问题:
在继续之前,等待用户回复。
创建一个结构化提纲,包括:
# 博客文章提纲:[标题]
## 元信息
- **目标读者**:[谁]
- **语气**:[风格]
- **目标长度**:[字数]
- **核心结论**:[关键信息]
## 建议结构
### 开场/引子
- 开场钩子思路
- 背景铺垫
- 论点陈述
### 第一部分:[标题]
- 关键点 A
- 关键点 B
- 来自 [来源] 的支撑证据
### 第二部分:[标题]
- 关键点 A
- 关键点 B
[继续列出所有部分...]
### 结论
- 关键点总结
- 行动号召或最终思考
## 需要引用的来源
- 来源 1
- 来源 2
向用户展示提纲,并请求批准或修改意见。
用户批准提纲后,将其保存为博客文章文件夹中的 OUTLINE.md。
确认提纲已保存。
检查当前目录是否为 git 仓库。
如果是:
OUTLINE.mddocs: Add outline for blog post - [topic-name]如果不是 git 仓库,则跳过此步骤并告知用户。
基于已批准的提纲,撰写完整博客草稿。
严格按照 OUTLINE.md 的结构进行编写。
包含:
将草稿保存为博客文章文件夹中的 draft-v0.1.md。
格式:
# [博客文章标题]
*[可选:副标题或标语]*
[包含行内引用的完整正文...]
---
## 参考资料
- [1] 来源 1 标题 - URL 或引用
- [2] 来源 2 标题 - URL 或引用
- [3] 来源 3 标题 - URL 或引用
引用要求:
检查是否处于 git 仓库中。
如果是:
docs: Add draft v0.1 for blog post - [topic-name]如果不是 git 仓库,则跳过并告知用户。
向用户展示草稿内容。
询问反馈:
等待用户回复。
如果用户要求修改:
draft-v[X.Y].md如果用户批准:
final.md所有草稿都会以递增版本号保留:
draft-v0.1.md - 初始草稿draft-v0.2.md - 第一轮反馈后draft-v0.3.md - 第二轮反馈后这可以跟踪博客文章的演变过程,并在需要时回退。
blog-posts/
└── YYYY-MM-DD-topic-name/
├── resources/
│ ├── source-1-name.md
│ ├── source-2-name.md
│ └── ...
├── OUTLINE.md
├── draft-v0.1.md
├── draft-v0.2.md(如果有迭代)
└── draft-v0.3.md(如果还有更多迭代)