writing-fragments

writing-fragments skill の概要

writing-fragments skill は、アウトラインから始めるのではなく、素材から記事を組み立てるための skill です。焦点を絞ったインタビューを進め、使える一文を拾い集め、それらを1つの markdown ドキュメントに追加していきながら下書きを形にしていくのに役立ちます。最終的な構成を決める前に、主張、短いエピソード、言い回し、まとまりきっていないアイデアを残しておきたいなら、この writing-fragments skill が向いています。

この skill は、Knowledge Capture や初期段階のドラフト作成に特に適しています。主な課題が「磨き上げ」ではなく、「何を残す価値があるのかを見極めること」であるときに力を発揮します。writing-fragments の核心的な差別化ポイントは、段階、見出し、きれいな主張を早い段階で無理に求めないことです。すでに構成が固まっているなら通常のプロンプトで十分なことが多いですが、先に素材が必要なら、この skill のほうが合っています。

この skill は何のためのものか

ユーザーがアイデア出しをしたい、考えを吐き出したい、断片を集めたい、あるいは粗いテーマを文章素材に変えたいと言っているときに writing-fragments を使ってください。元の内容が散らかっている場合や、完成形がまだ見えていない場合に、特に有効です。

何が違うのか

ワークフローは会話的かつ蓄積型です。質問し、記録し、読み返し、追加する、という流れで進みます。この skill は、セッション中もドキュメントを編集し続ける前提で動くため、毎回新しい文を出すことと同じくらい、ユーザーの編集を守ることが重要です。そのため、ライブな執筆セッションでは、一発勝負のブレインストーミング用プロンプトより実用的です。

使わないほうがよいケース

最初から完成したアウトライン、構成済みの brief、あるいは磨き上げられた記事が必要なら、writing-fragments は使わないでください。すぐに単独で読める、自己完結した出力が求められる場合にも向いていません。

writing-fragments skill の使い方

インストールしてコンテキストを読み込む

skills ディレクトリから writing-fragments install の流れで導入し、まず skills/in-progress/writing-fragments/SKILL.md を開いてください。この repo には補助スクリプトやサポート用フォルダがないため、skill の挙動はほぼすべて skill ファイル自体に書かれています。つまり、インストールの成否は裏側の自動化を探すことではなく、指示を丁寧に読むことにかかっています。

粗い目的をよいプロンプトに変える

この skill は、トピック、想定読者、そしてどんな断片を残したいのかをユーザーが伝えたときに最もよく機能します。よい入力の例は、「小規模チームが AI メモツールを採用する理由について書いているので、鋭い主張と具体例を引き出してほしい」や、「自分の仕組みが失敗した理由についての Knowledge Capture エッセイ用に断片を集めたい」といったものです。「生産性について何か書いて」のような曖昧な入力では、掘り下げのセッションをしても有益な素材になりにくくなります。

セッション中の実践的な進め方

保存先のパスが指定されていない場合は、まずどこに保存するかを尋ね、その後はセッション中ずっとそのパスを一貫して使ってください。追記するたびに markdown ファイルを読み直し、ユーザーの編集を上書きしないようにします。最初の書き込みでは、先頭に単一の H1 の作業タイトルだけを置き、早い段階でセクション化せず、断片が出てきた順にそのまま追加していきます。

repo でのおすすめの読み順

まず SKILL.md を読み、そのファイル内の上位ガイダンスで、fragment の定義、セッションの進め方、ファイル形式のルールを確認してください。出力品質に最も影響するのは、そのあたりです。自分のワークフローに合わせて writing-fragments guide を調整するなら、構成、ドキュメント状態、何を fragment とみなすかという制約に注目してください。

writing-fragments skill の FAQ

writing-fragments は初心者向けか

はい。トピックについて質問に答えられて、反復的な進め方を受け入れられるなら向いています。大事なのは書く技術そのものより、プロンプトに反応しながらセッション中ずっとドキュメントを開いておけるかどうかです。

通常のプロンプトと何が違うのか

通常のプロンプトは、完成した1本を生成しようとすることが多いです。writing-fragments は、まず素材を集めて、整理は後回しにするよう設計されています。記事の形を決める前に、どの一文がいちばん強いかを見極めたいときに、この違いが効いてきます。

Knowledge Capture のワークフローに合うか

はい。writing-fragments for Knowledge Capture の使いどころは強いです。体験、洞察、インタビューの回答を、即座に要約へ押し込めるのではなく、再利用できる文章断片として残したいときに向いています。

どんな場合は避けるべきか

構成、最終的な主張、あるいは一発で完結する成果物が必要なら避けてください。また、同じファイルを編集し続けられない場合にも相性がよくありません。この skill は、現在のドキュメントを保持して読み返すことを前提にしているからです。

writing-fragments skill を改善するには

モデルにもっと良い素材を渡す

writing-fragments usage を改善する最も効果的な方法は、抽象的なテーマではなく、具体例、対比、引用、印象的な場面で返すことです。「リモートワークについての断片が欲しい」と言えば、一般論になりがちです。一方で、「チームが会議を信頼しなくなる瞬間についての断片が欲しい」と言えば、もっと鋭い文章の燃料が得られます。

構成への早すぎる流れ込みを防ぐ

よくある失敗は、早い段階でアウトラインに寄ってしまうことです。会話が素材の収集ではなく要約に向かい始めたら、残す価値のある一文、記憶に残る主張、完成稿にも残せる具体描写へと軌道修正してください。この skill は、構成を後の編集工程として扱うときに、最もよく機能します。

残るものを基準に反復する

最初のパスが終わったら、読みやすく、具体的で、再利用できる fragment を見直してください。強い一文の周辺についてさらに素材を求めるか、弱い部分だけ代案を出してもらうよう依頼します。目的は synthesis の前に fragment の在庫を増やすことなので、全面的な書き直しを頼むより、そのほうがたいてい効果的です。