writing-fragments について
writing-fragmentsは、構成を決めずに執筆素材を探るスキルで、まだアイデアを集めている作者向けです。インタビューで素材となる断片を集め、アウトライン化せずに単一のMarkdownファイルへ順番に追記します。
主な機能
- 01インタビューで素材を探索
- 02最初のプロンプトから断片を記録
- 03単一ファイルへ順番に追記
- 04水平線で断片を区切る
- 05作者によるファイル編集を保持
活用シーン
- 01記事用の断片的なアイデア収集
- 02繰り返し現れるテーマや比喩の探索
- 03アウトライン作成前の素材記録
- 04継続インタビューでの断片追加
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ vinvcn/ mattpocock-skills-zh-cn --skill writing-fragmentsインストール後、Claude Code で/writing-fragmentsを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
これは純粋な explore です。構成を一切約束せず、書ける内容の幅を広げます。構成を決めるのは exploit であり、別のスキルの役割です。fragments を生み出すインタビューセッションを行い、ユーザーが書きたいテーマについて継続的に聞きます。ここで phases、outlines、記事構成を押しつけるのは範囲外です。
会話の双方から fragments が生まれたら、それらを単一の markdown ファイルに追加します。
ユーザーがパスを指定していない場合は、文書の保存先を一度だけ尋ね、セッションの残りの間はその場所を覚えておきます。
ユーザーの最初の発言から fragments を記録します。initial prompt も含めます。
初回の書き込みでは、先頭に作業タイトルを付けた H1 を1つだけ置きます(後から変更できます)。それ以外は何も置きません。metadata、TOC、日付は追加しないでください。
fragment とは
Fragment とは、最終的な記事に使える可能性のあるテキストの断片です。_作者が読んで理解できる_必要があります。つまり、作者自身がその意味を把握できる必要があります。ただし、用語を定義したり、初見の読者がすぐに理解できるようにしたりする必要はありません。基準となるのは「これは良い執筆素材か?」であり、「これは自己完結した論証か?」ではありません。
Fragments は意図的に多様な形を取ります。fragment になり得る例を挙げます。
- 使う場所はまだ決まっていないけれど、どこかで使いたい sharp sentence。
- 主張と、それを正当化する一文。
- vignette:実際に起きたこと、code snippet、scenario、analogy。
- 半分だけ形になった考え:「X は Y のように感じる、という話。あとで掘り下げる」。
- 引用、会話、耳にした一言。
- 感覚的にひとまとまりだと思える観察の集まり。
- 不満、告白、または punchline。
- leading word——コンパクトな比喩や新語で、記事全体を支えるもの(tracer bullets や fog of war がパターン全体に名前を付けているように、そのアイデアに名前を付ける用語)。
これらの中でも、leading word は形にする価値が最も高い fragment です。記事を支える重要な要素です。explore の段階で適切な名前を付ければ、その後の構成、transitions、タイトルが形作られ、exploit の段階を通じて成果をもたらし続けます。会話の中で繰り返し登場するアイデアがあれば、それに名前を付ける言葉を作るよう促してください。
モデルとなるのは小説家の日記です。何年にもわたって蓄積した、構成のない気づきが、後に掘り起こされて素材になります。Fragments とは、そうした気づきです。
ファイル形式
# 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 は水平線(\n---\n)で区切ります。本文に headings を入れないでください。tags も付けません。追加した順番以外で並べ替えないでください。
執筆のリズム
静かに追加します。fragment ごとに許可を求めないでください。何を追加したかをさりげなく伝えるのは構いません(「追加しました」など)が、保存ダイアログで会話を中断しないでください。
書き込む前には、毎回ファイルをディスクから読み直します。ユーザーはターンの合間に fragments を編集、並べ替え、削除している可能性があります。ユーザーによる変更を保持してください。ファイルを上書きしてはいけません。追加のみを行ってください(ユーザーから指示された場合は、特定の fragment をその場で編集できます)。
ユーザーはいつでも「最後のものを削って」「もっと切れ味よく書き直して」「この2つをまとめて」と指示できます。それらを重要な指示として扱ってください。