writing-beats について
writing-beats は、原稿素材から記事を一つのビートずつ書き進めるためのスキルです。読者がすでに理解している概念を追跡し、各ステップが導入済みの内容にだけ基づくようにします。各段階で利用者が進む道筋を選び、ビートが決まってから記事ファイルに書き込みます。
主な機能
- 01ステップごとに一つのナラティブビートを追記
- 02導入済みの概念と前提知識を管理
- 03原稿素材から内容を抽出し再構成
- 04書き込み前に記事ファイルを読み直し
活用シーン
- 01Markdown のメモ群を構成の整った記事にまとめる
- 02同じ素材から異なる語り口の入り口を試す
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/writing-beatsを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
ユーザーは、生の素材をまとめた Markdown ファイルを渡しています（またはこれから渡します）。これは展開段階です。素材の探索は終わっており、素材の山は固定されています。進む道筋を決め、素材の山を掘り下げて各ビートを埋めてください。
ユーザーが記事の保存先を指定していない場合は、一度だけ尋ね、そのパスを記憶してください。
その後、好きな道を選ぶアドベンチャー形式で、ビートごとに進めます。
- 前提知識を確認します。 ビートに入る前に、読者がどのような知識を持って読み始めるのか、つまり最初から基礎ができている概念をユーザーと確認してください。それ以外の概念は、後のビートで使う前に、先行するビートで基礎を築く必要があります。基礎づくりを参照してください。
- 生の素材から、開始候補となるビートを2～3個作成します。それぞれ記事への異なる導入部分とします。各ビートで使えるのは、すでに基礎ができている概念だけです。また、それぞれが新たに基礎を築く概念を記載してください。記事ファイルに書き込む前に、ビートをユーザーに提示します。ユーザーに1つ選んでもらいます。選んだビートによってどのビートへ進めるようになるかを、道筋を少し先まで見渡せるようにプレビューしてください。
- ユーザーが開始ビートを選んだら、そのビートだけを記事ファイルに書き込みます。ビートは、内容に応じて1文でも複数段落でもかまいません。そこで止めます。
- ディスクから記事ファイルを再度読み込みます。そのうえで、現在の記事から進める次のビート候補を2～3個提示します。それぞれ、現在基礎ができている概念だけで進められる必要があります。また、それぞれが新たに基礎を築く概念を記載してください。
- 記事が自然な結末に達するまで、手順3～5を繰り返します。
基礎づくり
すべての概念は、それを使うビートより前に基礎を築く必要があります。読者が最初から知っているか、先行するビートで出会っている必要があります。基礎ができていない概念に触れるビートは、読者を置き去りにします。これが、この旅で避けなければならない唯一の展開です。基準となるのは言葉ではなく概念です。専門用語を一切使っていなくても、読者が知らない考え方にビートが依存することがあります。概念に名前（用語）がある場合、基礎を築くとは、考え方と用語を一緒に定着させることです。
概念の基礎を築く方法は、次の2つです。
- 前提知識：最初のビートより前に基礎が築かれている状態です。読者がすでに持っている知識であり、最初に決めたら固定します。
- 導入：ビートで概念の基礎を築き、その後のすべてのビートで基礎ができている状態になります。
つまり、各ビートには2つの役割があります。すでに基礎ができている概念を必要とすることと、新たな概念の基礎を築くことです。ここまでに基礎ができている概念の一覧を常に管理し、ビートが成立するたびに更新してください。
この仕組みによって、好きな道を選ぶアドベンチャー形式が成り立ちます。候補となるビートに進めるのは、そのビートが必要とするすべての概念について、すでに基礎ができている場合だけです。概念Xの基礎を築くビートを選ぶと、Xの基礎ができるのを待っていたすべてのビートへ進めるようになります。次のビートを提示するときは、現在の基礎ができている概念からすべて進める候補にし、それぞれがどの概念の基礎を築くかを伝えて、選んだ道がどの先へつながるのかをユーザーが把握できるようにしてください。
大きく影響するのは、何を前提知識とし、何を記事内で基礎づけるかです。前提知識を求めすぎると、その知識のない読者を締め出してしまいます。記事内で基礎を築きすぎると、冒頭のビートが定義ばかりになってしまいます。前提知識を確認するときにユーザーと相談し、進めたいビートに、まだ基礎が築かれていない概念が必要だとわかった場合にも、改めて検討してください。解決策は、その前に概念の基礎を築くビートを置くか、その概念を前提知識に加えるかのどちらかです。
ビートとは
ビートとは、旅の中の1つの展開です。1つの役割を担います。場面を設定する、要点を伝える、問いを投げかける、補足を加える、視点をひねる。その役割を果たしたら、次のビートが方向を変えられる地点で止まります。
ビートの長さは、必要な内容によって決まります。
- 1文で十分なら、1文にします（「そして、それから3週間、何も起きませんでした。」）。
- 導入が必要なら、短い段落にします。
- 独立した小話、議論、例が必要なら、複数の段落にします。
「ビート」に5段落と3つの小見出しが必要なら、それはビートではありません。2つのビートを無理につなげたものです。分割してください。
## 素材の山から拾う素材の山から材料を取り出して、各ビートに反映します。言い換えたり、分割したり、組み合わせたり、引用したりしてかまいません。素材の山は採石場です。
旅を終える
記事は旅が終わったときに完成します。素材の山が空になったときではありません。使われずに残る断片が出るのはよくあることです。それで問題ありません。必要以上の素材を用意しておくのは、そのためです。
執筆のリズム
- 一度に1つのビートを追加します。先の内容は決して書きません。
- 書き込む前に、毎回ディスクから記事ファイルを読み直します。ユーザーによる編集は必ずそのまま維持します。
- ユーザーが前のビートを大幅に編集した場合は、その変更を次の内容に反映させます。
- ユーザーが「そのビートを書き直して」や「戻って別のビート3を試して」と言った場合は、そのとおりにします。該当箇所だけを編集し、ほかの部分には手を加えません。