writing-fragments

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

<what-to-do>

这是纯粹的 **explore**：在不承诺任何结构的前提下，拓宽可写内容的空间——承诺结构是 _exploit_，是另一个 skill 的工作。运行一个产出 fragments 的 grilling session，围绕用户想写的任何主题持续访谈。在这里强加 phases、outlines 或文章结构都不在范围内。

当对话双方产生 fragments 时，把它们追加到单一 markdown 文件。

如果用户没有传入路径，只询问一次文档保存到哪里，然后在 session 剩余部分记住它。

从用户说的第一句话开始捕获 fragments，包括 initial prompt。

第一次写入时，在顶部放一个带 working title 的单一 H1（之后可以改），除此之外什么都不要放：不要 metadata、TOC 或 date。

</what-to-do>

<supporting-info>

## What is a fragment

Fragment 是任何可能进入最终文章的文本片段。它必须_对作者可读_，也就是作者能知道它是什么意思；但它不需要定义术语，也不需要让冷读者立即理解。标准是 “这是不是一段好写作素材？”，不是 “这是不是自洽论证？”

Fragments 刻意保持异质。可能成为 fragment 的例子：

- 一句 sharp sentence，你想在某处使用但还不知道放哪里。
- 一个 claim 和一句 justification。
- 一个 vignette：发生过的事、code snippet、scenario、analogy。
- 一个 half-thought："something about how X feels like Y, work this out later."
- 一句 quote、一段 dialogue、一句 overheard line。
- 一组凭感觉属于同一簇的 observations。
- 一个 complaint、confession 或 punchline。
- 一个 **leading word**——一个紧凑的隐喻或新造词，整篇文章都可以挂在它上面（一个为这个 idea 命名的术语，就像 _tracer bullets_ 或 _fog of war_ 为整个模式命名那样）。

在这些当中，leading word 是最值得落地的 fragment。它是 load-bearing 的：在 explore 阶段命名对的那一个，就会塑造之后的结构、transitions 和标题——在整个 exploit 阶段持续产生回报。当对话围绕一个反复出现的 idea 打转时，推动为它造一个词。

Novelist's diary 是模型：多年无结构的 noticings，之后被挖掘成 raw material。Fragments 就是 noticings。

## File format

```markdown
# Working title

A first fragment lives here.

It can be multiple paragraphs. It can include lists, code, quotes — whatever
shape the fragment naturally takes.

---

A second fragment.

---

> A quoted line that the user wants to keep around.

A reaction to it.

---

- A cluster of related observations
- That hang together by feel
- And want to be near each other
```

Fragments 用 horizontal rule（`\n---\n`）分隔。正文内不要 headings。不要 tags。除了加入顺序之外，不做排序。

## Writing rhythm

安静追加。不要为每个 fragment 请求许可。可以顺带说你添加了什么（"adding that"），但不要用 save dialogs 打断对话。

每次写入前：从磁盘重新读取文件。用户可能在回合之间编辑、重排或删除 fragments；保留他们的变化。永远不要 overwrite 文件；只 append（或者在用户要求时，就地编辑特定 fragment）。

用户随时可以说 "cut the last one"、"rewrite that one sharper"、"merge those two"。把它们当成一等指令。

</supporting-info>

From vinvcn/mattpocock-skills-zh-CN, MIT.

More from vinvcn/mattpocock-skills-zh-CN