mcpField
W
writing-fragments

writing-fragments

github.com/utarn创意与媒体4959 次安装8 周前更新
代码仓库

关于 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/utarn/engineer-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)。正文中不加标题,不加标签。除了添加顺序,不作其他排序。

写作节奏

静默追加。不要每添加一个片段都征求许可。顺带提一句添加了什么(“已添加这条”),但不要用保存对话打断交流。

每次写入前,都要从磁盘重新读取文件。用户可能在不同轮次之间编辑、调整顺序或删除片段——要保留他们的修改。永远不要覆盖文件;只能追加(或者在用户要求时,原地编辑某个指定片段)。

用户随时可以说“删掉最后一条”“把那条改得更犀利一些”“合并那两条”。将这些视为优先级同等的指令。

评论

支持 Markdown