mcpField
W
writing-fragments

writing-fragments

github.com/vinvcn创意与媒体5.4k3.6k 次安装1 天前更新
代码仓库

关于 writing-fragments

writing-fragments 是一种无结构探索写作素材的技能,适用于尚未确定文章结构的作者。它通过访谈收集可用于写作的片段,并按出现顺序追加到单一 Markdown 文件,不整理成大纲。

主要功能

  1. 01以访谈探索写作素材
  2. 02从首句起捕捉片段
  3. 03按顺序追加到单一文件
  4. 04用分隔线区分片段
  5. 05保留作者对文件的修改

适用场景

  1. 01为文章收集零散想法
  2. 02探索反复出现的主题与隐喻
  3. 03在确定大纲前记录素材
  4. 04持续追加访谈产生的片段

安装

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

$npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill writing-fragments

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

附带文件agents/openai.yaml

详细介绍

来自项目 README

这是纯粹的 explore:在不承诺任何结构的前提下,拓宽可写内容的空间——承诺结构是 exploit,是另一个 skill 的工作。运行一个产出 fragments 的 grilling session,围绕用户想写的任何主题持续访谈。在这里强加 phases、outlines 或文章结构都不在范围内。

当对话双方产生 fragments 时,把它们追加到单一 markdown 文件。

如果用户没有传入路径,只询问一次文档保存到哪里,然后在 session 剩余部分记住它。

从用户说的第一句话开始捕获 fragments,包括 initial prompt。

第一次写入时,在顶部放一个带 working title 的单一 H1(之后可以改),除此之外什么都不要放:不要 metadata、TOC 或 date。

What is a fragment

Fragment 是任何可能进入最终文章的文本片段。它必须_对作者可读_,也就是作者能知道它是什么意思;但它不需要定义术语,也不需要让冷读者立即理解。标准是 “这是不是一段好写作素材?”,不是 “这是不是自洽论证?”

Fragments 刻意保持异质。可能成为 fragment 的例子:

  • 一句 sharp sentence,你想在某处使用但还不知道放哪里。
  • 一个 claim 和一句 justification。
  • 一个 vignette:发生过的事、code snippet、scenario、analogy。
  • 一个 half-thought:"something about how X feels like Y, work this out later."
  • 一句 quote、一段 dialogue、一句 overheard line。
  • 一组凭感觉属于同一簇的 observations。
  • 一个 complaint、confession 或 punchline。
  • 一个 leading word——一个紧凑的隐喻或新造词,整篇文章都可以挂在它上面(一个为这个 idea 命名的术语,就像 tracer bullets 或 fog of war 为整个模式命名那样)。

在这些当中,leading word 是最值得落地的 fragment。它是 load-bearing 的:在 explore 阶段命名对的那一个,就会塑造之后的结构、transitions 和标题——在整个 exploit 阶段持续产生回报。当对话围绕一个反复出现的 idea 打转时,推动为它造一个词。

Novelist's diary 是模型:多年无结构的 noticings,之后被挖掘成 raw material。Fragments 就是 noticings。

File format

# 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

Fragments 用 horizontal rule(\n---\n)分隔。正文内不要 headings。不要 tags。除了加入顺序之外,不做排序。

Writing rhythm

安静追加。不要为每个 fragment 请求许可。可以顺带说你添加了什么("adding that"),但不要用 save dialogs 打断对话。

每次写入前:从磁盘重新读取文件。用户可能在回合之间编辑、重排或删除 fragments;保留他们的变化。永远不要 overwrite 文件;只 append(或者在用户要求时,就地编辑特定 fragment)。

用户随时可以说 "cut the last one"、"rewrite that one sharper"、"merge those two"。把它们当成一等指令。

评论

支持 Markdown