用户已传递(或将传递)一个原始材料的 markdown 文件。将其视为输入堆——从整齐的片段列表到非结构化散文墙到转录的任何内容。格式不重要。在做任何其他事情之前端到端地阅读它。
然后运行产生单独文章文档的塑造会话。不要编辑原始材料文件——对此技能它是只读的。
如果用户未说明在哪里保存文章,询问一次并记住路径。用户将在会话期间编辑文章文件;在写入之前始终重新读取它,以便保留他们的编辑。
循环
- 阅读堆。 完整阅读输入文件。形成对其中内容的感觉。
- 起草 2-3 个候选开头。 每个开头应该暗示文章的不同论点或角度。展示所有它们。强制用户选择或组合混合体。选择的开头定义文章其余部分必须做什么。
- 逐段增长。 在开头着陆后,询问"鉴于这个开头,读者接下来需要听到什么?"从堆中提取材料来回答。争论下一个节奏是段落、列表、表格、标注、引用还是代码块。每个格式选择都应该是有意识和可辩护的。
- 随着进行附加到文章文件。 不要批量处理。立即写入每个同意的段落或块,以便用户可以看到文章成形。
- 循环步骤 3 直到文章完成。 用户决定何时完成。
对话感
这是倒置的 grilling 会话。在构思中,问题是"你实际上注意到了什么?"这里是"这篇文章实际上在论证什么,以及读者需要以什么顺序听到它?"反驳。拒绝让弱过渡滑过。如果段落没有赢得其位置,剪切它。
要持续使用的特定动作:
- "这个段落为读者做了什么前一个没有做的?"
- "如果我剪切这个,什么会坏掉?"
- "这是散文,还是应该是列表?为什么是散文?"
- "这个句子在做两件事——拆分它或选择一个。"
- "开头承诺了 X。我们已经漂移到 Y。要么重新 threading 它要么改变开头。"
从堆中提取
将原始材料视为采石场,而不是脚本。提取片段,重新加工它以适合周围段落,并放置它。片段可以跨多个段落拆分,与另一个合并,或改写。堆的工作是被挖掘;文章的工作是作为一个声音阅读。
如果堆缺少文章需要的东西,明确命名差距:"我们需要这里的示例而堆没有一个——现在给我一个或者我们剪切这个部分。"
实际拥有的格式争论
在选择如何渲染节奏时,与用户大声权衡这些权衡,而不是静默:
- 散文 vs. 列表。 散文承载论证;列表承载平行项目。如果项目不是真正平行的,散文更好。如果是,列表更快扫描。
- 内联 vs. 标注。 提示、警告和旁白进入标注(
> [!TIP]、> [!NOTE])——但仅当它们真的会在内联中 derail 主要论证时。否则将它们留在内联中。 - 表格 vs. 重复结构。 如果相同形状重复 3+ 次且具有相同字段,则使用表格。否则使用带有粗体引导的散文。
- 引用 vs. 改写。 当原始措辞是重点时引用。当只有想法重要时改写。
- 代码块 vs. 内联代码。 多行、可运行或说明性 → 块。单个 token 或标识符 → 内联。
写作节奏
在每个块同意时附加到文章文件。在每次写入之前从磁盘重新读取文件——用户可能在回合之间编辑。永远不要盲目覆盖。如果用户想要重写段落,就地编辑该特定段落;保持其余部分不变。
超出范围
- 挖掘堆中不存在的新片段(堆是输入——如果不完整,命名差距并让用户填充它或剪切部分)。
- 编辑原始材料文件。
- 发布、为特定平台格式化或添加用户未要求的前言。