writing-fragments について
インタビュー形式の対話でアイデアを発展させ、使えそうな文章片を1つのMarkdownファイルに集めるスキルです。ユーザーの編集内容を保ち、断片は後で使えるよう構造化せずに保存します。
主な機能
- 01書き手のアイデアを対話で掘り下げ
- 02会話の冒頭から文章片を記録
- 03文章片を単一のMarkdownファイルに追記
- 04書き込み前にファイルを再読込
- 05特定の文章片の編集に対応
活用シーン
- 01記事の素材を収集
- 02執筆中の対話でアイデアを保存
- 03指定した文章片の修正や削除
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ polya20/ grill-me --skill writing-fragmentsインストール後、Claude Code で/writing-fragmentsを入力して読み込まれたか確認します。
詳細
断片を生み出すために、徹底的に掘り下げる対話を行います。ユーザーが書きたいことについて、容赦なく質問を重ねてください。段階やアウトライン、構成を押し付けてはいけません。それらは明確に対象外です。
会話のどちらかから断片が生まれたら、ひとつの Markdown ファイルに追記してください。ユーザーはセッション中にこのファイルを編集します。ユーザーの編集を保つため、書き込む前には必ずファイルを読み直してください。
ユーザーが保存先のパスを指定していない場合は、保存先を一度だけ尋ね、その後はセッション中ずっと覚えておいてください。
最初のプロンプトを含め、ユーザーが最初に話した内容から断片を記録してください。
最初に書き込むときは、冒頭に作業用タイトルの H1 をひとつだけ置き、それ以外は何も書かないでください。メタデータ、目次、日付は不要です。
断片とは
断片とは、最終的な記事に残る可能性のあるテキストの一部です。_書き手が読んで意味を理解できる_必要があります。書き手自身が用語の意味を定義したり、初見の読者にも理解できるようにしたりする必要はありません。基準は「それ自体で完結した論旨か」ではなく、「良い文章の一部か」です。
断片には意図的にさまざまな種類があります。断片になり得るものの例を挙げます。
- どこで使うかはまだわからないが、どこかに使いたいと思う、鋭い一文。
- 1 行の根拠を添えた主張。
- 小話。実際に起きたこと、コードスニペット、シナリオ、たとえ話など。
- 考えかけの内容。「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)で区切ります。本文中に見出しを入れないでください。タグも不要です。追加した順番以外の並べ替えはしません。
執筆のリズム
黙って追記します。断片ごとに許可を求めないでください。「それを追加しますね」などと軽く伝えるにとどめ、保存の確認で会話を中断しないでください。
書き込む前には毎回、ファイルをディスクから読み直してください。ターンの合間にユーザーが断片を編集、並べ替え、削除しているかもしれません。ユーザーの変更を保ってください。ファイルを上書きしてはいけません。追記のみとし、ユーザーから依頼された場合に限り、指定された断片をその場で編集してください。
ユーザーはいつでも「最後の断片を削って」「あの断片をもっと鋭く書き直して」「その 2 つをまとめて」と指示できます。それらを通常の指示として扱ってください。