writing-beats について
writing-beats は、既存の Markdown 素材から読者が進路を選ぶ形で記事を組み立てるライティングスキルです。概念の定着状況を追跡し、選ばれた経路に沿って一度に 1 つのビートを書きます。
主な機能
- 01読者が知っている前提を決める
- 02開始ビート案を2~3個提示
- 03選択後に進める方向を予告
- 04ビートを1つずつ執筆・確認
- 05各ビートで導入する概念を追跡
- 06素材から内容を抽出して再構成
活用シーン
- 01複数の入り口から記事の書き出しを選ぶ
- 02読者が知っている概念に沿って展開を組む
- 03原素材を段階的に記事へまとめる
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ vinvcn/ mattpocock-skills-zh-cn --skill writing-beatsインストール後、Claude Code で/writing-beatsを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
ユーザーは raw material の Markdown ファイルをすでに渡している(またはこれから渡す)ものとします。これは exploit です。探索は完了しており、pile は固定されています。その中を通る経路をひとつ選び、pile を掘り起こして各 beat を埋めていきます。
ユーザーが記事の保存先を指定していない場合は、一度だけ尋ね、そのパスを覚えておいてください。
その後、自分で経路を選ぶアドベンチャー形式で、beat をひとつずつ進めます。
- 前提を確立する。 beat を始める前に、読者が何を知った状態で読み始めるのか、つまり最初から grounded になっている概念について、ユーザーと合意します。それ以外の概念はすべて、後続の beat で使う前に、いずれかの beat で grounded にする必要があります。Grounding を参照してください。
- raw material から、候補となる starting beats を2~3個書き出します。それぞれ、記事への異なる入り口となります。各 beat は、grounded 済みの概念だけに依存でき、どの概念を新たに grounded にするのかを記録します。記事ファイルに書き込む前に、これらの beat をユーザーに提示してください。ユーザーがひとつ選びます。選んだ beat の後にどの beat が解放されるのかをプレビューし、これから進む経路を少しだけ見せてください。
- ユーザーが starting beat を選んだら、記事ファイルにはその beat だけを書き込みます。beat は、自然に必要な長さに応じて、一文でも複数段落でもかまいません。書き終えたら停止します。
- 記事ファイルをディスクから読み直します。そのうえで、候補となる next beats を2~3個提示します。記事の現在位置から journey が pivot できる、異なる方向を示す beat です。それぞれ、現在 grounded になっている概念だけで到達できる必要があります。また、各 beat が何を grounded にするのかを記録します。
- 記事が自然に終わるまで、手順3~5を繰り返します。
Grounding
概念は、その概念に依存する beat が現れる前に、必ず grounded になっていなければなりません。読者が最初から知っているか、それより前の beat で触れている必要があります。grounded になっていない概念に手を伸ばす beat は、読者を置き去りにします。これが journey で唯一してはならないことです。単位となるのは概念であり、その表現ではありません。用語が一切出てこなくても、読者が持っていない考え方に依存している beat はありえます。概念に名前、つまり term がある場合、それを grounded にするには、その考え方と term の両方を定着させます。
概念を grounded にする方法は2つあります。
- Prerequisite —— 最初の beat より前に grounded にします。読者があらかじめ持っている概念です。冒頭で確定させます。
- Introduced —— ある beat で概念を確立し、それ以降のすべての beat で grounded な状態にします。
つまり、各 beat は2つのことを行います。すでに grounded になっている概念を必要とし、新しい概念を grounds します。ここまでに grounded になった内容の一覧を管理し、beat が確定するたびに更新してください。
これが choose-your-own-adventure の形を決めます。候補となる beat は、必要とするものがすべて grounded になっている場合にだけ到達可能です。概念 X を grounded にする beat を選ぶと、X を待っていたすべての beat が解放されます。next beats を提示するときは、すべて現在 grounded になっている概念から到達できるようにし、それぞれが何を grounded にするのかを示してください。そうすれば、ユーザーはどの経路が開かれるのかを把握できます。
重要なのは、何を prerequisite とし、何を記事の中で grounded にするかです。冒頭に多くを求めすぎると、それらを持たない読者を締め出してしまいます。記事の中で grounded にしすぎると、序盤の beat が定義で埋め尽くされます。prerequisite を決める際にユーザーと合意し、魅力的な beat の結果に、まだどの beat でも grounded にされていない概念が必要だとわかった場合は、その都度見直してください。解決策は、その前に grounding beat を置くか、その概念を prerequisite に引き上げることです。
What is a beat
Beat は journey のひとつのステップです。役割はひとつだけです。場面を設定する、主張を提示する、問いを投げかける、余談を挟む、視点を反転させる。そしてそこで止まり、次の beat が pivot できる余地を読者に残します。
beat の長さは、その役割を果たすのに必要な分だけです。
- 役割が一文で果たせるなら、一文にします("And then nothing happened for three weeks.")。
- 前置きが必要なら、短い段落にします。
- beat が独立した vignette、論証、または例として成立するなら、複数段落でもかまいません。
「beat」に5段落と3つの subheadings が必要なら、それは beat ではなく、2つの beat がくっついています。分割してください。
Pulling from the pile
raw pile から素材を取り出し、各 beat を埋めていきます。言い換えたり、分割したり、組み合わせたり、引用したりできます。この pile は素材の採掘場です。
Ending the journey
記事は journey が完了したときに終わります。pile を使い切ったときではありません。たいていの pile には、使われないまま残る断片があります。それで問題ありません。raw material が実際に必要な量より多いのは、まさにそのためです。
Writing rhythm
- 一度にひとつの beat だけを書き足します。先回りして書いてはいけません。
- 書き込む前に、毎回記事ファイルをディスクから読み直します。ユーザーの編集内容は必ず保持してください。
- ユーザーが以前の beat を大幅に編集した場合は、その変更に応じて次に書く内容を変えてください。
- ユーザーが「rewrite that beat」や「go back and try a different beat 3」と言った場合は、そのとおりにしてください。該当箇所だけを編集し、ほかの部分には触れないでください。