【セーフィー】テクニカルライティング&コミュニケーション実践講座（26新卒エンジニア向け研修資料）

セーフィー株式会社で26新卒エンジニア向け研修のとしておこなった「テクニカルライティング&コミュニケーション実践講座」の資料です。

Transcript

1. 2026/04/21 セーフィー株式会社 開発本部 【26新卒研修】 テクニカルライティング & コミュニケーション実践講座
2. 2 © Safie Inc.｜ ⽬的とゴール
3. 3 © Safie Inc.｜ ⽬的 ゴール 全体研修の学びを開発現場の具体的な 状況に落とし込んで実践する 開発現場におけるコミュニケーション コストを最⼩化するための「型」を習得 完璧な答えを出す評価の場ではありません。 技術的な内容を相⼿が判断できる型を⼀緒に作 り、明⽇から再現できるようにする時間です！ Slackでの質問が「最⼩限の往復で回答 が得られる」状態になる ドキュメントが「第三者に正確‧簡潔‧ 明瞭に伝わり、判断できる」粒度になる 研修後も使い続けるテンプレートとして ルールを共通⾔語化する • • ✔ ✔ ✔ 研修の⽬的とゴール
4. 4 © Safie Inc.｜ なぜエンジニアが⽂章作成（⽂章⼒） を学ぶのか？
5. 5 © Safie Inc.｜ コミュニケーションの第⼀歩 コミュニケーションの負債 ⾃分の仕事を⾃分の⾔葉で論理的に「伝える」ことが、 チーム開発におけるコミュニケーションの基本 明⽇から学びを実践することで、プロフェッショナルと しての⼟台をしっかりと固めましょう！ 意図が伝わらない質問やドキュメントは「コミュニケー ションの負債」となり、チームの⽣産性を奪う 読みにくいコードが「技術的負債」になるのと同じ • • • • なぜエンジニアが⽂章作成を学ぶのか？
6. 6 © Safie Inc.｜ 全体研修の振り返りクイズ！
7. 7 © Safie Inc.｜ テスト環境で画⾯が真っ⽩に 先輩に報告する際、「事実」だけを正しく伝えているのはどっち？ ログイン画⾯が完全に壊れています。多分、昨⽇マージされたAPIの修正がおかしい んだと思います。 ログイン画⾯にアクセスすると真っ⽩になります。コンソールを確認すると、/login APIから 500 Error が返ってきています。 Q1. 事実と意⾒の分離 ※ 本資料に記載されている事例は、学習のための架空のケーススタディです ❷ ❶
8. 8 © Safie Inc.｜ 正解と解説 正解： ❶ の「完全に壊れている」は個⼈の主観（感想）、「おかしい」は推測（意⾒） ⾃分の⽬で⾒た画⾯の挙動と、エラーログ（証拠）という揺るぎない事実をまず提⽰ ⾃分の仮説（意⾒）を伝えるのは、事実を伝えた後におこなう ✔ ✔ ✔ Q1. 事実と意⾒の分離（解説） ❷
9. 9 © Safie Inc.｜ 開発で詰まり、Slackで先輩に相談したい PREP法に沿っているのはどっち？ お疲れさまです。昨⽇からチケット#123の画像アップロード機能を実装していて、公 式ドキュメントを読んでAのやり⽅を試したんですが上⼿くいかず、次にBのライブラ リを⼊れてみたんですが謎のエラーが出てしまって…。これ、どうすればいいでしょ うか？ お疲れさまです。チケット#123の画像アップロード機能でエラーが解消できず、15分 ほどMeetで相談させていただけないでしょうか？ 現在〇〇のエラーが出ており、Aと Bの⼿法を試しましたが解決していません。 Q2. PREP法（結論ファースト） ※ 本資料に記載されている事例は、学習のための架空のケーススタディです ❷ ❶
10. 10 © Safie Inc.｜ 正解と解説 正解： ❶ のような書き⽅は「⽇記（ポエム）」。最後まで読まないと⽬的が分からない 常に「相⼿に何をしてほしいのか」を1⾏⽬に書くことを徹底する ⽬的が明確であれば、先輩もアクションを即決できる ✔ ✔ ✔ Q2. PREP法（結論ファースト）（解説） ❷
11. 11 © Safie Inc.｜ みんなが使っているテスト⽤DBのデータを消してしまった 誤って⾃分の操作で消去した場合、正しいアクションはどっち？ 怒られるかもしれないし、まずは⾃分で復旧⽅法を調べ、30分経っても直せなかった ら報告する。 直し⽅は分からないが、今すぐ「すみません、テスト⽤DBのデータを消してしまい ました」とチームに報告する。 Q3. バッドニュース‧ファースト ※ 本資料に記載されている事例は、学習のための架空のケーススタディです ❷ ❶
12. 12 © Safie Inc.｜ 正解と解説 正解： 現場では「壊したことを⼀⼈で抱え込んで時間が経過すること」の⽅が何倍も重罪 1秒でも早く悪い情報を共有することが、被害を最⼩限に⾷い⽌めるプロの報連相！ ✔ ✔ Q3. バッドニュース‧ファースト（解説） ❷
13. 13 © Safie Inc.｜ 情報を整理し説得⼒を⾼める 「⽬的」を意識し、「筋道」を⽴てることで、「適切な 結論」を導き出す思考法 ⾃分と相⼿の「⽬的」と「前提」のすり合わせが重要 CRF法（結論、根拠、事実） ピラミッド構造で情報を整理することで説得⼒を⾼める • • • 振り返りポイント：ロジカルシンキング 事実、認識、意⾒を使い分ける •
14. 14 © Safie Inc.｜ 事実と意⾒‧PREP法 配慮とスピード 「事実（客観）」と「意⾒（主観）」を分けて話す 情報伝達は、PREP法で簡潔に⾏う バッドニュース‧ファースト： 悪い情報ほど早く正確に報告‧相談する 配慮の⼀⾔で始まり、感謝の⼀⾔で終わることを⼼がける • • • • 振り返りポイント：報連相 結論 → 根拠 → 具体例 →結論
15. 15 © Safie Inc.｜ 実践ワーク
16. 16 © Safie Inc.｜ ダメな質問を修正し、型をつくる 💡Point 先輩エンジニアが⼀番困る「丸投げ‧情 報ゼロの質問」はついやってしまいがち ×「〇〇さん、うまく動きません」 ×「ドキュメント通りやったはずなんですが...」 ダメな理由が分かれば、より良くする ⽅法もおのずと⾒えてくる 全体研修の知識を、すぐに使える実践的 な事例で深める ただの座学（⼀般論）ではなく、今から ⾃分たちが書くドキュメントやSlackの メッセージの基礎をつくる 「型」を使いこなし、研修中に磨き合い ながら、みんなでスキルを⾼める • • ✔ ✔ ✔ ※ 本資料に記載されている事例は、学習のための架空のケーススタディです 今⽇やること エンジニア業務でよくある『ダメな質 問』の修正をしながら、実践的な「型」 を作っていきましょう！ •
17. 17 © Safie Inc.｜ 個⼈ワーク（12分） グループワーク（25分） まとめ（23分） ダメな⽂章の事例を提⽰ ⽂章の改善点を整理し、 書き直してみる 改善点と書き直した⽂章 を1⼈ずつ共有する 他のメンバーから、その ⽂章の良い点、さらなる 改善ポイントをフィード バックし合う ポイントの解説‧講義 グループでの最終的な回 答（改善案）と型を1つに まとめる 全体共有、まとめ • • • • • • • 全体の進め⽅ ▶ ▶ この流れを2つのケースで実践していく
18. 18 © Safie Inc.｜ はじめの⽂章 ワークタスク 👤 セーフィー太郎 15:35 お疲れさまです！ ちょっと詰まっていて相談です🙏 今テスト環境で検索機能が急に動かなくなりました。 画⾯上は「エラーが発⽣しました」という表⽰になって、結果が 返ってきません。 昨⽇の修正の影響かもしれないと推測してるんですが（⾃分は 触っていません）、コンソールで500エラーが出ているため、DB かAPI落ちを疑っています。 リロードしましたが変化なしです。 どこを⾒ればいいか、誰かわかる⼈がいたら教えてください！ この丸投げ質問の改善点を整 理しましょう PREP法、事実と意⾒の分離を 意識してください 先輩がすぐに状況を把握し、 アクションができる「型」を 考えて書き直してください ✔ ✔ ✔ ケース1：チャット質問‧相談の改善 ※ 本資料に記載されている事例は、学習のための架空のケーススタディです
19. 19 © Safie Inc.｜ ワークタスク 事実確認が不⼗分で、推測ば かりのIssueです 開発者が再現‧調査に必要な 情報を過不⾜なく伝える構成 に書き直してください ✔ ✔ ケース2：ドキュメント (Issue) の改善 ※ 本資料に記載されている事例は、学習のための架空のケーススタディです ダッシュボードが真っ⽩になる件（原因調査お願いします） 昨⽇くらいからダッシュボード画⾯が真っ⽩になる事象が出て いる気がします。 ⾃分でも⼀度再現していて、ユーザーからも同じような問い合 わせが来ているので、何か壊れている可能性があります。 たぶんフロント側だと思いますが、APIエラーかもしれません。 キャッシュを消したら直ったのでキャッシュ周りが怪しいで す。ただ毎回起きるわけではなく、たまに起きるので条件がよく 分からないです。 コンソールでエラーっぽいのが出た気がします。 ユーザーが困っているので優先度⾼めで⾒てもらえると助かりま す。 はじめの⽂章
20. 20 © Safie Inc.｜ 今⽇作ったテンプレートは、明⽇から「チームの共通ルール」にしましょう！ テンプレートに合っていないやりとりは、お互いに指摘し合いましょう 例：情報が不⾜しています。環境‧⼿順‧ログ等をテンプレに沿って追記してもらえますか？ 配慮と感謝を常に忘れずに！ “困っている”状況を受け⽌め、型に沿って⼀緒に情報を整理しましょう 例外 緊急度が⾼い障害などは⽕消しを優先し、あとでやりとりを振り返りましょう ✔ ✔ ✔ ※ まとめ 円滑なコミュニケーションで、⾼め合えるチームを作ろう！
22. 22 © Safie Inc.｜ ご清聴ありがとうございました Thank you!