llm-writing

LLM ライティング

まだ読み込まれていない場合は、/creative-writing-skills:intent-modeling を読み込んでください。 文章が短い回答を超える場合は、/creative-writing-skills:information-hierarchy を読み込んでください。

意図を持って書く

文章を作成する前に、次の手順を実行してください。

1. 対象を定める。 誰が、いつ読む文章ですか？ 会話が終わった後も残る文章（ファイル、プロンプト、ドキュメント、コミットメッセージ、PR）は、事情を知らない人が読みます。たとえば、初めて読むエージェント、チームメイト、あるいは依頼したことを忘れてしまった依頼者です。その読者に向けて書いてください。読み始める時点で何を知っていて、読み終えた時点で何を知っているべきですか？ 知る必要のないことは何ですか？ 書き始める前に、文章を要点に分けてください。それぞれの要点は、読者の読み進め方における一つの段階であり、一つの考え、目的、または転換を担います。
2. 根拠を確認する。 書く前に、関連する資料、参照先、メモを確認し、内容に食い違いがないことを確かめてください。
3. 下書きを作る。 読者に届く前に修正できる場所で、文章全体を書いてください。ファイルを書く場合はそのファイルに、それ以外の場合は一時ファイルや作業メモに書きます。チャット、PR、コミットに直接送った文章には、推敲の機会がありません。
4. 推敲する。 まず文章全体を見てから、構成、要点、段落、文、単語へと順に焦点を絞ってください。どの段階でも、その文章が何をしているかを確認します。正確か、前の内容から自然につながるか、読者に必要か。目的を果たしていないもの、読者の理解や知識に役立たないものは削除するか、書き直してください。各段階を行き来してください。一部を直した後は、周囲の要点、大きな構成、文章全体へと視点を戻します。修正後もつながりが保たれ、リズムに変化があることを確認してください。情報の開示順も確認してください。まず答えを示し、詳しい内容を前に出しすぎず、出典は最後に置きます。

削除するもの

• 節があるという理由だけで、その節を埋めるために書いた文章。削除するか、内容を適切な場所に統合してください。
• 仕組みを説明せずに、概念に名前を付けるだけの記述。仕組みを説明するか、その名称を削除してください。
• 根拠を示さずに結論を述べること。根拠を示すか、主張を削除してください。
• 自信ありげな表現で不確実さを隠すこと。わからないことは、わからないと伝えてください。
• あらゆる主張を但し書きで弱めること（「注目すべき点は」「考慮することが重要です」など）。言い切るか、書かないでください。
• 指示に条件を付けること（「〜の場合に限り」「〜でない限り」「必要であれば」「準備ができたと思ったら」など）。ほとんどはためらいの表れです。指示は明確に述べ、反対の状況では指示が誤りになる場合にだけ条件を残してください。
• すでに述べたことを別の言葉で繰り返したり、本文を結論として要約したりすること（「まとめると」「全体として」など）。削除してください。
• 意味ではなく、接続語で考えをつなぐこと（「さらに」「そのうえ」「加えて」など）。接続語なしでは関係が伝わらないなら、構成を見直してください。
• 一方の節だけで意味が伝わる、二つの節を対にする表現（「XではなくYです」など）。意味を担う節だけを残してください。
• 会話のにじみ。文章が、その文章を生み出した会話の中で返答しているかのように書くことです。その場で作られた用語、ルールの背景にある出来事、「古いバージョン」、「前に話したように」、読者が尋ねていない質問への回答などが含まれます。読者はその会話に参加していません。会話を知らなくても確認できる理由を添えて、読者に向けて書いてください。