mcpField
W
writing-fragments

writing-fragments

github.com/mattpocockクリエイティブ・メディア305.7k494.7k 回インストール1 日前に更新
リポジトリ

writing-fragments について

writing-fragments は、インタビュー形式の対話を通じて記事に使える可能性のある断片を集め、一つの Markdown ファイルに追記していくライティング向けエージェントスキルです。構成を決める前に素材を蓄えたい著者に向いています。

主な機能

  1. 01インタビュー形式の対話で文章の断片を収集
  2. 02断片を水平線で区切って同一ファイルに追記
  3. 03繰り返し現れる考えに用語を与えることを促す
  4. 04構成や アウトライン の作成は行わない

活用シーン

  1. 01執筆前に散らばったアイデアや一文を蓄積
  2. 02対話の中で出た比喩や観察を記録
  3. 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)で区切ります。本文中に見出しを付けないでください。タグも付けません。追加した順序以外の並べ替えもしません。

執筆のリズム

黙って追記してください。断片ごとに許可を求めないでください。「追加しておきます」のように、追加したことにはさりげなく触れますが、保存ダイアログで会話を中断しないでください。

書き込む前には必ず、ディスク上のファイルを読み直してください。ユーザーがターンの間に編集、並べ替え、削除している可能性があるため、その変更を保ってください。ファイルを上書きせず、追記のみ行ってください(ユーザーから指示があった場合は、特定の断片をその場で編集できます)。

ユーザーはいつでも「最後の断片を削除して」「もっと鋭く書き直して」「その二つをまとめて」と指示できます。これらを最優先の指示として扱ってください。

コメント