メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

コミットは、セーブ地点

その時点の作品の形を、記録として残すことをコミットと呼びます。ゲームのセーブ地点のようなものです。動いたことを確かめたら、何を変えたかを一言添えて、コミットします。

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

問い

佐藤さんの疑問

記録は、いつ、どうやって残せばいいんだろう。

しおりのひもが垂れた、閉じた厚い本の挿絵。

前の回で、佐藤さんは、作業フォルダで Git(作品の変更を記録する道具)を始め、リポジトリ(記録をためる入れ物)にしました。

入れ物ができただけでは、まだ記録は残っていません。この回では、記録の残し方を見ていきます。

コミット:その時点の形を、記録として残す

作品の、その時点の形を、記録として残すことを、コミットと呼びます。ゲームのセーブ地点のようなものです。うまくいかなくなっても、前のセーブ地点からやり直せます。

GitHub の公式の説明には、こう書かれています。

DOCUMENTATION

“Similar to saving a file that's been edited, a commit records changes to one or more files in your branch.”

書き換えたファイルを保存するのと同じように、コミットは、1つ以上のファイルに加えた変更を記録します。

GitHubAbout commits(GitHub Docs)

原文の最後の「in your branch」は、「いま作業している枝の中で」という意味です。枝(ブランチ)は、第5部の第5回で見ます。

同じ説明によると、コミットには1つずつ、ほかと重ならない番号が付き、何を変えたか、いつ変えたか、誰が変えたかが記録されます。

コミットメッセージ:何を変えたかの一言

コミットするときは、何を変えたかを短く書いた一言を添えます。これを、コミットメッセージと呼びます。あとで記録を見返したとき、この一言を手がかりに、戻りたいセーブ地点を探します。

よくない例よい例
修正あすの目安の表の字を大きくした
いろいろ変更「あすは雨」の印を足し、雨の日は目安を1割減らした
あああスマホの幅で表の見出しが折り返さないようにした

この表の例は、説明のための架空の例です。

「修正」だけでは、何を直したのか、あとから分かりません。何を、どう変えたかが分かる一言にします。日本語で書いてかまいません。

コミットは、メッセージ付きのセーブ地点

佐藤さんの記録(例)

最初の画面を作った 表の字を大きくした 「あすは雨」の印を足した 古い 新しい いまの形 最初の画面を作った 表の字を大きくした 「あすは雨」の印を足した 古い 新しい・いまの形
図1何を変えたかが分かる一言なら、あとで戻りたい地点を探せます。

いつコミットするか

コミットするのは、動いたことを確かめたときです。第4部の第7回で見たように、画面を開いて、「使う」の場面を触って確かめてから、コミットします。

初めてコミットする前には、記録に入れないものの一覧(.gitignore、ギット・イグノア)も、Claude に作っておいてもらうと安心です。何を書くかは、第5部の第10回で見ます。

佐藤さんは、表の字を大きくしてもらい、画面で確かめたあと、こう頼みました。

コミットを頼む例
表の字を大きくした変更を、画面で確かめました。ここまでをコミットしてください。コミットメッセージは日本語で、何をどう変えたかが分かる一言にしてください。コミットしたら、記録に残ったファイルの名前と、コミットメッセージを見せてください。

この依頼文は、説明のための架空の例です。

Claude が、コミットの前に許可を求めてきたら(第4部の第2回で見た許可の確認)、何をしようとしているかを読んでから、許可します。

記録を見返す

ためた記録は、Claude に頼めば、一覧で見られます。

記録を見返す例
これまでのコミットの一覧を、新しい順に、日時とコミットメッセージで見せてください。

コミットメッセージが分かりやすければ、この一覧から、戻りたいセーブ地点を見つけられます。戻り方は、次の回で見ます。

コミットは、その時点の形を残すセーブ地点です。動いたことを確かめてから、何を変えたかの一言を添えて残します。

注意

ただし、まとめて1回にしない

1日の作業を、夜にまとめて1回だけコミットすると、戻るときに、その日の朝まで戻るしかなくなります。

1つ直して、確かめて、コミット。第4部の第8回で見た「1つずつ直す」と同じ歩幅で、小さく、こまめに残すと、戻りたいところに、ちょうど戻れます。

次回の問い

佐藤さんの次の疑問です。うまくいかなくなったとき、前のセーブ地点には、どうやって戻ればよいのでしょうか。

参考

コミットについて(GitHub Docs)
コミットとコミットメッセージの、GitHub の公式の説明。日本語。
GitHub Docs · docs.github.com
Vibe Coding 用語集:コミット
コミットの説明と、頼み方の例。
AMPL · Web

このレッスンは役に立ちましたか?