关于 blog-drafter
Blog Drafter 是一项引导式写作技能,帮助作者围绕自身观点构思博客文章。它通过访谈梳理论点和提纲、提出研究建议,并在结构获认可后协助润色正文。
主要功能
- 01通过访谈提炼独特论点
- 02构建结构化文章提纲
- 03提出针对性研究建议
- 04指出尚待展开的问题
- 05获批提纲后润色正文
- 06调整语气、开篇和技术深度
适用场景
- 01将初步主题转化为明确论点
- 02根据个人经历编排文章提纲
- 03梳理待查证据与反方观点
- 04按偏好风格修订文章
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ petekp/ agent-skills --skill blog-drafter安装后在 Claude Code 中输入/blog-drafter确认已加载。
详细介绍
博客撰稿助手
通过访谈挖掘用户的独特观点,然后生成包含论点、提纲和研究建议的结构化草稿。
流程概览
Phase 1: Discovery Interview → Structured Draft + Research
Phase 2: Prose Refinement Interview (after user approves draft)
阶段 1:探索性访谈
开场
询问用户想写什么主题。如果用户已经说明主题,就确认并直接进入访谈。
访谈策略
使用 AskUserQuestion 提供结构化选项。使用常规追问进行开放式探索。总共进行 4-6 轮提问。
第 1 轮:核心论点
AskUserQuestion:
question: "What's the single most important thing you want readers to take away?"
options:
- "A specific insight or realization"
- "A call to change behavior or practice"
- "A framework or mental model"
- "A contrarian or non-obvious take"
接着追问:“你能用一句话说清楚吗?”
第 2 轮:“为什么重要”
直接询问:“为什么 PM、设计师或工程师现在应该关注这个问题?它解决了什么痛点,或带来了什么机会?”
第 3 轮:证据与经验
AskUserQuestion:
question: "What's your strongest evidence for this thesis?"
options:
- "Personal experience or case study"
- "Data or research I've seen"
- "Pattern I've observed across projects/companies"
- "Logical argument from first principles"
接着追问:“请具体讲讲这个案例或证据。”
第 4 轮:预想异议
询问:“有人可能提出的最有力反对意见是什么?持怀疑态度的人会怎么说?”
第 5 轮:独特视角
AskUserQuestion:
question: "What makes your perspective different from what's already written on this topic?"
options:
- "I have direct experience others don't"
- "I'm connecting ideas that aren't usually connected"
- "I disagree with conventional wisdom"
- "I have a specific framework or process"
第 6 轮:范围与形式
AskUserQuestion:
question: "What length and depth feels right?"
options:
- "Short and punchy (800-1200 words)"
- "Standard blog post (1500-2500 words)"
- "Deep dive (3000+ words)"
访谈原则
- 留意矛盾之处——它们往往揭示真正的洞见
- 回答比较抽象时,要求对方提供具体案例
- 如果论点听起来很泛泛,就追问:“什么情况会让别人不同意这个观点?”
- 记录用户使用的具体表达和术语
阶段 1 输出:结构化草稿
访谈结束后,生成以下内容:
1. 论点陈述
用一句清晰的话陈述核心论点。
2. 草稿结构
## [Working Title]
**Hook**: [Opening that creates tension or curiosity]
**Thesis**: [Core argument, stated directly]
### Section 1: [Setup/Context]
- Key point
- Key point
### Section 2: [Core Argument/Evidence]
- Key point with specific example from interview
- Key point
### Section 3: [Addressing Objections]
- Anticipated resistance
- Response
### Section 4: [Implications/Call to Action]
- What readers should do differently
- Why it matters
**Closing**: [Callback to hook or forward-looking statement]
3. 研究建议
提供 3-5 条具体建议:
- 可引用的相关研究、书籍或文章
- 能强化论证的数据点
- 能说明观点的知名公司或产品案例
- 研究成果与论点相关的专家或从业者
将建议整理为可执行事项:
## Suggested Research
- [ ] Look for data on [specific metric/phenomenon] to support Section 2
- [ ] Reference [Author]'s work on [topic] for theoretical grounding
- [ ] Find a counter-example from [domain] to strengthen the objection response
- [ ] Check if [Company] has published anything on their approach to [topic]
4. 待解问题
指出 2-3 个需要进一步深入探讨或澄清的方面,以增强文章内容。
展示草稿后,询问:“这个结构能准确表达你想说的内容吗?有没有哪些部分不合适或有所遗漏?”
阶段 2:正文润色
仅在用户批准结构后启动阶段 2。
润色访谈
第 1 轮:语气
AskUserQuestion:
question: "What tone fits this piece?"
options:
- "Conversational and accessible"
- "Authoritative and direct"
- "Provocative and opinionated"
- "Thoughtful and nuanced"
第 2 轮:开篇风格
AskUserQuestion:
question: "How do you like to open posts?"
options:
- "Start with a story or anecdote"
- "Lead with the controversial claim"
- "Open with a question"
- "Set up a problem or tension"
第 3 轮:技术深度
询问:“我应该解释到什么程度?读者是否已经熟悉[访谈中的关键概念],还是需要一些背景介绍?”
第 4 轮:具体偏好
询问:“你喜欢或讨厌哪些写作习惯?(例如,‘我从不用项目符号’或‘我总会加入代码示例’)”
润色输出
将结构扩展为完整正文,并融入以下内容:
- 贯穿全文的指定语气
- 选定的开篇风格
- 适当的技术深度
- 用户提出的偏好
标出需要用户亲自补充其表达风格的部分:
[VOICE: Add your personal take on why this matters to you]
[EXAMPLE: Insert specific story from your experience here]
提醒用户:“这是贴合你个人表达风格的起点。最后一遍修改由你来完成。”