コミット&プッシュ

ファイルをステージし、手動または AI エージェントでコミットメッセージを書き、数クリックでリモートにプッシュします。

差分をレビューし、AI エージェントによる変更に問題がなければ、コミットとプッシュに進みましょう。このガイドでは、ステージングからリモートリポジトリへのプッシュまでの一連のワークフローを説明します。

変更をステージする

ステージングを使うと、今回のコミットに含める変更を正確に選べます。たとえば、機能のコードと設定の変更を別々にコミットしたい場合に便利です。

Git パネルでは、変更されたすべてのファイルが Unstaged Changes セクションに表示されます。

  • ファイル横のチェックボックスをオンにすると、そのファイルを個別にステージできます
  • Stage All をクリックすると、変更されたすべてのファイルを一度にステージできます
  • ステージを解除するには、チェックボックスをオフにします。ファイルは Unstaged に戻ります

ステージされたファイルは、サイドバー上部の Staged Changes セクションに移動します。コミットに含まれるのは、ステージされたファイルだけです。

ファイル全体ではなく、個別のハンク(ファイル内の一部分)だけをステージすることもできます。差分ビューでハンクにカーソルを合わせ、表示される + ボタンをクリックすると、そのセクションだけがステージされます。1 つのファイルに無関係な変更が 2 つあり、そのうち片方だけを今コミットしたい場合に役立ちます。

変更をフォルダツリーで表示する

エージェントが生成する差分は、幅広く浅くなりがちです。4 つのディレクトリにまたがる 18 ファイルの変更も珍しくありません。フラットなリストでは、ほとんど同じようなパスが 18 行並ぶだけになってしまいます。

Filter ボックスの横にあるトグルで、Changes リストをフラットリストと VS Code スタイルのフォルダツリーに切り替えられます。選択内容は、次にダイアログを開いたときにも引き継がれます。

フォルダツリーモードの Git Changes ダイアログ。変更された 18 ファイルが scripts、src/main/database/adapters、renderer/components の下にネストされ、各ディレクトリ行にフォルダ単位のステージ用チェックボックスが表示されている

  • フォルダのチェックボックスで、その配下すべてを一度にステージ/ステージ解除できます。 そのため、領域ごとにレビューすることと、領域ごとにステージすることが同じ操作になります。
  • フォルダ上のダッシュは、一部だけがステージされていることを示します。 部分的なステージは意図せず発生しやすく、フラットなリストではほぼ気づけません。3 状態のチェックボックスが、ディレクトリ単位でそれを可視化します。
  • すべて折りたたみ/すべて展開で、多数のディレクトリにまたがる変更セットも扱いやすくなります。

フラットリストは従来どおりで、各行にフルパスが表示されます。変更セットが小さく、グループ化がかえって手間になる場合に向いています。

コミットメッセージを書く

ファイルをステージしたら、Git パネル下部のテキストフィールドにコミットメッセージを入力します。

よいコミットメッセージは、将来の自分やプロジェクトの他のメンバーにとって履歴を読みやすくしてくれます。いくつかのコツを紹介します。

  • 命令形で書く — 「Added login form」や「Adding login form」ではなく「Add login form」と書きます
  • 何を、なぜ変更したかを書く — 「fix bug」よりも「Fix null check in user.ts」のほうが役に立ちます
  • 1 行目は 72 文字以内に収める — 多くの Git ツールは、一覧表示で長いメッセージを切り詰めます
  • 必要に応じて本文を追加する — 1 行目の後に Enter を 2 回押すと、その下に詳しい説明を書けます

わかりやすいコミットメッセージの例:

  • Add email validation to signup form
  • Fix crash when user list is empty
  • Update API base URL for production

エージェントに書いてもらう

コミットサマリーにあるスパークルボタンを押すと、差分がインストール済みの AI CLI に渡され、メッセージが生成されます。

  • メッセージを書くエージェントを固定することも、インストール済みの最初のエージェントを 1DevTool に任せることもできます。Kimi Code も他のエージェントと並んで一覧に表示されます。多数のエージェントをインストールしている場合、メニューはウィンドウに収まるサイズになり、スクロールできます。
  • スタイルを Conventional、Plain、Gitmoji から選べます。
  • まだ何もステージしていない場合は、作業ツリーの差分が使われます。そのため、何をステージするか決める前にメッセージを得ることもできます。

生成結果は、通常の編集可能なテキストとしてメッセージフィールドに入ります。これは下書きであり、コミットではありません。

コミットする

メッセージフィールドの下にある Commit ボタンをクリックします。ステージされた変更が新しいコミットとしてローカルの Git 履歴に保存され、ステージ済みファイルのセクションは空になります。

コミットはブランチの履歴に表示されます。取り消したい場合は、履歴ビューでそのコミットを右クリックし、Undo Commit を選択します。変更内容は失われることなく、未ステージのファイルに戻ります。

リモートにプッシュする

コミットはローカルに変更を保存するだけです。GitHub、GitLab、その他のリモートに送るには、次の手順を行います。

  1. Git パネルのツールバーにある Push ボタン(上向き矢印のアイコン)をクリックします
  2. ブランチがすでにリモートに存在する場合は、コミットがすぐにプッシュされます
  3. リモートにまだ存在しない新しいブランチの場合は、Publish Branch をクリックします。リモートにブランチが作成され、コミットがプッシュされます

認証情報を求められた場合は、入力するか、SSH キー認証に切り替えることができます。GitHub アカウントを接続して認証情報を自動的に処理する方法については、Git アカウントをご覧ください。

新しいブランチをプッシュする Git

変更をプルする

リモートの変更(たとえば、チームメイトがプッシュした内容)を取り込むには:

  1. ツールバーの Pull ボタン(下向き矢印のアイコン)をクリックします
  2. リモートの変更が取得され、ローカルブランチにマージされます

マージコンフリクトが発生した場合、Git パネルが競合しているファイルをハイライトします。各ファイルを開いてコンフリクトを解消し、その解消内容をステージしてコミットしてください。

Git を追加するクイックボタン

プッシュが完了すると、変更はリモートに反映され、チームで共有したり、プルリクエストを作成したりできる状態になります。Git パネルには、ブランチがリモートと同期していることが表示されます。