字を大きくした売れ残り帳を、佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、画面で確かめました。うまくいっています。この形を、いまのうちに残しておきたい。
問い
佐藤さんの疑問
記録は、いつ、どうやって残せばいいんだろう。

前の回で、佐藤さんは、作業フォルダで Git(作品の変更を記録する道具)を始め、リポジトリ(記録をためる入れ物)にしました。
入れ物ができただけでは、まだ記録は残っていません。この回では、記録の残し方を見ていきます。
コミット:その時点の形を、記録として残す
作品の、その時点の形を、記録として残すことを、コミットと呼びます。ゲームのセーブ地点のようなものです。うまくいかなくなっても、前のセーブ地点からやり直せます。
GitHub の公式の説明には、こう書かれています。
“Similar to saving a file that's been edited, a commit records changes to one or more files in your branch.”
書き換えたファイルを保存するのと同じように、コミットは、1つ以上のファイルに加えた変更を記録します。
原文の最後の「in your branch」は、「いま作業している枝の中で」という意味です。枝(ブランチ)は、第5部の第5回で見ます。
同じ説明によると、コミットには1つずつ、ほかと重ならない番号が付き、何を変えたか、いつ変えたか、誰が変えたかが記録されます。
コミットメッセージ:何を変えたかの一言
コミットするときは、何を変えたかを短く書いた一言を添えます。これを、コミットメッセージと呼びます。あとで記録を見返したとき、この一言を手がかりに、戻りたいセーブ地点を探します。
| よくない例 | よい例 |
|---|---|
| 修正 | あすの目安の表の字を大きくした |
| いろいろ変更 | 「あすは雨」の印を足し、雨の日は目安を1割減らした |
| あああ | スマホの幅で表の見出しが折り返さないようにした |
この表の例は、説明のための架空の例です。
「修正」だけでは、何を直したのか、あとから分かりません。何を、どう変えたかが分かる一言にします。日本語で書いてかまいません。
コミットは、
佐藤さんの
いつコミットするか
コミットするのは、動いたことを確かめたときです。第4部の第7回で見たように、画面を開いて、「使う」の場面を触って確かめてから、コミットします。
初めてコミットする前には、記録に入れないものの一覧(.gitignore、ギット・イグノア)も、Claude に作っておいてもらうと安心です。何を書くかは、第5部の第10回で見ます。
佐藤さんは、表の字を大きくしてもらい、画面で確かめたあと、こう頼みました。
表の字を大きくした変更を、画面で確かめました。ここまでをコミットしてください。コミットメッセージは日本語で、何をどう変えたかが分かる一言にしてください。コミットしたら、記録に残ったファイルの名前と、コミットメッセージを見せてください。この依頼文は、説明のための架空の例です。
Claude が、コミットの前に許可を求めてきたら(第4部の第2回で見た許可の確認)、何をしようとしているかを読んでから、許可します。
記録を見返す
ためた記録は、Claude に頼めば、一覧で見られます。
コミットメッセージが分かりやすければ、この一覧から、戻りたいセーブ地点を見つけられます。戻り方は、次の回で見ます。
コミットは、その時点の形を残すセーブ地点です。動いたことを確かめてから、何を変えたかの一言を添えて残します。
注意
ただし、まとめて1回にしない
1日の作業を、夜にまとめて1回だけコミットすると、戻るときに、その日の朝まで戻るしかなくなります。
1つ直して、確かめて、コミット。第4部の第8回で見た「1つずつ直す」と同じ歩幅で、小さく、こまめに残すと、戻りたいところに、ちょうど戻れます。
次回の問い
佐藤さんの次の疑問です。うまくいかなくなったとき、前のセーブ地点には、どうやって戻ればよいのでしょうか。