mcpField
W
writing-fragments

writing-fragments

github.com/utarnクリエイティブ・メディア4959 回インストール8 週間前に更新
リポジトリ

writing-fragments について

writing-fragmentsは、構成を決める前にアイデアを広げたい執筆者向けのスキルです。対話で断片を集めて1つのMarkdownファイルに追記し、書き込む前にファイルを読み直してユーザーの編集を保ちます。

主な機能

  1. 01質問を通じたアイデア探索
  2. 02最初のプロンプトから断片を記録
  3. 03Markdownファイルへの追記
  4. 04仮タイトルと区切り線の使用
  5. 05書き込み前のファイル再読込

活用シーン

  1. 01記事の初期アイデアの収集
  2. 02アウトライン前の気づきの記録
  3. 03保存した断片の編集や削除

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/utarn/engineer-skills --skill writing-fragments

インストール後、Claude Code で/writing-fragmentsを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

これは純粋な探索です。構成を決めずに、書ける内容の幅を広げます。構成を決めるのは_活用_であり、別のスキルの役割です。ユーザーが何について書きたいかを執拗に尋ねる、掘り下げる対話を行い、断片を生み出してください。段階やアウトライン、記事の構成を押しつけることは、この範囲外です。

会話のどちらかから断片が出てきたら、すべて単一の Markdown ファイルに追記してください。

ユーザーがパスを指定しなかった場合は、文書の保存先を一度だけ尋ね、その後のセッション中はそのパスを記憶してください。

最初の発言から断片を取り込みます。最初のプロンプトも対象です。

最初に書き込む際は、先頭に仮のタイトルを H1 でひとつだけ置き、それ以外は何も書かないでください。メタデータ、目次、日付は不要です。

断片とは

断片とは、最終的な記事に残る可能性のあるテキストの一部です。_作者が読んで理解できる_必要があります。つまり、作者が意味を把握できればよく、用語の定義や、初めて読む人にも理解できる内容である必要はありません。基準は「よい文章の一部か」であり、「それだけで完結した論旨になっているか」ではありません。

断片には、意図的にさまざまな種類があります。たとえば、次のようなものが断片になります。

  • どこに使うかはまだわからないものの、使いたいと思うような鋭い一文。
  • 一行の根拠を添えた主張。
  • ある出来事、コードスニペット、状況、たとえなどを描いた小話。
  • 「X が Y のように感じられることについて。あとで掘り下げる」といった、考えかけの言葉。
  • 引用、会話の一部、耳にしたひと言。
  • 感覚的なつながりでまとまった、関連する所見のリスト。
  • 不満、告白、オチ。
  • 先導語 — 作品全体を支える、簡潔な比喩や造語。tracer bullets や fog of war がパターン全体を名づけるように、アイデアを表すひとつの言葉です。

この中でも、先導語は最も価値のある断片です。構造を支えるものです。探索の段階で適切な言葉を見つければ、後の活用の段階で構成やつなぎ、タイトルを形づくり、作品全体にわたって効果を発揮します。会話の中で繰り返し現れるアイデアがあれば、それを表す言葉を生み出せるよう促してください。

モデルとなるのは、小説家の日記です。長年にわたる、構成のない気づきの記録から、後になって素材を掘り起こします。断片とは、気づきの記録です。

ファイル形式

# 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)で区切ります。本文中に見出しは入れません。タグも付けません。追加した順番以外の順序はありません。

執筆のリズム

黙って追記してください。断片を追加するたびに許可を求めてはいけません。「それも追加します」のように、何を追加したかをさりげなく伝えますが、保存ダイアログで会話を中断しないでください。

書き込む前には毎回、ディスクからファイルを読み直してください。ユーザーがターンの合間に断片を編集、並べ替え、削除している可能性があります。変更を維持してください。ファイルを上書きしてはいけません。追記のみとします。ただし、ユーザーから指示があれば、特定の断片をその場で編集できます。

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

コメント