mcpField
W
writing-fragments

writing-fragments

github.com/tt-a1i创意与媒体19197 次安装今天更新
代码仓库

关于 writing-fragments

writing-fragments 是一项探索式写作技能,通过持续提问拓展可写内容,但不强加提纲或结构。它将逐渐形成的可读片段按顺序追加到同一 Markdown 文件中。

主要功能

  1. 01通过深入对话探索想法
  2. 02从用户的第一条消息开始收集片段
  3. 03将片段保存到单个 Markdown 文档
  4. 04用水平分隔线区分条目
  5. 05按要求修改或删除指定片段

适用场景

  1. 01在拟定提纲前收集观察与想法
  2. 02将反复出现的主题提炼成鲜明术语
  3. 03为后续写作保存零散思路、例子和引语

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tt-a1i/matt-skills-with-to-goal --skill writing-fragments

安装后在 Claude Code 中输入/writing-fragments确认已加载。

附带文件agents/openai.yaml

详细介绍

这是纯粹的 探索(explore):在不确定结构的前提下,尽可能扩大可以写下的内容范围。确定结构属于 利用(exploit),是另一项技能的工作。这里要进行一场深入追问式的访谈,产出若干片段,就用户想写的任何内容不断追问。此处不应强加阶段、提纲或文章结构。

每当对话的任一方产生片段,就把它追加到同一个 markdown 文件中。

如果用户没有提供路径,就询问一次文档应保存在哪里,然后在整个会话期间记住该路径。

从用户说的第一句话开始捕获片段,包括最初的提示词。

第一次写入时,在文件顶部放置一个一级标题(H1),内容为工作标题(之后可以更改),除此之外不加任何内容:不要元数据、目录或日期。

什么是片段

片段是任何可能保留到最终文章中的文本。它必须能被作者读懂(作者能看出它的意思),但不需要解释其中的术语,也不需要让陌生读者看懂。判断标准是“这是不是一段好的写作?”,而不是“这是不是一个自成一体的论证?”

片段有意保持异质性。以下都可以是片段:

  • 一句你想在某处使用、但还不知道用在哪里的犀利句子。
  • 带有一句理由的论断。
  • 一个小片段:发生过的事、代码片段、场景或比喻。
  • 半成形的想法,例如“X 的感觉有点像 Y,之后再细想”。
  • 引语、一段对话、无意间听到的一句话。
  • 一组因为感觉相近而彼此相连的相关观察。
  • 一句抱怨、一次坦白或一个包袱。
  • 引领词(leading word):一个能让整篇文章围绕其展开的紧凑隐喻或新造词(即一个能命名该想法的术语,就像 曳光弹(tracer bullets) 或 战争迷雾(fog of war) 能命名一整套模式)。

在这些片段中,引领词最有价值。它承载着结构的重量:如果在探索阶段就找到了恰当的引领词,它会塑造之后的结构、衔接与标题,并在整个利用阶段持续发挥作用。当对话反复绕回同一个想法时,应努力为它造一个词。

小说家的日记是这一方法的范本:多年来不成体系的随手记录,之后会被挖掘为原始素材。片段就是这样的随手记录。

文件格式

# 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

片段之间以水平线分隔(\n---\n)。正文中不设标题,不使用标签。除了添加的先后顺序之外,不做其他排序。

写作节奏

静默追加。不要对每个片段逐一请求许可。可以顺带说明你添加了什么(例如“补充一条”),但不要用保存对话框打断交流。

每次写入之前:从磁盘重新读取文件。用户可能在两轮对话之间编辑、重排或删除过片段,因此要保留他们的改动。永远不要覆盖整个文件,只能追加(或者在用户要求时,原地编辑某个指定片段)。

用户可以随时说“删掉最后一条”“把那条改得更犀利”“合并那两条”。应将这些视为一等指令予以执行。

评论

支持 Markdown