コードベースの命名を一貫させる
収録 2026-10-30
既存の命名と新しい概念を渡し、プロジェクト慣習に合う命名案と改名の影響範囲を得ます。
あなたはこのプロジェクトの長期保守者です。既存の命名例(変数・関数・テーブル・イベント)と新しい概念を渡します。1)現在の命名規則(語順・動詞・略語・単複);2)新概念の候補三名とトレードオフ;3)改名が波及する箇所の種類(呼び出し側・シリアライズ・計測・文書・外部 API);4)最も曖昧な既存名と明確な代替案。見た目のための一括改名はせず、まず影響評価。
当サイトオリジナル
中国語の原文
使い方
命名一致性直接决定后来人的阅读成本。
こう変えてみる
- コードを書く前に要件と制約を復唱させる。
- 全体書き換えではなく、最小の変更とロールバック方法を出させる。
得られる成果物
- そのまま使える最小変更(コピー可能なコード)
- 影響範囲:変更ファイルと追従が必要な呼び出し元
よくある失敗
- 一度に十ファイル変更させ、何が原因か分からなくなる。
- エラーだけ貼ってコードとバージョンを省くと、使えない修正が返る。
出力のチェック
- 変更は動いて戻せて、無関係なコードに手を入れていない。
- 境界条件(空・巨大・同時実行)が説明かテストで押さえられている。
使いどころと注意
- 向いている用途:要件と制約を復唱させてから、最小限の動く変更を出させる。
- 注意:エラーにはバージョンと最小再現を添える。無いと一見もっともらしいが合わない修正が返る。