エンジニアは伝え方が9割/90% of what engineers need is communication skills

文字書き起こし記事：
https://zenn.dev/babyjob/articles/3b91624ae33953

https://fortee.jp/phpcon-okinawa-2024/proposal/7268a27c-8357-493e-a43f-f9991772f359

「エンジニアは技術力があれば食っていける」というのは間違いです。

バグの詳細、進捗の報告、修正方針、時には障害の現状報告まで、エンジニアのまわりは他者へ伝えることで溢れています。
そう、チームとしてソフトウェアを開発する以上、エンジニアに求められるものは、プログラミング言語より先に日本語の技術です。

しかし、みなさんも報告したいことがあるのに相手へ伝わらずもどかしく思ったり、またはうまく伝えることができない人を見て歯痒い思いをしたことがないでしょうか？

本発表では私がカンファレンスでの登壇時や、仕事で実践している工夫をもとに、明日から使える伝え方のテクニックと考え方をお伝えします。
伝え方のテクニックは仕事だけでなく、PHPカンファレンス沖縄のようなイベントでの登壇時にも役立ちます！
このトークを聞いて、技術知識だけでなく、伝え方の能力も磨きましょう!!

Transcript

1. エ ン ジ ニ ア は BABY JOB株式会社 加納悠史 伝 え 方 9 割
2. Question
3. なぜ エンジニアに 伝える力 が必要か？ Question
4. Answer
5. エンジニアは チームで動くから Answer
6. 現在のエンジニアは チーム戦 6 サービスはチームでつくる ▰ 誰か一人の 天才的能力 で成功はしない ▰ チームで成功まで到達する必要がある 　➡ チーム内での 情報の伝達 が必須
7. 情報の伝達はボトルネック 7 Aさん Bさん 機能Aの実装お願い 実装イメージは...
8. 伝える必要がないなら困らない 8 Aさん • 起こっている事象はこんな感じ • バグの原因はこのへん • 言葉にしづらいけどこうすれば直せる • 直したときの影響はあそことあそこ... しかし、現実はそうでない
9. 情報の伝達はボトルネック システム間連携と置き換える 9 システムA システムB API
10. 情報の伝達はボトルネック システム間連携と置き換える 10 システムA システムB API 処理時間かかる 情報送信は時間がかかる
11. 情報の伝達はボトルネック システム間連携と置き換える 11 システムA システムB JSONでのデータ連携です JSONだったら カンタン！
12. 情報の伝達はボトルネック システム間連携と置き換える 12 システムA システムB CSVでのデータ連携です カンマ区切りね OK!OK! 読み込めるよ 取り込みやすい = 低コスト！
13. 情報の伝達はボトルネック システム間連携と置き換える 13 システムA システムB CSVでのデータ連携です !
14. 情報の伝達はボトルネック システム間連携と置き換える 14 システムA システムB CSVでのデータ連携です 〇〇県の新生児に関するデータ CSV 公開日:2024/09/01 ※このデータは令和 5年3月までに届出があった新生児の .... 新生児ID 項目名 値 1 氏名 鈴木太郎 生年月 2023/07 住所 “大阪府,大阪市,北区” 2 氏名 佐藤次郎 生年月 2023/08 ？？？
15. 情報の伝達はボトルネック 人と人でも一緒 15 Aさん Bさん バグ原因の調査しました !
16. 情報の伝達はボトルネック 人と人でも一緒 16 Aさん Bさん バグ原因の調査しました ! バグ報告書 SelectItemsクラス内の、180行目にあるルー プにて、変数selectedが最初のループ処理時 にアイテムの情報が代入された後、次のルー プ処理にてアイテムの種別が「道具」だった場 合、上書きされずに前ループの値が残ってしま うため、次かその次のループにてアイテムの種 別が「道具」でなくなった時に、上書きされな かった値がそのまま利用されてしまうため、操 作方法によっては選んでいないはずのアイテ ムが使用されてしまいます。 ？？？
17. チームになると さらに重要に 17
18. チームの強さは メンバの伝える力に かかっている
19. 伝える力を 鍛えよ
20. このトークの目的 伝わる “伝え方” の考え方を解説 仕事 の "ボトルネック " を 改善する方法を学ぶ
21. 加納 悠史 PHPでの開発 / 設計 / オフショア 
 @YKanoh65 
 経　歴
 その他
 PHPer　ダイビング　観葉植物 
 PHPカンファレンス関西2024実行委員長
 カノウユウジ 　 Twitter
 BABY JOB株式会社 
 所　属

22. 入社エントリー書きました 22 BABY JOB　note
23. 23 説明の大原則 知識のベースライン 伝えることをサボる
25. 25 抽 象 具 体
26. 抽象情報 ➡ 具体情報 相手に「話の全体像」を理解させる ▰ 結末を予想しながら話を聞ける ▰ 後の説明が理解しやすくなる 26 ? 結論 ? ? ハラハラ ドキドキは いらない 全体（抽象）の説明 詳細（具体）の説明
27. 抽象情報 ➡ 具体情報 27 補 強 補 強 補 強 補 強 結論 相手に「話の全体像」を理解させる ▰ 結末を予想しながら話を聞ける ▰ 後の説明が理解しやすくなる 全体（抽象）の説明 詳細（具体）の説明 具体 具体 具体 具体 具体
28. 抽象情報 ➡ 具体情報 28 結論 相手に「話の全体像」を理解させる ▰ 結末を予想しながら話を聞ける ▰ 後の説明が理解しやすくなる 全体（抽象）の説明 詳細（具体）の説明 具体 具体 具体 具体 具体 右に行ったり 左に行ったり
29. 具体から話して全体がわからなくなる例 この前調査依頼したライブラリ、 どんな感じ？使えそう？
30. 具体から話して全体がわからなくなる例 この前調査依頼したライブラリ、 どんな感じ？使えそう？ 要件に合ってます。あれを使えば、 開発工数が1人月削減できそうです
31. 具体から話して全体がわからなくなる例 この前調査依頼したライブラリ、 どんな感じ？使えそう？ 要件に合ってます。あれを使えば、 開発工数が1人月削減できそうです お、ええやん 納期余裕がないし、使おうやないか
32. 具体から話して全体がわからなくなる例 この前調査依頼したライブラリ、 どんな感じ？使えそう？ 要件に合ってます。あれを使えば、 開発工数が1人月削減できそうです お、ええやん 納期余裕がないし、使おうやないか しかし、あれを使うには フレームワークの バージョンアップが必要で ...
33. 具体から話して全体がわからなくなる例 33 この前調査依頼したライブラリ、 どんな感じ？使えそう？ 要件に合ってます。あれを使えば、 開発工数が1人月削減できそうです お、ええやん 納期余裕がないし、使おうやないか しかし、あれを使うには フレームワークの バージョンアップが必要で ... あかんやん。 さすがにフレームワークの バージョンアップなんて やってる余裕あらへんで
34. しかし、テックリードが言うには、 バージョンアップは5日あれば いけそうなんです
35. しかし、テックリードが言うには、 バージョンアップは5日あれば いけそうなんです ほないけるやん。 バージョンアップなんて もっとかかると思ってたわ
36. しかし、テックリードが言うには、 バージョンアップは5日あれば いけそうなんです ほないけるやん。 バージョンアップなんて もっとかかると思ってたわ でも別チームのリーダー曰く、 向こうで作ってる機能が 今のバージョンに依存しているそうで
37. しかし、テックリードが言うには、 バージョンアップは5日あれば いけそうなんです ほないけるやん。 バージョンアップなんて もっとかかると思ってたわ でも別チームのリーダー曰く、 向こうで作ってる機能が 今のバージョンに依存しているそうで ほなあかんやん。 あっちの機能は、目玉機能やで。 優先度が違うのよ。
38. しかし、テックリードが言うには、 バージョンアップは5日あれば いけそうなんです ほないけるやん。 バージョンアップなんて もっとかかると思ってたわ でも別チームのリーダー曰く、 向こうで作ってる機能が 今のバージョンに依存しているそうで ほなあかんやん。 あっちの機能は、目玉機能やで。 優先度が違うのよ。 でも 事業部長 が言うには、 あの機能求めてた顧客が サービス解約したので、 次リリースにはいらないそうです
39. 39 しかし、テックリードが言うには、 バージョンアップは5日あれば いけそうなんです ほないけるやん。 バージョンアップなんて もっとかかると思ってたわ でも別チームのリーダー曰く、 向こうで作ってる機能が 今のバージョンに依存しているそうで ほなあかんやん。 あっちの機能は、目玉機能やで。 優先度が違うのよ。 でも 事業部長 が言うには、 あの機能求めてた顧客が サービス解約したので、 次リリースにはいらないそうです ほなもうええやん。どうなっとるねん
40. 具体から話すと 伝わらない ▰ 細かい事情から話さない ▰ 話の全体像先に提示する ▰ 「全体的には〇〇です」 ▰ 「細かくは△△や××です」 結論 具体 具体 具体 具体 具体 補 強 補 強 補 強 補 強 結論 具体 具体 具体 具体 具体
41. 抽象➡具体 「結論から話せ」 話の全体像を掴んでもらうためのFW ▰ 結論って どこからどこまで？ ▰ "全体像" を理解してもらうことが大事 41 このバグの原因は 変数の初期化漏れです 原因箇所はSelectItem クラスの180行目です 以下の条件で、 初期化ができてません
42. “抽象➡具体” の例 この前調査依頼したライブラリ、 どんな感じ？使えそう？ いくつか問題はありますが、 利用できそうです。 要件にはあっていますし、 1人月の工数が削減できます。 おお、ええやん。 問題ってなにがあるの？ 2点あります。 フレームワークのバージョンアップが必 要になります。5人日ほど必要です あと、別チームで開発中の機能が フレームワークのバージョンに 依存しているそうです。 ただ、この機能はリリース時期の 調整ができるそうです
43. 43 知識のベースライン 伝えることをサボる 説明の大原則
44. 知識のベースラインを揃える 同じ情報を持った状態で説明する 44
45. なぜベースラインを揃えるのか？ どうせ すべて は伝わらないから ▰ 伝えるためには "言語化" が必要 ▰ 言語化すると情報落ちが発生する 45
46. 情報落ち 46 Aさん Bさん
47. 情報落ち 47 Aさん Bさん 伝えたい 事象
48. 情報落ち 48 Aさん Bさん 伝えたい 事象 日本語 言語化
49. 情報落ち 49 Aさん Bさん 伝えたい 事象 日本語 言語化
50. 情報落ち 50 Aさん Bさん 伝えたい 事象 日本語 言語化 言語化した時に 情報落ち している 非可逆 かつ 完璧でない
51. 日 本 語 ピンと来ていない人へ 補足説明 51 Aさん Bさん 伝えたい 事象 英語 言語化 非可逆 どころか 怪しい
52. じゃあどうする？
53. 相手に 悟ってもらおう
54. ベースラインを揃える ▰ 認識を一致させる ▰ 同じ感想をもってもらえる状態にする → 情報落ちした部分を類推してもらう 54
55. ベースラインを揃える手段 ▰ 背景情報を伝える ▰ こういう状態で判断が必要なんです ▰ 目的を伝える ▰ こういうことをやりたいんです 55
56. 背景情報を伝えないと... ありがとう！ うーん... 機能B を先に着手するみたいやけど 機能A のほうが重要機能だから 先にやってくれる？？ チームのスケジュールを作ったので レビューお願いします！ いえ、機能B は規模が大きいのと、 実装に不安なところが多いので 先にやってしまいたのですが ...
57. 背景情報を伝えると ありがとう！理解した！ チームのスケジュールを作ったので レビューお願いします！ 重要度は 機能A の方が高いですが 機能B は実装の不確定要素があるので 機能B を先に着手します やりとりを 1回減らせた
58. 58 伝えることをサボる 知識のベースライン 説明の大原則
59. 伝え方は色々ある ▰ 口頭説明 ▰ ドキュメント化 ▰ 表 ▰ 箇条書き ▰ 図説 59 説明対象によって どれがいいかは変わる
60. 言語化時の情報落ち 60 Aさん Bさん 伝えたい 事象 日本語 言語化 必ずしも”言語化”しなくてもよい
61. 61 この図を日本語だけで伝えてみる
62. 62 • 情報を他者に伝える時は「言語化」にとる「情報落ち」が発生します • AさんがBさんに何かを伝えるとします • この時のプロセスは以下の通りです ◦ Aさんが「伝えたいこと」を思い浮かべます ◦ Aさんは「伝えたいこと」を日本語に「言語化」します ◦ Aさんは「言語化」された情報を、Bさんに伝えます • 言語化された日本語に、Aさんの伝えたいことが100%含まれているとは限りません • 言語化した時点で、伝えたいことのいくつかは漏れてしまっています
63. 63 • 情報を他者に伝える時は「言語化」にとる「情報落ち」が発生します • AさんがBさんに何かを伝えるとします • この時のプロセスは以下の通りです ◦ Aさんが「伝えたいこと」を思い浮かべます ◦ Aさんは「伝えたいこと」を日本語に「言語化」します ◦ Aさんは「言語化」された情報を、Bさんに伝えます • 言語化された日本語に、Aさんの伝えたいことが100%含まれているとは限りません • 言語化した時点で、伝えたいことのいくつかは漏れてしまっています これ見せて喋ったほうが早い
64. ドキュメントにして 説明回数を省く 3人に3回説明 64 ドキュメントを 1回作成
65. ドキュメントにして 説明回数を省く 3人に3回説明 65 ドキュメントを 1回作成 ドキュメント
66. でもドキュメントが難解だと 意味がない ▰ 結局口頭説明が必要では意味がない ▰ わかりやすいドキュメントを書く能力も必要 66
67. 報告書のテンプレート化 テンプレートにすることで ▰ どこになにがあるかわかりやすい ▰ 過不足なく情報が記載される ▰ 作り手の力量に依存しない ➡ ドキュメント作成の難易度を下げられる 67
68. PHP の RFC テンプレート 68
69. PHP の RFC テンプレート ▰ まえがきで"抽象情報"を記載 ▰ そのあと詳しい説明 69
70. PHP の RFC テンプレート ▰ まえがきで"抽象情報"を記載 ▰ そのあと詳しい説明 70 https:/ /speakerdeck.com/ykanoh/how-to-read-php-rfc
71. ドキュメントを作る暇がない 71
72. ドキュメントを作る暇がない 72 ドキュメントを作らないから 時間がないんだよ ▰ 木こりと斧の話を知らんのか
73. ドキュメントを作る暇がない 考え整理と同時にアウトプット ▰ 作業の履歴をドキュメントにする ▰ 考えを整理しながらドキュメントにする ▰ このとき「他人に見てもらうこと」を意識する ▰ Slack や 口頭 のみでの共有 ダメ、ゼッタイ 73
74. 74 説明の大原則 知識のベースライン 伝えることをサボる まとめ
75. 自分が “伝えられる側” だったら？ ▰ この説明で理解できるか？ ▰ 事前情報がないと結論が変わるかも？ ▰ 言葉で伝わる？どんな図が欲しい？ 75 試されるのは『共感力』