アーキテクチャ決定をADRに残す
収録 2026-10
アーキテクチャ決定をADRに残す(中国語の原文)
团队要为一个决定留下记录:[决定内容,比如数据库或消息队列的选型]。请按架构决策记录的格式写一份,包含当时的约束、考虑过的方案及各自代价、最终选择和理由,以及什么情况下应该重新评估。输出:一份可直接入库的短文档(不超过一页)、需要补充的数据、后续变更时怎么更新它。
当サイトオリジナル
中国語の原文
使用例
入力例
要为一次选型留记录:消息队列选了自建还是托管,按架构决策记录格式写一份。
出力に含まれるもの
- 含当时约束、候选方案与代价
- 最终选择与理由都要写具体
- 标出什么情况下应重新评估
置き換えるプレースホルダー 1
括弧の中をご自身の情報に置き換えてから送ってください。
[决定内容,比如数据库或消息队列的选型]
使い方
重点写被否掉的方案和原因,那是半年后最想知道的部分。
こう変えてみる
- コードを書く前に要件と制約を復唱させる。
- 全体書き換えではなく、最小の変更とロールバック方法を出させる。
得られる成果物
- そのまま使える最小変更(コピー可能なコード)
- 影響範囲:変更ファイルと追従が必要な呼び出し元
よくある失敗
- 一度に十ファイル変更させ、何が原因か分からなくなる。
- エラーだけ貼ってコードとバージョンを省くと、使えない修正が返る。
出力のチェック
- 変更は動いて戻せて、無関係なコードに手を入れていない。
- 境界条件(空・巨大・同時実行)が説明かテストで押さえられている。
使いどころと注意
- 向いている用途:要件と制約を復唱させてから、最小限の動く変更を出させる。
- 注意:エラーにはバージョンと最小再現を添える。無いと一見もっともらしいが合わない修正が返る。