Skill Learning

writing-fragments

1. Bilingual SKILL.md

左右滑动可直接切换英文版与中文版;两种语言按段落自动对齐。英文中的蓝色虚线词语可点击查看解释。共标记 15 处。

入口 skill:writing-fragments左右滑动切换语言 · 段落位置自动对齐
<what-to-do>
This is pure **explore**: of what could be written without . Committing is _exploit_, a separate skill's job. Run a grilling session that produces fragments, about whatever they want to write about. Imposing phases, outlines, or article structure is out of scope here.
As fragments emerge , append them to a single markdown file.
If the user did not pass a path, ask once where to save the document, then remember it for the rest of the session.
Capture fragments , including the initial prompt.
On first write, put a single H1 at the top with (it can change later) and nothing else: no metadata, no TOC, no date.
</what-to-do>
<supporting-info>
## What is a fragment
A fragment is any piece of text that might . It must be _readable by the author_ (the author can tell what it means), but it does not need to define its terms or be . The bar is "is this a piece of good writing?", not "is this a self-contained argument?"
Fragments are deliberately heterogeneous. Examples of what could be a fragment:
- A sharp sentence you'd want to deploy somewhere but don't yet know where. - A claim with a one-line justification. - A vignette: a thing that happened, a code snippet, a scenario, an analogy. - A half-thought: "something about how X feels like Y, work this out later." - A quote, a piece of dialogue, an overheard line. - A list of related observations that . - A complaint, a confession, a punchline. - A **leading word**: a compact metaphor or coinage (one term that names the idea, the way _tracer bullets_ or _fog of war_ names a whole pattern).
Of these, the leading word is the most valuable fragment to land. It is : name the right one in explore and it shapes the structure, the transitions, and the title later, through the entire exploit phase. When the conversation circles a recurring idea, push to coin a word for it.
The novelist's diary is the model: years of unstructured noticings that later get mined for raw material. Fragments are 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 - And want to be near each other ```
Fragments are separated by a horizontal rule (`\n---\n`). No headings inside the body. No tags. No order beyond the order they were added.
## Writing rhythm
. Don't ask permission for each fragment. Mention what you added in passing ("adding that"), but don't interrupt the conversation with save dialogs.
Before every write: re-read the file from disk. The user may have edited, reordered, or deleted fragments between turns, so preserve their changes. Never overwrite the file; only append (or, if the user asks, edit a specific fragment in place).
The user can say "cut the last one", "rewrite that one sharper", "merge those two" at any time. Treat those as .
</supporting-info>
<what-to-do>
这是纯粹的 **explore(探索)**:扩大可能写下的内容空间,但不承诺任何结构。做出承诺属于 _exploit(收敛利用)_,那是另一个 skill 的职责。进行一次 grilling(追问)会话,围绕用户想写的任何主题不断深入访谈,产出片段。在这里强加阶段、提纲或文章结构都超出范围。
当片段从对话任一方浮现时,把它们追加到同一个 Markdown 文件中。
如果用户没有传入路径,只询问一次文档保存位置,然后在本次会话余下时间记住它。
从用户说出的第一件事开始捕捉片段,包括最初的提示词。
第一次写入时,只在顶部放一个带暂定标题的 H1(以后可以修改),除此之外什么都不要加:没有元数据、没有目录、没有日期。
</what-to-do>
<supporting-info>
## 什么是片段
片段是任何可能保留到最终文章中的一段文字。它必须是 _作者可读的_(作者能判断它是什么意思),但不必定义其中的术语,也不必让毫无背景的读者理解。判断标准是“这是一段好文字吗?”,而不是“这是一个自成一体的论证吗?”
片段本来就会刻意保持异质。以下内容都可以成为片段:
- 一句你想在某处用上的犀利话,只是暂时还不知道放在哪里。 - 一项主张,加上一行理由。 - 一则小场景:发生过的事情、一段代码、一个情境或一个类比。 - 一个未完成的念头:“大概是 X 给人的感觉像 Y,以后再想透。” - 一句引语、一段对话或一句偶然听见的话。 - 一组凭感觉彼此关联的观察。 - 一句抱怨、一段坦白或一个包袱。 - 一个 **leading word(领衔词)**:一种紧凑的隐喻或新造词,整篇文章都可以挂在它上面(用一个术语为某种想法命名,就像 _tracer bullets_ 或 _fog of war_ 为整套模式命名)。
在这些类型中,找到一个领衔词是最有价值的片段。它具有承重作用:在探索阶段叫准这个词,之后它会塑造结构、过渡和标题,并在整个收敛阶段持续带来回报。当对话围绕一个反复出现的想法打转时,要推动双方为它创造一个词。
小说家的日记就是这种模式:多年积累、毫无结构的所见所感,后来再从中开采原材料。片段就是这些所见所感。
## 文件格式
```markdown # 暂定标题 第一个片段写在这里。 它可以有多个段落,也可以包含列表、代码和引语:采用这个片段 自然需要的任何形状。 --- 第二个片段。 --- > 用户想保留下来的一句引语。 对这句话的反应。 --- - 一组相互关联的观察 - 它们凭感觉聚在一起 - 并且希望彼此相邻 ```
片段之间用水平分隔线(` --- `)隔开。正文内部没有标题,没有标签,也没有除添加顺序之外的其他排序。
## 写入节奏
静默追加。不要为每个片段都请求许可。可以顺带提一句你添加了什么(“把这个加进去”),但不要用保存对话框打断交流。
每次写入前:从磁盘重新读取文件。用户可能在不同轮次之间编辑、重排或删除片段,所以必须保留他们的改动。绝不要覆盖文件;只能追加(或者在用户要求时,就地编辑某个明确指定的片段)。
用户随时可以说“删掉最后一个”“把那个改写得更犀利”“合并那两个”。把这些当作一等指令处理。
</supporting-info>

Entry SHA-256: 298b0edd23df229183630de592ed8aa4289233560f2040691f6eb77caeaad4ea

2. Why This Skill Is Clever

一句话核心机制

把写作探索阶段变成一条持续采矿的对话管线:从第一句话起识别异质片段,静默追加到一个极简文件,同时明确拒绝提前施加结构。

触发与边界

信息架构 / 执行顺序

  1. 用户显式启动探索,并提供主题;若没有保存路径,只问一次并记住。
  2. 从初始提示词开始,把对话中的可用表达视为候选片段,而不是等待所谓“正式素材”。
  3. 通过持续追问让句子、主张、小场景、半成品想法、引语、观察簇、包袱和领衔词浮现。
  4. 每个片段出现时,先从磁盘重读文件,吸收用户在轮次间的编辑。
  5. 首次写入只创建一个暂定 H1;之后用水平线分隔并只追加新片段,不增加标签、目录或正文标题。
  6. 写入动作保持低摩擦:无需逐条征求许可,只顺带说明“加进去了”。
  7. 用户可随时删除、改写或合并特定片段;这些修改与新增片段同属核心流程。
  8. 整个阶段不构造提纲;片段库留待独立的 exploit skill 再进行结构化。

最巧妙的设计点

1. 用 explore / exploit 边界保护真正的发散

“widen the space of what could be written without committing to structure”

Direct source: 它没有笼统地说“头脑风暴”,而是把探索定义为扩大可能空间,把结构承诺交给另一个 skill。这个边界防止 agent 一看到好点子就自动总结成提纲,从而过早丢弃旁支素材。

2. 把初始提示也当作素材,而非一次性控制信息

“Capture fragments from the very first thing the user says”

Direct source: 初始提示通常包含最未经修饰、最有作者声音的表达。要求从第一句话开始捕捉,避免等到追问阶段才记录而漏掉开场中的标题、主张或隐喻。

3. 用异质片段降低入库门槛,但保留质量门槛

“readable by the author”

Direct source: 片段不必对冷读者自足,也不必成为完整论证;它只需让作者知道其意义,并通过“这是一段好文字吗”这一标准。这样既容纳半成品和不同形状,又不把任意噪声都当成果。

4. 领衔词是探索阶段的高杠杆产物

“a compact metaphor or coinage the whole piece can hang on”

Direct source: 一个准确的新词或隐喻不仅是漂亮表达,还会在后续阶段塑造结构、过渡和标题。skill 特别要求在对话反复环绕某个想法时推动命名,使素材采集能产出未来的组织轴心,而不必现在就组织文章。

5. 极简文件格式避免偷偷引入分类法

“No tags. No order beyond the order they were added.”

Direct source: 一个 H1、水平线和原样片段就是全部格式。没有标签、日期、目录和正文标题,意味着存储层不会逼作者在探索期回答“它属于哪一章”,也不会让暂时分类固化为文章结构。

6. 磁盘重读与只追加共同保护协作事实

“Before every write: re-read the file from disk.”

Direct source: 每次写入前重读,承认用户可能在工具外编辑、重排或删除;默认只追加则降低覆盖风险。两条规则组合后,磁盘文件成为权威状态,而非 agent 的会话记忆。

防失败机制与 trade-off

可迁移原则

  1. 把探索与收敛拆成不同 skill,并为探索阶段写下明确的“禁止结构化”边界。
  2. 从交互第一刻就识别可复用成果,不要把初始输入仅当控制指令。
  3. 为中间产物定义足够宽的形状集合,同时保留一个清晰、低成本的质量门槛。
  4. 使用最小化存储格式,避免元数据和分类在证据不足时偷偷变成决策。
  5. 在人和 agent 都能编辑同一文件时,写前重读、默认追加,并把定点修改设计成一等操作。

今日实践题

假设用户开场说:“我总觉得 AI 写作像把刚捞上来的鱼立刻做成罐头。”你会把其中哪一部分保存为片段,又会如何追问以寻找一个能让整篇文章挂住的领衔词,同时不提前提出文章结构?

Evidence note

双语原文、explore / exploit 边界、片段类型、领衔词、极简文件格式、静默追加、写前重读和定点编辑规则均来自选中的 writing-fragments/SKILL.md。skills/in-progress/README.md 只作为 Supporting context,用于确认 Beta、未随插件发布和可能变化的状态。对信息损失、存储分类法、协作事实及可移植性的分析属于 Interpretation。

Source & provenance
Repository path
skills/in-progress/writing-fragments/SKILL.md
Generated
2026-08-28 18:05 Asia/Shanghai
Upstream commit
6654f6b60cd9d5be8b54c6fafe44346dabeb3b76
Source
View on GitHub