mcpField
W
writing-fragments

writing-fragments

github.com/mattpocock创意与媒体305.7k494.7k 次安装1 天前更新
代码仓库

关于 writing-fragments

writing-fragments 是一个写作类 Agent 技能,通过访谈式对话收集可能用于文章的文字片段,并逐条追加到一个 Markdown 文件中。适合在确定结构之前先积累素材的作者。

主要功能

  1. 01访谈式对话收集文字片段
  2. 02片段以水平线分隔追加到同一文件
  3. 03鼓励为反复出现的想法提炼一个核心术语
  4. 04不进行结构或大纲规划

适用场景

  1. 01在动笔前积累零散的想法与句子
  2. 02记录对话中出现的比喻与观察
  3. 03为之后的结构化写作阶段准备素材

安装

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

$npx skills add https://github.com/mattpocock/skills --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