AI エージェントに開発を頼むときによく出る用語を、何を指すか・取り消せるか・どう頼むかで並べました。「頼み方」の文は、そのままコピーしてエージェントに渡せます。
右へ進むほど取り消しにくくなります。エージェントには「どこまでやるか」をこの順で言い切ると、範囲が食い違いません。
| 言い方 | エージェントがやること | 取り消し |
|---|---|---|
| 「直して（ファイルの変更まで）」 | ファイルを書き換える。コミットはしない | 手元だけ |
| 「コミットまで」 | 変更を履歴に記録する。プッシュはしない | 手元だけ |
| 「プッシュまで」 | 記録を GitHub などの共有の場所へ送る | チームに影響 |
| 「PR を作って」 | 変更をまとめて、取り込んでほしいと提案する | チームに影響 |
| 「マージして」 | PR の変更を main などの本線に取り込む | チームに影響 |
| 「デプロイして」 | 本番やステージングの環境に反映する | 公開に影響 |
| やったこと | 取り消し方 | 注意 |
|---|---|---|
| ファイルの変更（コミット前） | 変更を捨てる（git restore）か stash | 捨てた変更は戻せないことがある |
| コミット（プッシュ前） | reset --soft で記録だけ取り消す／新しいコミットで直す | 手元だけなので安全 |
| プッシュ | revert のコミットを作ってプッシュ | 履歴を消す（reset ＋ force push）のは避ける |
| main へのマージ | revert の PR を作ってマージ | 取り消したことも履歴に残る |
| デプロイ | 前の版へロールバック | 出ていた間に見られたことは消えない |
| 秘密の値の流出 | キーを作り直して古いキーを無効にする | コミットを消しても、すでにコピーされているかもしれない |
出典の ファイル名:行 は、調べものの話題 agent-dev-terms の sources/ にある原文（Git の公式文書、GitHub Docs、martinfowler.com、Google SRE Book、各道具の公式文書）の行を指します。「出典なし」の印は、今回集めた原文に定義が無かった語です。