blog-planner

博客规划器

为 Electric 博客规划并拟定文章大纲。输出是一份草稿 Markdown 文件，直接放在 website/blog/posts/ 中，并设为 published: false。作者会在大纲中直接展开，将压缩的要点扩写成正文并替换素材。

调用方式

/blog-planner [optional: path to existing draft or reference material]

如果用户提供了现有材料的路径（草稿、文档、PRD、笔记），请阅读以了解背景和内容。理解材料的内容，但不要过度依赖其结构——大纲的结构应由所选格式决定，而不是由源材料决定。

撰写流程

按顺序完成以下阶段。一次只问一个问题。表达清楚、诚实且有帮助。不要把提问变成游戏或刻意表演——提供价值，然后让作者专注于写作。

阶段 1：收集信息

了解初步想法。

• 文章要写什么？
• 作者是谁？（使用 Electric 博客中的作者键：thruflo、 kyle、samwillis、icehaunter、balegas、oleksii、purva）
• 是否有可供参考的现有材料？（草稿、PRD、RFC、演示、 PR、文档。）如果有，请现在阅读。

阶段 2：明确意图

弄清这篇文章为何值得撰写。持续追问，直到每个答案都足够清晰。

• 文章要写什么？——用一句话概括。
• 文章的亮点是什么？——读者为何会关心？吸引点是什么？
• 读者能获得什么？——读完后，读者会了解或相信哪些此前不了解或不相信的内容？
• CTA / 后续步骤是什么？——读者读完后应该做什么？
• 为什么我们 / 作者是撰写这篇文章的合适人选？——什么样的权威性或经验能让内容可信？

这些答案会构成输出文件元信息部分中的「意图」区块。

阶段 3：选择格式

根据文章意图推荐三种格式之一，并与作者确认。如果作者选定了某种格式，就使用该格式，不要再质疑。

格式	适用场景
金字塔原理	有明确观点要表达，需要构建逻辑论证。适合技术说明、「我们如何构建 X」类文章，以及有实质内容的观点文章。
最佳销售演示文稿	介绍一个概念或范式转变。通过叙事展现世界发生的重大变化、赢家和输家，描绘理想前景，并介绍解决方案。适合代表类别转变的产品发布，以及思想领导力文章。
发布公告	有新成果发布，需要清晰地传达。这是渐进式发布和新功能的常用格式。持续发布。

确认后，从 references/ 加载对应的参考文件。

阶段 4：拟定大纲

按照所选格式生成章节级大纲。

• 按章节展示大纲并征求反馈
• 要点应简练，每条都应能以最少的措辞改动扩写成 1-2 句正文
• 添加行内 HTML 注释，说明每个章节在结构上的作用，以及作者应采用的语气和内容方向
• 使用 `` 注释标记素材的位置
• 对于金字塔原理和最佳销售演示文稿格式：TLDR + 信息框应放在格式特有的结构之前
• 反复调整，直到作者满意大纲结构和内容

大纲要点的写作风格：

• 简练、直接、具体
• 每条要点表达一个清晰的观点
• 要点常常需要组合成新的正文，因为它们是对含义的压缩表达——应以此为目标
• 避免使用：「稳健」「可扩展」「灵活」「杠杆」「生态系统」「颠覆性」「革命性」——明确说出实际意思
• 不要出现大模型常见套话——例如「值得注意的是」「重要的是」「总之」「让我们深入探讨」「本质上」「在当今格局中」

阶段 5：个人理念／创意角度

仅适用于金字塔原理和最佳销售演示文稿格式。

挖掘作者的个人角度：

• 是否有某个具体时刻、经历或轶事，能让内容变得真实？
• 是否有一种创意构思，能让背景更生动？

将这些内容融入金字塔格式中的情境／冲突部分，或最佳销售演示文稿格式中的重大变化部分的提纲要点中。添加注释，解释创意元素在结构上如何发挥作用。现在就完成这一步，不要留给作者在扩写正文时自行琢磨。

阶段 6：评估

评估提纲是否实现了阶段 2 中的意图。

• 结构是否服务于文章的核心观点？
• 逻辑是否成立？（非正式评估——看整体是否连贯，而非博士论文式的论证）
• 是否存在缺漏或薄弱部分？
• 读者按照提纲阅读，能否得出预期的结论？
• 开头钩子是否足够有力？

提出任何问题，并与作者迭代修改。

阶段 7：补全元信息

返回页脚元信息部分，为以下内容撰写说明：

• 标题说明——为最终标题指明方向。标题使用句子式大小写，而非标题式大小写。
• 描述说明——用于 SEO。不含 HTML。应传达什么内容？
• 摘要说明——用于博客列表卡片。最多 3 个简短句子。与现有文章摘要的字数保持一致，以确保列表展示效果统一。
• 图片提示词——参阅下方的图片说明指南。如果需要详细的图片说明，建议作者使用 /blog-image-brief 命令。
• 待解决问题——任何尚未解决的问题。

阶段 8：收集素材

提纲确定后，列出所需素材：

• 代码示例、图表（已有或待创建，mermaid 或手动绘制）、演示视频、截图、嵌入的推文、外部博客文章链接
• 将每项素材对应到提纲中的位置
• 注明每项素材是否已存在，或是否需要创建
• 在元信息页脚的素材清单中记录

阶段 9：编写文件

将提纲保存到 website/blog/posts/YYYY-MM-DD-slug.md。

• 文件名前缀使用今天的日期
• 根据工作标题生成 slug（kebab-case）
• 在 frontmatter 中设置 published: false
• 对需要最终确定的 frontmatter 字段（title、description、excerpt）使用 ... 占位符——页脚注释中的说明将指导作者撰写这些内容

输出格式

输出是一篇真实的博客文章文件，作者将在文件中直接继续完善。

Frontmatter

---
title: '...'
description: >-
  ...
excerpt: >-
  ...
authors: [author-key]
image: /img/blog/slug/header.jpg
tags: [...]
outline: [2, 3]
post: true
published: false
---

标题、描述和摘要使用 ...。作者将根据元信息页脚中的说明填写这些内容。标签可根据意图讨论的结果填写。

正文结构

所有格式都遵循以下模式：

1. TLDR 开篇——用 1-2 个简短段落说明这是什么以及为何重要。内容精炼，不铺垫，不带营销语气。技术受众希望立即了解重点。后接包含关键链接的信息框。
2. 特定格式的正文——根据所选格式参考确定章节结构。内嵌 HTML 注释会指导作者了解每个章节的目的和语气。
3. 后续步骤——行动号召、链接以及接下来要做的事。
4. *** 分隔符
5. 带注释的元信息页脚——意图、标题说明、描述说明、摘要说明、图片提示词、素材清单、待解决问题。开头注明发布前删除。

内嵌注释

使用 HTML 注释说明以下内容：

• 结构指导：本章节在格式逻辑中的作用
• 语气指导：作者应如何撰写本章节
• 素材标记：`` 是素材的放置位置
• 作者备注：关于扩展特定要点的具体说明

注释不会在 Markdown 中渲染，作者在扩写各章节时会将其删除。

排版指南

请将以下内容作为检查清单纳入元信息页脚：

• 在适当位置使用不换行空格（HTML 中使用  ，frontmatter 中使用 \u00A0） 和不换行连字符，避免出现孤行和寡行
• 标题必须使用句首字母大写格式，而非标题式大小写
• 在不同屏幕宽度下检查标题、图片和文章整体效果
• 避免出现大模型常见的行文痕迹：“值得注意的是”“重要的是”“总而言之” “让我们深入探讨”“归根结底”“在当今环境中”

博客文章参考

Electric 作者撰写的优秀文章示例。请参考这些文章，把握语气、结构和质量。

金字塔原理／叙事：

• 面向协作式 AI 的持久会话 — thruflo
• 让 Agent 回归现实 — thruflo
• 基于 sync 构建 AI 应用 — thruflo

最佳销售演示／概念：

• 宣布推出 Durable Streams — kyle, samwillis
• 基于 sync 和 TanStack DB 构建超快应用 — thruflo

版本发布文章：

• Electric 1.0 发布 — thruflo
• 宣布推出 Hosted Durable Streams — kyle

图片简要说明（快速版）

如需快速确定图片方向，请在元信息页脚注明：

• 图片主题／概念
• 宽高比：16:9 至 16:10（目标尺寸约为 1536x950px）
• 使用高质量 JPG 作为主图
• 中心构图——关键内容应位于内框中 （响应式裁剪会截去边缘部分）
• 品牌颜色：#D0BCFF（紫色）、#00d2a0（绿色）、#75fbfd（青色）、 #F6F95C（黄色）、#FF8C3B（橙色）
• 深色主题背景
• 网站使用 OpenSauceOne 字体

如需包含参考图片分析和完整 ChatGPT DALL-E 提示词的详细图片说明，请单独使用 /blog-image-brief 命令。

审阅

作者完成大纲初稿后，使用 /blog-review 根据大纲、格式和执行指南审阅草稿。