Day 017 — 説明構成（Why→What→How）

今日のテーマ

非エンジニアの相手に新機能の仕様を説明するとき、「何ができるか（What）」や操作手順（How）からいきなり話し始めるのではなく、「なぜこの機能があるのか（Why）」を最初に渡し、Why→What→Howの順で運ぶ練習をする。

なぜこれが難しいのか

技術者は普段、機能を「仕組み→できること」の順で頭の中に持っているため、説明もつい仕組みや操作手順から話し始めてしまう。しかし非エンジニアの相手にとって、いきなり操作画面や設定項目の話をされても、それが何のためにあるのか分からないまま手順だけを覚えることになり、想定外の質問やエラーに遭遇したときに応用が利かない。これは説明者の技術力や話し方の問題ではなく、すでに全体像を知っている側が「この機能が何のために存在するか」を無意識に自明の前提としてしまい、Whyの説明を省略しやすいという構造的な癖である。特に良い知らせ（新機能のリリースなど）ほど「早く使い方を教えたい」という気持ちが先に立ち、Whyを飛ばしてHowから入ってしまいやすい。

シチュエーション

あなたはSaaS勤怠管理サービスのエンジニア。来週リリース予定の「CSV一括インポート機能」（社員データをまとめてアップロードして一度に登録できる機能）について、カスタマーサポートチームに配属されたばかりの新人・鈴木さん（入社2週間、非エンジニア）に事前説明会を開き、リリース後の問い合わせに備えてもらう必要がある。鈴木さんはこの機能について資料で名前を見た程度で、中身は何も知らない。

You're an engineer at a SaaS attendance-management company. A "CSV bulk import" feature (upload a spreadsheet to register many employees at once) is launching next week. You're running a walkthrough for Jordan, who just joined the customer support team two weeks ago and has no engineering background, so they'll be ready to field questions once it ships. Jordan has only seen the feature name in a release doc — nothing else.

ここまでの会話

鈴木さんよろしくお願いします。CSV一括インポート機能って名前だけ資料で見たんですけど、正直あまりピンと来てなくて……

あなた（心の中で）操作画面のスクリーンショットや設定項目の説明から入りたくなるが、鈴木さんはそもそも「これが何のためにある機能なのか」を知らない。ここでいきなり画面の話をしても、丸暗記にしかならない。

鈴木さん結構複雑な機能なんですか? お客さんから問い合わせが来たときにちゃんと答えられるか、正直不安で……

JordanThanks for setting this up. I saw "CSV bulk import" in the release notes but honestly it didn't mean much to me.

You (internally)You're tempted to pull up a screenshot of the upload screen and walk through the settings, but Jordan doesn't even know what problem this feature solves yet. Starting with the screen would just turn into rote memorization.

JordanIs it a pretty complex feature? I'm a little nervous about whether I'll be able to answer customer questions on it.

あなたの課題

ここから会話を続けてください。1往復では終わらせず、あなたの発言→相手の反応（想定）→あなたの返しの最低3ターンを自分で書いてみましょう。まず機能の存在理由〈Why〉を一言で伝え、次に何ができるようになるか〈What〉を具体的に説明し、最後に操作の流れとよくあるつまずきポイント〈How〉を、鈴木さんが問い合わせ対応で実際に使える形に絞って伝えるところまで含めます。日本版・アメリカ版それぞれで考えてみましょう。

ヒント1: 方向性（日本版）

鈴木さんは非エンジニアなので、操作手順を全部丸暗記させようとしても本番のイレギュラーな問い合わせには対応できない。1ターン目はWhy（この機能が解決する課題）だけに絞り、画面の話はまだしない。2ターン目でWhat（具体的に何ができるようになるか、ビフォーアフター）を伝える。3ターン目はHow全部を網羅しようとせず、鈴木さんが問い合わせ対応で実際に使う最小限の情報（操作の基本の流れ＋一番多いつまずきポイント1つ）に絞って渡す、というのがWhy→What→Howの骨格。

ヒント2: 使える言い回し（日本版）

1ターン目（Why）: 「まず結論から言うと、この機能は社員を1人ずつ手入力で登録する手間をなくすためのものです。まとまった人数の入社があると、今までは1人ずつ同じ登録作業を繰り返す必要がありました。」2ターン目（What）: 「今回できるようになるのは、Excelやスプレッドシートで作った社員名簿のCSVファイルを1回アップロードするだけで、何十人分でも一度に登録が完了することです。名前・部署・入社日などの列を決まったフォーマットに合わせて用意してもらうだけで済みます。」3ターン目（How＋要点の絞り込み）: 「操作自体は管理画面の『一括登録』ボタンからCSVを選んでアップロードするだけなんですが、一番多い問い合わせは『フォーマットが違ってエラーになる』というケースです。だから鈴木さんに覚えておいてほしいのは、フォーマットの見本ファイルの場所と、エラーが出たら列の順番とヘッダー名を確認してもらう、というこの2点だけで大丈夫です。」

Hint 1: Direction (US version)

Jordan isn't technical, so trying to make them memorize the full spec won't help when a real, unpredictable question comes in. Turn 1 should be pure Why — the problem this feature solves — with no screens yet. Turn 2 covers the What: a concrete before/after of what's now possible. Turn 3 shouldn't try to cover every detail of How — narrow it down to the basic operating flow plus the single most common thing that trips people up, since that's what Jordan will actually need on a support call.

Hint 2: Useful phrases (US version)

Turn 1 (Why): "So here's the bottom line: this feature exists to get rid of registering employees one at a time by hand. Whenever a big group joins at once, someone used to have to repeat that same manual entry for every single person." Turn 2 (What): "What's new is that you can upload one CSV file — built from a spreadsheet of your employee list — and register dozens of people in a single upload, instead of one at a time. You just need the columns, like name, department, and start date, to match a set format." Turn 3 (How, narrowed down): "The actual steps are just: hit 'Bulk Import' in the admin panel and upload the CSV. But the number one support question is going to be a formatting error. So really, the only two things you need to remember are where the sample template file lives, and to tell people to double-check their column order and headers if they hit an error."

あなたまず結論から言うと、この機能は社員を1人ずつ手入力で登録する手間をなくすためのものです。まとまった人数の入社があると、今までは1人ずつ同じ登録作業を繰り返す必要がありました。

鈴木さんあ、なるほど。それは地味に大変そうな作業ですもんね。それで、具体的に何ができるようになるんですか?

あなたExcelやスプレッドシートで作った社員名簿のCSVファイルを1回アップロードするだけで、何十人分でも一度に登録が完了します。名前・部署・入社日などの列を決まったフォーマットに合わせて用意してもらうだけです。

鈴木さん便利ですね! それ、お客さんが使うときにつまずきそうなところとかあります?

あなた操作自体は管理画面の『一括登録』ボタンからCSVを選んでアップロードするだけなんですが、一番多い問い合わせは『フォーマットが違ってエラーになる』というケースです。だから鈴木さんに覚えておいてほしいのは、フォーマットの見本ファイルの場所と、エラーが出たら列の順番とヘッダー名を確認してもらう、というこの2点だけで大丈夫です。

解説（日本版）

1ターン目は操作画面や設定項目に一切触れず、「手入力の手間をなくすため」というWhyだけを言い切っている。これにより鈴木さんは、細かい仕様を聞く前に「この機能が何のためにあるか」という土台を先に持てる。2ターン目のWhatも、機能の全仕様を並べるのではなく「ビフォーアフター」（1人ずつ→何十人分を一度に）という分かりやすい対比で伝えている。3ターン目が最も重要で、操作手順を細かく全部説明するのではなく、鈴木さんが実際の問い合わせ対応で使う最小限の情報（見本ファイルの場所＋一番多いエラーの原因）だけに絞り込んでいる。この絞り込みがないと、新人はどこが重要な情報なのか自分で判断できず、資料を丸暗記しようとして本番で応用が利かなくなる。

YouSo here's the bottom line: this feature exists to get rid of registering employees one at a time by hand. Whenever a big group joins at once, someone used to have to repeat that same manual entry for every single person.

JordanOh, that makes sense — that does sound tedious. So what can people actually do with it now?

YouYou can upload one CSV file — built from a spreadsheet of your employee list — and register dozens of people in a single upload, instead of one at a time. You just need the columns, like name, department, and start date, to match a set format.

JordanNice, that's a big time-saver. Is there anything that's likely to trip customers up?

YouThe actual steps are just: hit "Bulk Import" in the admin panel and upload the CSV. But the number one support question is going to be a formatting error. So really, the only two things you need to remember are where the sample template file lives, and to tell people to double-check their column order and headers if they hit an error.

Explanation (US version)

Turn 1 withholds the UI entirely and states only the Why — the manual-entry problem this solves — so Jordan has a mental frame before any detail lands. Turn 2 delivers the What as a concrete before/after (one at a time vs. dozens at once) rather than a spec dump. Turn 3 is the hardest part: instead of walking through every field and edge case, it deliberately narrows the How down to exactly two things Jordan can actually retain and use on a live support call — where the template lives, and the one failure mode that accounts for most tickets. Without that narrowing, a new hire has no way to tell which detail matters most and ends up trying to memorize everything, which falls apart the moment a real question doesn't match the script.

日本語 × English 対比ノート

両言語版とも「Why（なぜ）→What（何ができるか）→How（どう使うか、しかも最小限に絞る）」という骨格自体は共通しており、非エンジニアへの説明としてはほぼ普遍的な型といえる。違いが出るのは、相手の反応を受け止めるときの言い回しの重さにある。日本語版では「地味に大変そうな作業ですもんね」のように、相手の発言に一度共感を挟んでから次の情報に進む動きが自然に入りやすく、新人に対して一方的に教え込んでいる印象を和らげる効果がある。一方、英語版の "Oh, that makes sense" は共感自体は入れつつも簡潔で、すぐに次の質問（What）に移っており、説明のテンポそのものを優先する。ただし両文化に共通しているのは、3ターン目でHowを全部説明しようとせず、相手が実務で使う最小限の情報にあえて絞り込んでいる点であり、これは「教える側が全部を話すこと」と「相手が実際に使えること」が必ずしも一致しないという、教える場面全般に通じる注意点である。

今日・今週中に試せる小さな一歩

今週、誰かに何かの使い方や手順を教える機会（新しいツールの説明、後輩への業務引き継ぎなど）があったら、手順を話し始める前に一言だけ「これは何のためにやるか」を伝えてみる。相手が新人でなくても、資料の共有メッセージに一文添えるだけでも構わない。

自己評価

日本版: 自分で応答を考えられた

できたまあまあ難しかった

アメリカ版: 自分で応答を考えられた

できたまあまあ難しかった