关于 writing-fragments
writing-fragments 是一个写作类 Agent 技能,通过访谈式对话收集可能用于文章的文字片段,并逐条追加到一个 Markdown 文件中。适合在确定结构之前先积累素材的作者。
主要功能
- 01访谈式对话收集文字片段
- 02片段以水平线分隔追加到同一文件
- 03鼓励为反复出现的想法提炼一个核心术语
- 04不进行结构或大纲规划
适用场景
- 01在动笔前积累零散的想法与句子
- 02记录对话中出现的比喻与观察
- 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)。正文中不设标题,不使用标签。除了添加的先后顺序之外,不做其他排序。
写作节奏
静默追加。不要对每个片段逐一请求许可。可以顺带说明你添加了什么(例如“补充一条”),但不要用保存对话框打断交流。
每次写入之前:从磁盘重新读取文件。用户可能在两轮对话之间编辑、重排或删除过片段,因此要保留他们的改动。永远不要覆盖整个文件,只能追加(或者在用户要求时,原地编辑某个指定片段)。
用户可以随时说“删掉最后一条”“把那条改得更犀利”“合并那两条”。应将这些视为一等指令予以执行。