measure-dont-guess

measure-dont-guess

実装や修正を行う前に、仮説をどちらに収束させるかを判断し、実行した上で、その結果のみで判断する。バグの原因を調査する際、パフォーマンスや行動を比較する際、新機能の開発に着手する際、そして「おそらく」と判断しようとする際に活用する。

3Star
0Fork
更新于 2026/11/21
请求的译文尚未完成,当前显示原始繁体中文。
SKILL.md
只读
名称
measure-dont-guess
描述

実装や修正を行う前に、仮説をどちらに収束させるかを判断し、実行した上で、その結果のみで判断する。バグの原因を調査する際、パフォーマンスや行動を比較する際、新機能の開発に着手する際、そして「おそらく」と判断しようとする際に活用する。

measure-dont-guess

  • 測定を行う前に、仮説とそれを受け入れる値を記述する
  • 本番環境、または本番環境と同じ条件で測定する
  • 未測定の主張が推測であることを明示する
  • 測定できない場合は推測で進めず、何が不足しているかをユーザーに伝えること

なぜこのスキルが必要なのか、そしてどのような状態を実現すべきか

推測は測定よりも早く答えを出せる上、通常は妥当に見えるため、このスキルが必要となる。推測に基づいて行った変更では、それが間違っていることに気づくための材料が残らない。

このスキルが実現すべき状態とは、あらゆる判断が誰でも再現可能な根拠に基づいていることである。

本番環境での測定

判断の根拠となる測定は、本番環境で行われる。ローカル環境とテスト環境ではデータ規模や外部サービスが異なり、本番環境とは正反対の結論に至ることがある。

  • 本番環境で測定できない場合は、ステージング環境を構築し、そこで測定を行う。
  • コード、構成、インフラストラクチャ、データの規模や形態、および外部サービスにおいて、ステージングを本番環境と同等にする。
  • ローカル環境およびテスト環境における測定は、測定メカニズムが動作することを確認するためにのみ使用する。

測定値の記録

  • 変更の根拠となる測定値については、条件、コマンド、および結果をコミットメッセージに記述する。
  • 不都合な結果が出た場合は、そのまま報告し、仮説を再検討する。

ユースケース

以下についてもすべて読んでください。

  • measure。仮説を立て、測定し、その結果に基づいて判断する。
  • find-root-cause。バグの根本原因を特定する。
  • improve-performance。パフォーマンスを向上させる。

参考文献

masseater/typescript-template で作成されたリポジトリでは、typescript-templateも併せて読んでください。その他のリポジトリでは、同様の役割を果たすものとして読んでください。