| name | core-message-writing |
| description | ブログ記事・社内周知・ドキュメントなどの文章を書く・ドラフトを作るときに、コアを際立たせるためのガイド。AIは情報を足し算しがちでコアがぼやけた冗長な文章になりやすいので、それを防ぐ。「記事を書いて」「ドラフトを作って」「周知文を書いて」などのリクエストで使う。 |
| user-invocable | true |
Core Message Writing
コアを際立たせた文章を書くために、最初に考えるべきことに振り切ったガイド。
AIは情報を足し算する方向に偏り、コアがぼやけた冗長な文章を書きがちになる。これを防ぐ。
このSkillが扱わないこと
- 文体は扱わない。「だ/である調」か「ですます調」か、カジュアルか落ち着いたトーンかは、対象媒体に合わせて別途決める。ここで扱うのは媒体に依存しない「コアを際立たせる」部分だけ。
根本姿勢
コアメッセージを明確に際立たせた上での、最小限の文章が最も良い。目的は文章を短くすることではなく、コアを際立たせること。その結果としての最小限であって、順序を逆にしない。
そのために、想定読者 × 読後感を決め、それを軸にすべてを判断する。AIは情報を足し算してコアをぼやかしがちなので、書き終えたら必ず見直す。
① 書く前に決める（このSkillの心臓）
書き始める前に、次の2つを言語化する。これが定まらないままだと必ずコアがぼやける。
- 想定読者：誰が読むか。その人がすでに知っていることは何か
- 読後感・とってほしいアクション：読んだ後、読者にどう感じてほしいか・何をしてほしいか
長い文章では、さらに次も決めておくと軸がぶれにくい。
- サブメッセージ：コアを支える要点（2〜3個まで）
- 伝えないこと：あえて書かないと決めるもの（スコープ外）
決めた読後感の達成に必要な具体（コマンド・手順・実例など）は、「自明だから」で省略しない。読者が再現・納得できなくなる。
② 書いた後に、コアを際立たせる方向へ調整する
判断軸は1つ：それはコアを際立たせるか、ぼやかすか。「繰り返しは消す」「前提は省く」のような一律ルールではない。同じ要素でも、際立たせるなら残す（むしろ足す）、ぼやかすなら削る。
- 繰り返し：コアを際立たせる繰り返しは効果的に使ってよい。それ以外の繰り返し（脇道の蒸し返し、同じことの言い換え）はコアをぼやかす → 削る
- 同じ主張を言い換えて隣接で2回3回重ねない。読者が推論できる中間ステップも書かない（非自明な因果なら1回だけ書く）
- 同じ主張を別セクションで丸ごと再説明しない。締めなどで思い起こさせたいときは、再説明ではなく短い一文で想起させる
- 前提知識：コアに重要な前提は、際立たせるためにあえて入れる・強調する。コアに関わらない前提は削る
- 一般論の前置き・枕詞（「近年〜」「〜が重要な時代だ」）：ほぼ常にコアをぼやかす → 削り、本題から入る
- 回りくどい言い回し・読めば分かる逐一説明：コアに寄与しないなら削る
- 低情報な括弧での言い換え・補足：括弧の補足はデフォルトでは削る。残すのは「①想定読者がその語を知らない ②その語がコアに繋がる」の両方を満たす時だけ
- NG：読者が既に知っている語の展開・和訳。「EM（エンジニアリングマネージャー）」「デプロイ（本番への反映）」「プロファイル（認証情報の置き場）」
- 読者が直接の語を分かるなら、言い換えを括弧で重ねず最初からその語を使う（「exponential backoff」で伝わるならそう書く）
- OK（例外）：想定読者がその語の専門外で、かつコアに繋がる補足。「NVC（非暴力コミュニケーション）」。読者が知らない略語を本文で繰り返し使うときの初出定義も同様にOK
- 対象外：括弧で具体値を足すのはこの原則の対象外で、むしろコアを際立たせる足し算（「実行時間が短縮された（20分→8分）」）
際立たせる側として、「自明だから」で削ってはいけないもの：
- コアに直結する説明（各部の意味づけなど）。削ると読者が引っかかる
- つなぎ（「まず〜」「次に〜」）。先に何をするか示すと認知負荷が下がる
見出し
- 見出しは必要な時だけ使う。短い記事や単一トピックならフラットに書く
- 見出し名だけで中身が想像できるよう具体的に書く
- NG「〜の工夫」「〜について」「〜の仕組み」
- OK「commit messageが冗長すぎる問題」「サブエージェントで会話文脈から切り離す」
- 見出しだけを上から読んだとき、全体のストーリーが伝わるようにする
- 構成にメリハリをつける（重要な部分は詳しく、そうでない部分はさらっと）。全セクションを均等に書かない
最終チェックリスト
書き終えたら次を自問する。
