第7章:“分からない”の表明と相談の型(何が分からないかを切る)
この章で学ぶこと
- “分からない”を分解する(何が不明/どこまで確認済み)
- 相談に必要な材料(再現/ログ/仮説)を揃える
- 次の一手を具体化する
成果物(または判断基準)
- 相談用メッセージ(付録: “分からない”表明テンプレ)
- 不足情報のリスト(権限/再現環境/ログ等)
本文
相談の品質は“相手の思考コスト”で決まる。状況・試行・不足情報を揃えることで、往復回数を減らす。
手順(最小)
- 目的(何を決めたいか)と期限/影響範囲を明確にする
- 状況(何が起きているか)を、対象バージョンと環境情報つきで要約する
- 試行(何を試したか)と結果(観測ログ/否定結果)を列挙する
- 未確定点(何が分からないか)と仮説を切り分ける
- 依頼事項(何が欲しいか)を具体化し、次の一手を合意する
相談の最小構成
- 目的: 何を決めたいか
- 状況: 何が起きているか
- 試行: 何を試したか(結果含む)
- 仮説: 何が怪しいか
- 依頼: 何が欲しいか(レビュー/権限/知見)
注意点
- 状況説明が長文化する場合は、調査ログ/再現ログを添付し、本文は要点(目的/未確定/依頼)に絞る
- ログや設定を共有する場合は、秘密情報/個人情報をマスキングする
具体例(悪い例→良い例)
悪い例
分かりません。助けてください。
状況や試したことが書かれていない
良い例
目的: タイムアウト設定のデフォルト値を確定したい
状況: v2.3 で挙動が変わった可能性
試行: 公式ドキュメント/実装/最小再現(結果は10秒)
未確定: 例外条件(接続確立前/後)
依頼: 仕様節の解釈レビュー(この理解で妥当か)
チェックリスト
- 目的が明記されている
- 試行と結果が書かれている
- 未確定点が分離されている
- 依頼事項が具体的である
まとめ
- “分からない”を分解し、目的・状況・試行・未確定・依頼事項を整理して相談する
- 不足情報(権限/再現環境/ログ)を明示し、次アクションを合意する
次章への接続
- 付録: テンプレ集