mcpField
W
writing-fragments

writing-fragments

github.com/devcxl创意与媒体51564 次安装今天更新
代码仓库

关于 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/devcxl/mattpocock-skills-zh --skill writing-fragments

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

附带文件agents/openai.yaml

详细介绍

来自项目 README

这是纯粹的 explore(探索):拓宽可被写作的空间,不承诺任何结构:承诺结构是 exploit(利用) 的任务,由另一个技能负责。进行一次产生碎片的盘问,就用户想写的任何话题不断追问。强加阶段、大纲或文章结构在此不在范围内。

当对话双方的碎片浮现时,将它们追加到一份 markdown 文件中。

如果用户没有传入保存路径,询问一次文档保存到哪里,然后在整个对话中记住它。

从用户说的第一件事(包括初始 prompt)开始就捕捉碎片。

首次写入时,在顶部放一个 H1 的工作标题(以后可以改),除此之外什么都不放:没有元数据、没有目录、没有日期。

什么是碎片

碎片是任何可能在最终文章中幸存下来的文本片段。它必须对作者具有可读性:作者能理解它的意思:但它不需要定义其术语,也不需要对陌生读者来说可以理解。标准是"这是一段好的写作吗?",而不是"这是一个完整的论证吗?"

碎片刻意保持异质化。哪些可以成为碎片的例子:

  • 一个你想用但还不知道放在哪里的犀利句子。
  • 一个带有一句话论证的主张。
  • 一个小插曲:一件发生过的事、一段代码片段、一个场景、一个类比。
  • 一个半成品想法:"某件事感觉像某件事,以后再展开。"
  • 一句引用、一段对话、一句无意中听到的话。
  • 一组凭感觉聚在一起的观察。
  • 一个抱怨、一个坦白、一个笑点。
  • 一个引导词(leading word):一个紧凑的隐喻或新造词,整个文章可以挂靠其上(用一个词来命名这个想法,就像 tracer bullets(曳光弹) 或 fog of war(战争迷雾) 命名了一个完整模式)。

其中,引导词是最有价值的碎片。它是承重结构:在探索阶段找到恰如其分的词,就能塑造整个文章的结构、过渡和标题:在整个利用阶段持续受益。当对话反复围绕某个想法时,推动为它造一个词。

小说家的日记是这里的模式:多年来无结构的觉察,后来被开采为原始素材。碎片就是觉察。

文件格式

# 工作标题

第一个碎片放在这里。

它可以有多段。可以包含列表、代码、引用:碎片自然是什么形状就
写成什么形状。

---

第二个碎片。

---

> 用户想保留的一句引用。

对它的回应。

---

- 一组相关的观察
- 凭感觉聚在一起
- 想彼此靠近放置

碎片之间用水平分隔线(\n---\n)分隔。正文中没有标题。没有标签。没有超出添加顺序以外的排序。

写作节奏

静默追加。不要为每个碎片请求许可。顺带提一下你添加了什么("加上这个"),但不要用保存弹窗打断对话。

每次写入前:从磁盘重新读取文件。用户可能在两轮对话之间编辑、重新排序或删除了碎片:保留他们的修改。永远不要覆盖文件;只追加(或者,如果用户要求,就地编辑某个特定碎片)。

用户可以随时说"删掉最后一个"、"把那个重写得更有力一点"、"把那两个合并"。将这些视为一等指令来对待。

评论

支持 Markdown