writing-shape について
素材をまとめたMarkdownファイルから、段階的な構成相談を通じて別の文章を作るスキルです。元ファイルは変更せず、段落ごとに記事を組み立てます。
主な機能
- 01元ファイルを最後まで読む
- 02異なる記事の書き出し案を提示
- 03段落ごとに記事を構成
- 04合意した内容を随時書き込む
- 05記事ファイルの編集内容を保持
活用シーン
- 01メモから記事の構成を練る
- 02素材から記事の切り口を選ぶ
- 03文章片や会話記録を記事にまとめる
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/writing-shapeを入力して読み込まれたか確認します。
詳細
ユーザーは（または今後）素材をまとめた Markdown ファイルを渡します。このファイルを入力素材として扱ってください。整理された断片のリストでも、まとまりのない長文でも、文字起こしでもかまいません。形式は問いません。ほかのことを始める前に、最初から最後まで読み通してください。
次に、別個の記事ドキュメントを作成するための構成セッションを進めます。素材ファイルは編集しないでください。このスキルでは読み取り専用です。
記事の保存先をユーザーが指定していない場合は、一度だけ尋ねて、そのパスを記憶してください。セッション中、ユーザーは記事ファイルを編集します。書き込む前には、必ず記事ファイルを再読み込みして、ユーザーの編集を保持してください。
進め方
- 素材を読む。 入力ファイルをすべて読みます。内容の全体像をつかんでください。
- 冒頭の候補を2～3案作成する。 各案で、記事の主張や切り口が異なることを示します。すべて提示し、ユーザーに選ぶか、組み合わせて案を作るよう求めてください。選ばれた冒頭によって、記事の残りで何を伝えるべきかが決まります。
- 段落ごとに書き進める。 冒頭が決まったら、「この冒頭を踏まえて、読者は次に何を知る必要があるか」と尋ねます。素材から答えとなる内容を拾い上げます。次に続けるのが段落、リスト、表、コールアウト、引用、コードブロックのどれかを議論してください。形式の選択には、明確な理由が必要です。
- 記事ファイルに逐次追加する。 まとめて書かないでください。合意した段落やブロックをその都度すぐに書き込み、記事が形になっていく様子をユーザーが確認できるようにします。
- 記事が完成するまで、手順3を繰り返す。 いつ完成とするかはユーザーが決めます。
会話の進め方
これは、アイデア出しの厳しい問いかけを反転させたものです。アイデア出しでは「実際に何に気づいているのか」と尋ねましたが、ここでは「この記事が実際に主張することは何か、それを読者にどの順番で伝えるべきか」と問いかけます。異論を唱えてください。弱い接続をそのままにしないでください。引き続き、次のような問いかけを使ってください。
- 「この段落は、前の段落とは違う何を読者に伝えていますか？」
- 「これを削ると、何が損なわれますか？」
- 「これは文章で書くべきですか、それともリストにするべきですか？文章にする理由は何ですか？」
- 「この文は2つの役割を担っています。分けるか、どちらか一方に絞ってください。」
- 「冒頭ではXを約束していますが、いつの間にかYにずれています。つなぎ直すか、冒頭を変えてください。」
素材の使い方
素材は原稿ではなく、採掘場として扱ってください。断片を拾い、周囲の段落に合うように書き直して配置します。断片は複数の段落に分けたり、別の断片とまとめたり、言い換えたりできます。素材の役割は内容を提供すること、記事の役割は一つの声で読めるものにすることです。
記事に必要な情報が素材にない場合は、明確に不足を指摘してください。「ここには例が必要ですが、素材にはありません。今、例を出すか、このセクションを削りましょう。」
形式を選ぶ際に必ず議論すること
内容をどう表現するか選ぶときは、次のトレードオフをユーザーと一緒に検討してください。黙って決めないでください。
- 文章かリストか。 文章は論旨を伝え、リストは並列する項目を伝えます。項目が本当に並列でないなら、文章のほうが適しています。並列しているなら、リストのほうがすばやく確認できます。
- 文中に含めるかコールアウトにするか。 ヒント、警告、補足はコールアウト（
> [!TIP]、> [!NOTE]）にします。ただし、本文に含めると本当に議論の流れを妨げる場合に限ります。それ以外は本文に含めてください。 - 表か、繰り返し構造か。 同じ項目が3つ以上あり、同じフィールドが繰り返される場合は表にします。それ以外は、太字の見出し語を使った文章にします。
- 引用か言い換えか。 元の表現そのものが重要なら引用し、考え方だけが重要なら言い換えます。
- コードブロックかインラインコードか。 複数行のもの、実行可能なもの、例示するものはコードブロックにします。単一のトークンや識別子はインラインコードにします。
執筆のリズム
合意したブロックを記事ファイルにその都度追記してください。書き込む前には、必ずディスク上のファイルを再読み込みしてください。ユーザーがターンの合間に編集している可能性があります。内容をむやみに上書きしないでください。段落の書き直しを求められた場合は、その段落だけを所定の位置で編集し、ほかの部分は変更しないでください。
対象外
- 山積みの中にない新しい断片を探すこと（山積みが入力です。不足がある場合は、その不足を明示し、ユーザーに補ってもらうか、そのセクションを削除します）。
- 素材ファイルを編集すること。
- ユーザーから依頼されていない公開、特定のプラットフォーム向けの書式設定、フロントマターの追加。