writing-fragments

SkillDev tools

Adds a writing-focused Claude skill mode where your agent digs up raw, unstructured text fragments instead of forcing outlines.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the writing-fragments skill

About this skill

Writing, explore : 挖掘原始碎片,不施加结构。

What this skill tells your AI

The instructions your AI receives, as published by devcxl/mattpocock-skills-zh in skills/in-progress/writing-fragments/SKILL.md and read by ahel’s review.

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

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

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

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

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

什么是碎片

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

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

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

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

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

文件格式

# 工作标题

第一个碎片放在这里。

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

---

第二个碎片。

---

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

对它的回应。

---

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

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

写作节奏

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

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

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

Signals

GitHub stars
406
Forks
33
Last commit
Sep 2026
Advanced
Item type
skill
Key
writing-fragments-devcxl
Source
github.com/devcxl/mattpocock-skills-zh