AIで業務ツールを作るならGitHubを先に覚える:変更履歴とレビューの基本


AIで業務ツールを作るならGitHubを先に覚える:変更履歴とレビューの基本

AIにコードを書いてもらうこと自体は、以前よりずっと身近になりました。問い合わせ管理、社内メモ、在庫確認、簡単なWebページ修正なら、CodexのようなAIコーディングエージェントに頼める場面も増えています。

ただし、ここで見落とされやすいのが変更履歴です。

AIが速く直せるほど、意図しない変更も速く入ります。昨日まで動いていた画面が崩れる。別のファイルまで変わる。元に戻したいのに、どこから壊れたか分からない。こうなると、AIで短縮した時間を復旧作業で失います。

だから、AIで業務ツールを作るなら、先にGitとGitHubの最低限を押さえるべきです。開発者っぽい言葉を全部覚える必要はありません。小さな会社がまず覚えるべきなのは、「戻せる」「共有できる」「公開前に見られる」状態を作ることです。

Gitは作業履歴、GitHubは共有とレビューの場所

Gitは、ファイルの変更履歴を管理する仕組みです。公式のGit Bookでも、バージョン管理はファイルの変更を記録し、あとから特定の状態に戻せる仕組みとして説明されています。

中小企業の実務に置き換えると、Gitは「業務ツールの作業履歴」です。

  • いつ、どのファイルを変えたか
  • 何のために変えたか
  • 以前の状態と何が違うか
  • 問題が起きたとき、どこへ戻すか

これを残すための仕組みがGitです。

GitHubは、そのGitの履歴をクラウド上で保管し、共有、レビュー、議論、公開前チェックをしやすくする場所です。GitHub公式ドキュメントでも、GitHubはGitリポジトリをホストし、pull requestやコードレビューなどの機能を提供すると説明されています。

つまり、かなり単純化すると次のように考えられます。

役割何をするものか中小企業での意味
Git変更履歴を残す壊れたときに戻れる
GitHub履歴をクラウドで共有する他の人やAIが確認できる
Pull request変更を本番側へ入れる前に見せる公開前レビューの箱

「GitHubは難しいから後でいい」と考えると、AIコーディングは危なくなります。むしろ、AIに直してもらうからこそ、GitHubで差分を見られる状態が必要です。

最初に覚える用語はこの5つでよい

最初から細かいコマンドを暗記しなくても構いません。まずは次の5つを、業務フローとして覚える方が実用的です。

用語ざっくりした意味AI開発での使いどころ
branch作業場所を分ける本番に影響させず試す
commit変更の記録を残す戻れる区切りを作る
pushGitHubへ送るローカルPCだけに閉じない
pull request変更を取り込む前に見せる人間が差分を確認する
pullGitHub側の最新を取り込む手元の作業を古くしない

特に重要なのは、branchとcommitです。

GitHub公式ドキュメントでは、branchは他のbranchに影響させず作業するための分離された場所として説明されています。AIに修正を頼むときも、いきなりmain branchを触らせるのではなく、作業用branchで試す方が安全です。

commitは、作業の区切りです。ひとつの機能を直した、文言を変更した、エラーを修正した。そうした単位でcommitを残しておくと、あとから差分を見やすくなります。

AIに頼むときも、「作業後に差分を説明して、問題なければcommit候補を作って」と依頼すると、人間が確認しやすくなります。

AIコーディングで壊れやすいのは、コードではなく運用

AIコーディングでよく起きる失敗は、「AIがコードを書けない」ことではありません。むしろ、動くものは意外と速く出てきます。

問題になりやすいのは、次のような運用です。

  • 何を変えたか記録していない
  • 作業前にbranchを切っていない
  • commitが大きすぎてレビューできない
  • pushしておらず、PC内だけに履歴がある
  • pull requestを作らず、そのまま本番反映してしまう
  • conflictが出たとき、AI任せで判断してしまう

GitHub公式ドキュメントでは、pull requestは変更を提案し、reviewして、mergeするための機能として説明されています。AIが作った変更も同じです。AIが書いたから特別扱いするのではなく、人間が差分を見てから取り込む流れに乗せます。

conflictも怖がりすぎる必要はありません。GitHub公式ドキュメントでは、merge conflictは競合するcommitがあり、Gitがどちらの変更を採用するか判断を必要とする状態として説明されています。つまり、conflictは「壊れた」というより、「人間の判断が必要」という合図です。

小さな会社では、この合図を無視しないことが大切です。

小さな会社の最低限フロー

AIで業務ツールを直すときは、まず次の流れで十分です。

  1. 作業前にGitHubへ最新状態をpushしておく
  2. 修正用のbranchを作る
  3. AIに、変更してよい範囲を明確に伝える
  4. AIが作業したら、差分を確認する
  5. 小さな単位でcommitする
  6. GitHubへpushする
  7. pull requestを作る
  8. 人間が表示、文言、機能、秘密情報の混入を確認する
  9. 問題がなければmainへ取り込む

この流れにすると、AIは「勝手に本番を変える存在」ではなく、「レビューできる変更案を作る担当」になります。

Codexの公式ドキュメントでも、ローカルで動くコーディングエージェントとしてCLIが説明され、サンドボックスや承認設定によって操作範囲を制御する考え方が示されています。AIを実行役として使うなら、Git/GitHubの履歴とあわせて、人間が止められる場所を作る必要があります。

最初から完璧な開発体制を作る必要はありません。ただし、次の3つは早めに決めておくべきです。

  • main branchを直接触らない
  • 作業ごとにbranchとcommitを分ける
  • pull requestなしで公開しない

これだけでも、AIコーディングの事故はかなり見つけやすくなります。

Optiensの見方

Optiensでは、AI導入を「ツールを入れること」ではなく、業務の判断と確認の流れを設計することとして扱っています。

AIで小さな業務ツールを作る場合も、最初に見るべきはモデル名ではありません。変更履歴、秘密情報の置き場所、レビュー担当、公開前チェック、失敗したときの戻し方です。

Git/GitHubは、非エンジニアには少し取っつきにくい道具です。それでも、AIにファイルを編集させるなら避けて通れません。むしろ、ここを覚えると、AIに任せられる仕事の幅が広がります。

AI活用をどこから始めるべきか迷っている場合は、まず AI活用診断簡易版(無料) で、既存業務のどこがAIパッケージ化しやすいかをご確認ください。より具体的に整理したい場合は、詳細版AI活用診断(¥5,500税込・MTGなし) で、AIパッケージ適合性、構成案、優先順位、費用前提を整理してお届けします。

まとめ

AIコーディングを始めるとき、最初に覚えるべきなのは高度なプログラミングではありません。

まずは、Gitで変更履歴を残す。GitHubで共有する。branchで作業場所を分ける。commitで戻れる区切りを作る。pushでクラウドへ送り、pull requestで人間が確認してから取り込む。

この基本があるだけで、AIに頼める仕事は増えます。反対に、この基本がないままAIに作業を広げると、速く作れるほど速く壊れます。

AI時代の開発入門は、コードを書く前に「戻せる状態」を作るところから始めましょう。

関連記事

参考資料

NEXT STEP

関連する考え方から確認する

まずは記事やデモ・活用例で、AI活用をどの順番で考えるかをご確認ください。必要になった段階で、簡易診断も利用できます。

診断は、記事やデモを見たうえで自社の業務に当てはめたい方向けの補助導線です。