关于 writing-fragments
这项技能通过开放式访谈探索写作想法,不预设阶段或文章结构。它会在对话过程中,将可用片段记录到一个 Markdown 文件中。
主要功能
- 01不设固定阶段地探索想法
- 02围绕主题访谈作者
- 03从首条提示开始捕捉片段
- 04将片段追加到单个 Markdown 文件
- 05用分隔线区分片段
适用场景
- 01起草前收集观察素材
- 02发展可用的表达、论点或隐喻
- 03在对话中保存写作片段
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ leandrocfe/ skills --skill writing-fragments安装后在 Claude Code 中输入/writing-fragments确认已加载。
附带文件agents/openai.yaml
详细介绍
这纯粹是一次探索:拓宽可以写些什么的空间,但不承诺任何结构——承诺属于_开发_,是另一项技能的工作。开展一场深入追问的访谈,围绕用户想写的内容不断提问,产出一个个片段。设置阶段、拟定大纲或安排文章结构都不在此任务范围内。
无论片段来自对话哪一方,都将其追加到同一个 Markdown 文件中。
如果用户没有提供路径,只询问一次文档要保存到哪里,然后在本次会话中记住该路径。
从用户说的第一句话开始捕捉片段,包括最初的提示词。
首次写入时,在文件顶部放置一个 H1 标题作为暂定标题(之后可以更改),除此之外不添加任何内容——不加元数据、目录或日期。
什么是片段
片段是任何可能保留在最终文章中的文字。它必须_让作者读得懂_——作者能明白它的意思——但不必定义其中的术语,也不必让初次阅读的人看得懂。评判标准是“这是不是一段好文字?”,而不是“这是不是一个自成一体的论证?”
片段有意保持多种多样。以下是一些可能成为片段的例子:
- 一句犀利的话,你想在某处用上,但还不知道放在哪里。
- 一个附有一句理由的主张。
- 一个小场景:发生过的事、一段代码、一种情境或一个类比。
- 一个未成形的想法:“关于 X 感觉像 Y 这件事,之后再想清楚。”
- 一段引文、一段对话或一句无意间听到的话。
- 一组彼此相关、凭感觉连在一起的观察。
- 一句抱怨、一段坦白或一个包袱。
- 一个引领词——一个精炼的隐喻或新造词,整篇文章都可以围绕它展开(一个为某种观念命名的词,就像 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)。正文中不加标题,不加标签。除了添加顺序,不作其他排序。
写作节奏
静默追加。不要每添加一个片段都征求许可。顺带提一句添加了什么(“已添加这条”),但不要用保存对话打断交流。
每次写入前,都要从磁盘重新读取文件。用户可能在不同轮次之间编辑、调整顺序或删除片段——要保留他们的修改。永远不要覆盖文件;只能追加(或者在用户要求时,原地编辑某个指定片段)。
用户随时可以说“删掉最后一条”“把那条改得更犀利一些”“合并那两条”。将这些视为优先级同等的指令。