AI Engineering Tools

プログラミング

Git/GitHub 作業用語

リポジトリ、ブランチ、コミット、同期、PR、競合、安全操作を理解するための用語集です。

33

基本概念

リポジトリ

Repository

engineerdoge/math-ai-tools

意味

Gitによって追跡されるプロジェクトフォルダで、通常はGitHubにミラーリングされています。

使い方

プロジェクトの確認、作業のコミット、またはブランチの比較を行う場合、対象となるのはリポジトリです。

engineerdoge/math-ai-tools

依頼例

現在のリポジトリの状態を確認します。

基本概念

作業ツリー

Working tree

git status

意味

現在、マシンにチェックアウトされているファイル。まだコミットされていない編集も含まれます。

使い方

コミットされた履歴と、現在進行中の変更を区別するために使用します。

git status

依頼例

作業ツリーで行われた変更内容を表示します。

基本概念

ステージング領域

Staging area

git add src/components/SiteHeader.tsx

意味

次のコミットに含まれる変更の一時的な選択。

使い方

関連するファイルまたはチャンクのみをコミットできます。

注意

ステージングは、それ自体では履歴を保存しません。コミットがそれを記録します。

git add src/components/SiteHeader.tsx

依頼例

Gitの用語のページ用のファイルのみをステージします。

基本概念

コミット

Commit

git commit -m "Add Git terms reference"

意味

リポジトリの履歴における選択された変更の保存されたスナップショット。

使い方

コミットにより、後で変更をレビュー、比較、デプロイ、またはロールバックできます。

git commit -m "Add Git terms reference"

依頼例

簡潔なメッセージを含むコミットを作成します。

基本概念

Diff

Diff

git diff

意味

2つのファイルの状態の違いを1行ずつ表示するビュー。

使い方

Diffは、コミットする前に、編集が実際に何を行ったかを正確に確認する最速の方法です。

git diff

依頼例

予期しない変更の差分をレビューします。

ブランチ

ブランチ

Branch

qwen3.5

意味

他の作業ラインとは別に移動できる名前付きの作業ライン。

使い方

ブランチを使用すると、メインの変更をすぐに適用せずに、機能を開発できます。

qwen3.5

依頼例

現在、どのブランチにいるか教えてください。

ブランチ

main ブランチ

main branch

main

意味

通常、安定した、または本番環境で利用可能なバージョンを表すデフォルトのブランチ。

使い方

作業中のブランチとmainブランチを比較して、変更点を確認する。

main

依頼例

このブランチをmainブランチと比較する。

ブランチ

チェックアウト

checkout

git switch qwen3.5

意味

作業ツリーを別のブランチまたはコミットに変更します。

使い方

別のブランチを検査したり、作業を継続したりする必要がある場合に利用します。

注意

未コミットの変更は、上書きされる可能性がある場合、ブランチの切り替えを妨げる可能性があります。

git switch qwen3.5

依頼例

未コミットの変更がないか確認した後、qwen3.5 ブランチに切り替えてください。

ブランチ

merge

merge

git merge main

意味

1つのブランチからの変更を別のブランチに統合します。

使い方

メインの更新を機能ブランチに取り込んだり、機能をメインブランチに統合したりする場合に、mergeを使用します。

注意

マージは、両方のブランチが同じ行を異なる方法で編集した場合に、競合を引き起こす可能性があります。

git merge main

依頼例

`main`ブランチをこのブランチにマージする前に何が起こるかを説明してください。

ブランチ

rebase

rebase

git rebase main

意味

別のブランチのコミットを、別のベースコミットの上に適用します。

使い方

機能ブランチをマージする前に、履歴が直線的に見えることがあります。

注意

リベースはコミット履歴を書き換えるため、共有ブランチでは注意して使用する必要があります。

git rebase main

依頼例

まだリベースしないでください。まず、このブランチのリスクを説明してください。

同期

クローン

clone

git clone https://github.com/user/project.git

意味

リモートリポジトリのローカルコピーを作成します。

使い方

既存のGitHubプロジェクトでの作業を開始する際の最初のステップであることがよくあります。

git clone https://github.com/user/project.git

依頼例

このリポジトリをクローンし、利用可能なブランチを表示します。

同期

remote

remote

origin git@github.com:user/project.git

意味

ローカルリポジトリから、別の場所にホストされているリポジトリへの名前付き接続。

使い方

リモート設定は、プルとプッシュが通信する場所を決定します。

origin git@github.com:user/project.git

依頼例

設定されているリモートを表示します。

同期

取得

fetch

git fetch origin

意味

作業ファイルを変更せずに、リモートブランチ情報をダウンロードします。

使い方

ブランチを最新のリモートの状態と比較する前に、fetchを使用します。

git fetch origin

依頼例

オリジンから取得し、次にこのブランチをメインブランチと比較する。

同期

pull

pull

git pull origin main

意味

リモートの変更を取得し、現在のブランチに適用します。

使い方

ローカルブランチを、他の場所でプッシュされた作業で更新するために使用します。

注意

プルは、作業ブランチを変更する可能性があり、競合が発生する可能性があります。

git pull origin main

依頼例

取得する前に、ローカルで未コミットの変更があるかどうかを確認してください。

同期

push

push

git push origin qwen3.5

意味

ローカルのコミットをリモートリポジトリにアップロードします。

使い方

プッシュは、ローカルのコミットを GitHub または別のリモートに公開します。

注意

プッシュは、コミットのみをアップロードし、コミットされていない作業ツリーの変更は含まれません。

git push origin qwen3.5

依頼例

ビルドが成功することを確認した後、現在のブランチをプッシュします。

同期

origin

origin

git push origin qwen3.5

意味

クローンしたリモートリポジトリのデフォルト名。

使い方

ほとんどの push、pull、および fetch の例では、origin がリモート名として使用されます。

git push origin qwen3.5

依頼例

originが、期待されるGitHubリポジトリを指しているかどうかを確認します。

レビュー

プルリクエスト

Pull Request

qwen3.5からPRを開き、メインに統合します。

意味

ブランチの変更を議論し、マージするためのGitHubのレビューページ。

使い方

変更されたファイルをレビューし、チェックを実行し、コメントを議論し、安全にマージするために、PRを使用します。

qwen3.5からPRを開き、メインに統合します。

依頼例

PR の説明に含めるべき内容を要約してください。

レビュー

レビュー

Review

要求された変更をレビューします。

意味

コードの変更について、バグ、回帰、可読性、およびテストの欠落がないか確認します。

使い方

レビューは、ブランチを共有コードベースにマージする前に、問題を特定するのに役立ちます。

要求された変更をレビューします。

依頼例

このブランチを、バグやテストの欠落がないかレビューします。

競合

マージの競合

Merge conflict

CONFLICT (content): src/app/page.tsx ファイルの競合

意味

Gitが異なるブランチからの変更を自動的にマージできない状況。

使い方

マージを継続するには、正しい最終コンテンツを選択する必要があります。

注意

一方の意見を盲目的に受け入れることはしないでください。まず、意図された動作を確認してください。

CONFLICT (content): src/app/page.tsx ファイルの競合

依頼例

競合を説明し、最も安全な解決策を提案します。

競合

競合マーカー

Conflict marker

<<<<<<< HEAD

意味

Gitがファイルに挿入するテキストマーカーは、競合するバージョンを示します。

使い方

マーカーは、現在のブランチからの部分と、受信ブランチからの部分を示します。

注意

競合マーカーは、コミットされたコードには残すべきではありません。

<<<<<<< HEAD

依頼例

残っている競合マーカーをすべて検索する。

競合

未追跡ファイル

Untracked file

?? src/lib/git-github.ts

意味

フォルダに存在するが、まだGitの追跡に追加されていないファイル。

使い方

新しいページとコンポーネントは、ステージングされるまで通常は追跡されません。

?? src/lib/git-github.ts

依頼例

トラッキングされていないファイルをリストし、そのうちのどれがこの機能に関連しているか教えてください。

競合

変更されたファイル

Modified file

M src/components/SiteHeader.tsx

意味

最後にコミットされたバージョンとは異なる内容を持つ追跡ファイル。

使い方

現在の作業によって変更された既存のファイルを確認するのに役立ちます。

M src/components/SiteHeader.tsx

依頼例

このタスクで変更されたファイルを表示します。

安全操作

stash

stash

git stash push -m "before branch switch"

意味

変更を一時的に保存し、作業ツリーをクリーンな状態にします。

使い方

ブランチを切り替える前に、変更を一時的に保存するためにstashを使用してください。

注意

stashされた作業は忘れ去られる可能性があります。常に明確な名前を付け、意図的に再適用してください。

git stash push -m "before branch switch"

依頼例

ブランチを切り替える前に、現在の編集内容を明確なメッセージとともにstashします。

安全操作

リセット

reset

git reset --soft HEAD~1

意味

ブランチまたはステージングの状態を、別のコミットまたは状態に戻します。

使い方

ソフトなリセットまたはミックスリセットは、ローカルコミットを共有する前に調整できます。

注意

Hard resetは作業を破棄する可能性があります。使用する前に説明を求めてください。

git reset --soft HEAD~1

依頼例

最後のローカルコミットを、変更を失わずに元に戻すための最も安全な方法を説明してください。

安全操作

変更を元に戻す

revert

git revert abc1234

意味

以前のコミットを打ち消す新しいコミットを作成します。

使い方

コミットがプッシュされた後、履歴を書き換えるよりも、リバートの方が通常は安全です。

git revert abc1234

依頼例

共有履歴を書き換えずに、問題のあるコミットをリバートします。

安全操作

強制プッシュ

force push

git push --force-with-lease origin qwen3.5

意味

ローカルブランチの履歴でリモートブランチを上書きする。

使い方

これは、プライベートな機能ブランチでローカルの履歴を書き換えた後に使用されることがあります。

注意

強制プッシュは、他のユーザーのリモートコミットを上書きする可能性があります。 `force-with-lease`を使用し、事前に確認してください。

git push --force-with-lease origin qwen3.5

依頼例

強制プッシュは行わないでください。`force-with-lease` が必要な場合は、その理由を説明してください。

安全操作

.gitignore

.gitignore

.next/

意味

Gitが追跡すべきでないファイルまたはフォルダをGitに指示するファイル。

使い方

ビルド出力、依存関係、ローカル環境ファイル、および一時ファイルに使用します。

.next/

依頼例

ビルド出力が適切に無視されているかどうかを確認します。

コマンド

git status

git status

git status --short

意味

ブランチ、ステージングされた変更、変更されたファイル、および追跡されていないファイルを表示するコマンド。

使い方

編集、コミット、プル、またはブランチの切り替え前に実行します。

git status --short

依頼例

`git status` を実行し、重要な変更点のみを要約します。

コマンド

git log

git log

git log --oneline -5

意味

コミット履歴を表示するためのコマンド。

使い方

最近のコミットを見つけたり、作業内容を比較したり、ロールバックするコミットを特定したりするために使用します。

git log --oneline -5

依頼例

最後の5つのコミットをコンパクトな形式で表示します。

コマンド

git add

git add

git add src/lib/git-github.ts

意味

次のコミットのために変更をステージングするコマンド。

使い方

集中型のコミットが必要な場合は、明確なパスを使用します。

git add src/lib/git-github.ts

依頼例

このページ用に作成されたファイルのみをステージします。

コマンド

git commit

git commit

git commit -m "Add Git terms reference"

意味

ステージングされた変更をリポジトリの履歴に記録するコマンド。

使い方

何が変更され、それがなぜ重要なのかを説明するメッセージを使用します。

git commit -m "Add Git terms reference"

依頼例

ステージングされた変更を、明確なメッセージとともにコミットします。

コマンド

git pull

git pull

git pull --ff-only

意味

現在のブランチをリモートブランチから更新するコマンド。

使い方

`--ff-only`オプションを使用すると、予期しないマージコミットを作成するのを回避できます。

git pull --ff-only

依頼例

安全な場合は、ff-only でプルしてください。

コマンド

git push

git push

git push origin HEAD

意味

ローカルのコミットをリモートブランチにアップロードするコマンド。

使い方

テストに合格し、コミットを共有する準備ができたら使用します。

git push origin HEAD

依頼例

linter またはビルドエラーがないことを確認してから、このブランチをプッシュします。