1️⃣ 设定写作目标与受众

要素提问 Claude Code 的示例
目标“我想写一篇面向中级后端开发者的文章，帮助他们理解 Event Sourcing 的核心概念并快速上手。”
受众痛点“这些读者通常困惑于日志增长、回放性能和一致性验证，请给我一份简要需求清单。”

技巧：把“读者画像 + 阅读后应会什么”一次性告诉模型，可显著提升后续输出的精准度。

2️⃣ 生成并迭代大纲

  1. 让 Claude Code 先给出 3～5 种不同结构的大纲。

  2. 选一个你喜欢的版本，再让它展开到二级、三级标题。

    1

    请保留标题层级，列出每节要点（每点 1 行），并提示需要的示例代码或图示。

  3. 亲手微调顺序、合并重复部分，再贴回去让 Claude Code “对比前后差异，输出精炼后的最终大纲”。

3️⃣ 草拟正文 & 示例代码

  • 分段推进：一次只投喂 1 节标题，让模型输出 ≤300 字文字 + 对应代码片段。

    “按照最终大纲的 第 2.1 节，写一段 250 字的介绍，并生成一个最小可运行的 Python 示例（含注释）。”

  • 自动验码：在 Code 模式里直接执行示例，若报错，把 traceback 和你的预期反馈给模型，让它修正。

  • 交叉追问：

    • “这段话里面有哪些概念需要链接到官方文档？请给出 URL 列表。”
    • “帮我把示例改成 JavaScript 版本，并标注与 Python 版的区别。”

4️⃣ 质量把关循环

维度提示词
技术准确性“请充当审核员，指出上文可能误导读者的地方并给出改进方案。”
读者体验“从阅读流畅度和信息量平衡角度，给本节打分并解释原因。”
SEO / 可搜索性“基于关键字 event sourcing implementation，检查标题与小节是否覆盖这些搜索词。”
1

→ 接受／拒绝修改 → 重新生成 → 再审

5️⃣ 统一风格与排版

  • 段落长度：

    1

    把全篇控制在每段 3–5 句，避免超过 120 字。

  • 术语一致：

    1

    把 “事件回放” 一律改成 “Event Replay”，并保持英文斜体。

  • 代码高亮：让模型直接输出带语言标识的 Markdown 块：

    1
2

    ```python
# code here

  • 可视化（选）：

    1

    用 Mermaid 画出 Event Store 与 Read Model 的交互时序图。

6️⃣ 最终审校 & 发布前清单

  1. 通读全文，确保逻辑流畅、示例能跑、链接有效。
  2. 跑一次拼写/语法检查（可让 Claude Code 批量校对）。
  3. 版权合规：确认引用、图片、代码 license。
  4. 版式预览：在目标发布平台（博客、公众号、Dev.to 等）粘贴草稿，看渲染是否正常。

快速提示卡（可收藏）

1
2
3
4
5

🔹 大纲起草：「请给出三种不同角度的大纲，并说明各适用读者」
🔹 深挖小节：「用类比解释 XXX，控制在 150 字以内」
🔹 代码校正：「下面的报错说明了什么？请修复并解释修改点」
🔹 可视化：「用 Mermaid 绘制流程，显示 X→Y→Z 三步」
🔹 审稿人模式：「作为技术编辑，点评上一段的准确性和可读性」