mcpField
W
writing-fragments

writing-fragments

github.com/devcxlクリエイティブ・メディア51564 回インストール今日更新
リポジトリ

writing-fragments について

writing-fragmentsは、質問を通じて執筆素材を探り、使える可能性のある断片をMarkdownファイルに出現順で追加するスキルです。構成を決めつけず、ファイルへの作者の編集も保持します。

主な機能

  1. 01質問による執筆素材の探索
  2. 02最初の発言から断片を記録
  3. 03Markdownファイルへの断片の追記
  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)分隔。正文中没有标题。没有标签。没有超出添加顺序以外的排序。

写作节奏

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

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

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

コメント