writing-fragments について
writing-fragments は、インタビュー形式の対話を通じて記事に使える可能性のある断片を集め、一つの Markdown ファイルに追記していくライティング向けエージェントスキルです。構成を決める前に素材を蓄えたい著者に向いています。
主な機能
- 01インタビュー形式の対話で文章の断片を収集
- 02断片を水平線で区切って同一ファイルに追記
- 03繰り返し現れる考えに用語を与えることを促す
- 04構成や アウトライン の作成は行わない
活用シーン
- 01執筆前に散らばったアイデアや一文を蓄積
- 02対話の中で出た比喩や観察を記録
- 03後の構造化された執筆段階に向けた素材の準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mattpocock/ skills --skill writing-fragmentsインストール後、Claude Code で/writing-fragmentsを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
これは純粋な探索です。構成を決めずに、書ける可能性の幅を広げます。構成を決めるのは 活用 であり、別のスキルの役割です。ユーザーが書きたいことについて、容赦なく質問を重ねるインタビュー形式のセッションを行い、断片を生み出してください。段階やアウトライン、記事の構成を押しつけることは、ここでは対象外です。
会話のどちらかから断片が生まれたら、単一の Markdown ファイルに追加してください。
ユーザーが保存先のパスを指定していない場合は、文書の保存先を一度だけ尋ね、その後のセッションではそのパスを覚えておいてください。
最初の発言から、最初のプロンプトも含めて断片を記録してください。
最初に書き込むときは、先頭に仮のタイトルを H1 でひとつだけ記載し、それ以外は何も書かないでください。メタデータ、目次、日付は含めません。
断片とは
断片とは、最終的な記事に残る可能性のあるテキストの一片です。_作者が読んで意味を理解できる_必要がありますが、用語の定義や、初見の読者にも理解できることは必要ありません。基準は「自己完結した議論か」ではなく、「よい文章の一片か」です。
断片の形式は意図的に多様です。断片になり得るものの例を挙げます。
- どこかで使いたい、鋭い一文。使いどころはまだわかりません。
- 一行の根拠が添えられた主張。
- ある出来事、コードスニペット、シナリオ、たとえ話などの小話。
- 「X が Y のように感じられることについて、何か。あとで掘り下げる」のような、考えの途中。
- 引用、会話の一部、たまたま耳にした一言。
- 感覚的なつながりがある、一連の観察事項。
- 不満、告白、オチ。
- 先導語:作品全体を支え得る、コンパクトな比喩や造語(_曳光弾_や_戦場の霧_のように、パターン全体を名づける一語)。
これらの中でも、先導語は最も価値のある断片です。作品を支える重要な要素です。探索の段階で適切な言葉を見つければ、その後の活用の段階を通じて、構成やつなぎ、タイトルを形づくり、大きな効果をもたらします。会話で繰り返し現れる考えがあれば、それを表す言葉を作るよう促してください。
モデルとなるのは、作家の日記です。何年にもわたって構造化せずに書き留めた気づきが、後に素材として掘り起こされます。断片とは、気づきの記録です。
ファイル形式
# 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
断片は水平線(\n---\n)で区切ります。本文中に見出しを付けないでください。タグも付けません。追加した順序以外の並べ替えもしません。
執筆のリズム
黙って追記してください。断片ごとに許可を求めないでください。「追加しておきます」のように、追加したことにはさりげなく触れますが、保存ダイアログで会話を中断しないでください。
書き込む前には必ず、ディスク上のファイルを読み直してください。ユーザーがターンの間に編集、並べ替え、削除している可能性があるため、その変更を保ってください。ファイルを上書きせず、追記のみ行ってください(ユーザーから指示があった場合は、特定の断片をその場で編集できます)。
ユーザーはいつでも「最後の断片を削除して」「もっと鋭く書き直して」「その二つをまとめて」と指示できます。これらを最優先の指示として扱ってください。