writing-shape

name	writing-shape
description	写作的 exploit 阶段——将原始材料逐段塑造成一篇文章。
disable-model-invocation	true

用户已经传入（或将要传入）一份包含原始材料的 Markdown 文件。把它视为 input pile：它可以是整理好的 fragments 列表，也可以是一整面无结构文字或一份 transcript，格式没有要求。执行其他工作前，先从头到尾完整阅读。

随后运行 shaping session，生成一份独立的文章文档。当前处于 exploit：探索已经结束，材料堆已固定。确定文章结构，并从材料堆中开采内容进行填充。不要编辑原始材料文件；对本 skill 来说，它是 read-only。

用户没有说明文章保存位置时，只询问一次，并记住该路径。

循环

1. 阅读材料堆。 完整阅读输入文件，形成对其中内容的整体认识。
2. 确定 prerequisites。 与用户确认读者进入文章时已经掌握什么，也就是从开头便处于 grounded 状态的 concepts。其他 concept 必须先由某个 block 完成 grounding，后续 block 才能依赖它。参见 Grounding。
3. 起草 2–3 个候选 openings。 每个 opening 应暗示一种不同的 thesis 或文章角度。全部展示给用户，要求用户选择一个或组合成 hybrid。选定的 opening 决定整篇文章接下来必须完成什么。
4. 逐段生长。 Opening 确定后，询问：“在这个 opening 之后，读者下一步需要听到什么？”从材料堆中取出内容回答。下一个 block 只能依赖已经 grounded 的 concepts，并在落定时 ground 新 concepts。与用户讨论下一个 block 应采用的形式：paragraph、list、table、callout、quote 或 code block。每次格式选择都必须出于明确理由，并且能够解释。
5. 随写随存。 不要批量处理。每个达成一致的 paragraph 或 block 都应立即写入文章文件，让用户看见文章逐步形成。
6. 循环步骤 4，直到文章完成。 由用户决定何时完成。

Grounding

每个 concept 都必须先完成 grounding，block 才能依赖它：读者可能在进入文章前就已经了解，也可能在更早的 block 中首次接触。Block 如果直接使用尚未 grounded 的 concept，就会让读者失去方向。判断单位是 concept，而非表示它的词；即使没有出现 jargon，block 仍可能依赖读者尚未掌握的想法。Concept 有名称，也就是一个 term 时，grounding 需要同时落定该想法和术语。

Concept 有两种 grounding 方式：

• Prerequisite——opening 前已经 grounded。读者自带这项知识，并在开始时固定下来。
• Introduced——某个 block 建立该 concept；从此以后，它在文章剩余部分都处于 grounded 状态。

持续维护当前已经 grounded 的清单。当你询问“读者下一步需要听到什么？”时，如果下一个动作需要某个未 grounded 的 concept，那么这个缺失的基础本身就是答案：先在当前位置或更早的 block 中 ground 它，否则无法继续。这与从材料堆中开采所说的 gap naming 处于不同层级：那里缺少的是材料，这里缺少的是文章基础。

关键取舍在于：哪些 concepts 设为 prerequisite，哪些在文章内部 ground。开头要求太多，会把读者挡在门外；文章内部 ground 太多，opening 会淹没在定义中。确定 prerequisites 时与用户共同决定。

对话感

这是一次方向反转的 grilling session。在 ideation 阶段，问题是“你真正观察到了什么？”；此处的问题是“这篇文章真正要论证什么，读者需要按什么顺序听到？”提出反对意见，不要放过薄弱转场。某个 paragraph 没有为文章提供价值时，删掉它。

持续使用这些具体问题：

• “这一段为读者提供了上一段没有提供的什么？”
• “删掉这一段后，哪里会断？”
• “这里应该写 prose，还是应该列成 list？为什么选择 prose？”
• “这句话同时做了两件事——拆开，或只保留一件。”
• “Opening 承诺了 X，现在内容漂到了 Y。重新把线索接回去，或修改 opening。”

从材料堆中开采

把原始材料当作 quarry，不要把它当作 script。取出一个 fragment，重写到适合周围 paragraph 的形状，再放入文章。一个 fragment 可以拆进多个 paragraphs，也可以与其他 fragment 合并或被改写。材料堆负责提供矿石，文章需要呈现为同一个声音。

材料堆缺少文章所需内容时，明确指出 gap：“这里需要一个例子，但材料堆里没有——现在给我一个，否则删掉这一节。”

需要真正讨论的格式选择

决定 block 的呈现方式时，与用户明确讨论以下取舍，不要在内部静默决定：

• Prose 与 list。 Prose 承载论证；list 承载并列项。项目并不真正平行时，prose 更合适；真正平行时，list 更便于快速扫描。
• Inline 与 callout。 Tips、warnings 和 asides 可以放入 callouts（> [!TIP]、> [!NOTE]），但只在它们写进正文会真正打断主论证时使用；否则保持 inline。
• Table 与重复结构。 同一种结构以相同字段重复 3 次以上时使用 table；否则用带粗体引导语的 prose。
• Quote 与 paraphrase。 原始措辞本身重要时引用；只需要其中想法时改写。
• Code block 与 inline code。 多行、可运行或用于示意的内容使用 block；单个 token 或 identifier 使用 inline code。

写作节奏

每个 block 达成一致后，立即追加到文章文件。每次写入前从磁盘重新读取文件；用户可能已经在两轮之间编辑。不得盲目覆盖。用户要求重写某个 paragraph 时，只原地编辑该 paragraph，其他内容保持不动。

范围外内容

• 开采材料堆中不存在的新 fragments（按照“从材料堆中开采”的方式处理 gap）。
• 编辑原始材料文件。
• 发布、针对特定平台进行格式化，或添加用户未要求的 frontmatter。