sharp-writing

鋭い文章を書く

鋭い文章を書きましょう。すべての言葉に意味を持たせます。以下のルールは、すべての文章と Markdown に適用されます。

まず要点を見つける

書き始める前に、考えの要点を見つけます。その要点を述べ、明確に伝えます。

原則

• 鋭く、正確に、簡潔に。要点を率直に伝えます。短いほど良い文章です。
• わかりやすい言葉を使います。短く明快な文にします。
• 冗長な表現や中身のない言葉を避けます。
• 読者を尊重します。強要したり、権威的な口調にしたり、子ども扱いしたりせず、重要な点をわかりやすく伝えます。
• 改まった文体を保ちます。

すべての言葉を吟味する

意図を正確に伝える言葉を選びます。一般的な言葉を優先し、より精密な場合に限って、凝った言葉や専門用語を使います。

改まった文体を保つ

堅苦しくならないよう、プロフェッショナルな文章を書きます。省略のない完全文を使い、書き出しをぶつ切りにしません。スラング、くだけた専門用語、顔文字は使いません。

コードのように文章を組み立てる

良い文章は、良いコードに似ています。

• 繰り返しや重複を避けます。
• コードをリファクタリングするように文章も見直し、すべての考えを整理して明確にします。

一文に一つの考えを、一段落に一つの論点を盛り込みます。論点に複数の段落が必要な場合は、見出しを付けます。複雑な考えは、同じように小さな考えに分けます。複数の考えを一文に詰め込んだり、複数の論点を一段落に詰め込んだりしません。コロンやダッシュで節を連ねた文は、分けて書きます。

寄り道ではなく、まっすぐな道筋を示します。文章を書くのは、未踏の山を登るようなものです。道を見つけるまでは進んだり戻ったりしますが、頂上からはまっすぐな道が見えます。その道筋を書きましょう。読者が求めているのは、道を探し当てるまでの過程ではなく、目的地までの道筋です。

肯定的な表現を優先する

何であるかを述べ、何でないかは述べません。否定表現は読者に意味を反転させ、二重否定は二度の反転を求めます。

否定形の言い換えを削る

よくある反射的な書き方として、肯定した後に、同じ考えを否定形で言い換えるものがあります。「X は A であり、B ではない」という形で、B が単に A ではないものを指す場合です。否定形の部分は削ります。

最後の事実で終える

情報が終わったところで文章を終えます。要点を言い換えたり、教訓を導いたり、書いた内容を正当化したりする文で締めくくりません。最後の文を残す前に、新しい事実や指示が含まれているか確認します。強調、結論、安心させることだけが目的なら、削ります。

必要な場合にのみ例を加える

例がなければルールを理解しにくい場合に限り、例を加えます。それだけで伝わる文章に例は不要です。

例を加える場合は、中立的な状況を考えます。

Markdown

Markdown ファイルでは、文章の各段落を物理的な一行に収めます。行幅に合わせて文章を折り返しません。

エムダッシュ：読者層による唯一の違い

エムダッシュ（—）は、読者層によって主に使い方が異なります。

• 人間向け：エムダッシュは視覚的な区切りとしてのみ使います。
• AI エージェント向け：エムダッシュは文章中でも使えます。ただし、正確で要点を押さえた文に、エムダッシュが必要なことはほとんどありません。

両方に使える、視覚的な区切りの例：

• key1 — 説明 1
• key2 — 説明 2

AI エージェント向けのみ、文章中で使える例：

主な考えを述べます — その後にダッシュの後で補足を加えます。

読み返して書き直す

ファイルに書いた文章は、まだ完成ではありません。読み返し、自由に編集します。書き直し、修正し、簡潔にします。

編集とは書き直すこと

新しい内容は既存の文に織り込みます。内容を盛り込める文がない場合に限り、文章を追加します。良い編集は、文章を編集前と同じ長さか、それより短くします。