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