レビュー¶
2 種類のレビューがあります。
| 種類 | 開き方 | 必要なもの |
|---|---|---|
| プルリクエストのレビュー | Space g(一覧)、:pr(一覧)、:pr <番号> |
gh(gh auth login 済み) |
| 変更の確認(git-diff モード) | Space G、Ctrl+G、:gitdiff |
git |
git-diff モード¶
エディター全体を「通常モード」と「git-diff モード」で切り替えます。
Ctrl+G(Helix モードでは Space G)、:gitdiff、コマンドパレットで入ります。もう一度実行すると通常モードに戻ります。
- サイドバーが上下 7:3 に分かれ、下の 3 に CHANGES(変更ファイルの一覧)が出ます。
Tabでファイルツリーと行き来します。 - 変更のないファイルは、通常のエディターで開きます。
- 変更のあるファイルは、ファイル全体を Split(左が比較元、右が今のファイル)で開きます。
- 新規ファイル(未追跡を含む)は、全行を追加行の色で表示します。
- 右側(今のファイル)は、通常どおり編集・保存できます。編集すると diff がすぐに更新されます。
- CHANGES の一覧は、保存したとき、外部の変更を検知したとき、数秒ごとに更新します。
Split と Unified¶
s、:gitdiff split、:gitdiff unified、ヘッダーの [分割 ⇄ 統合] のクリックで切り替えます。
Unified でも編集できます。削除された行は、読み取り専用の行として挟まります。
比較元(base)¶
b または :gitdiff base head|pr で切り替えます。
| 比較元 | 内容 |
|---|---|
HEAD(初期値) |
HEAD と作業ツリーを比べる。未追跡ファイルを含む |
| PR の base | 今のブランチに PR があるとき、git merge-base <PR の base> HEAD と作業ツリーを比べる |
PR の base を選ぶと、GitHub の PR 画面の差分に、まだコミットしていない変更を足したものになります。
base ブランチをマージしても、差分には自分の変更だけが出ます。この比較には gh が必要です。
CHANGES のキー操作¶
| キー | 動作 |
|---|---|
j / k |
移動 |
Enter / l |
ファイルを開く |
s |
分割 / 統合の切替 |
b |
比較元の切替(HEAD ⇄ PR の base) |
r |
一覧の更新 |
Tab |
ファイルツリーへ |
Esc |
エディタへ |
プルリクエストのレビュー¶
左にファイルの一覧、右に差分を表示します。
| キー | 動作 |
|---|---|
j / k |
移動 |
] n / [ p |
次 / 前のハンク |
J / K |
次 / 前のファイル |
Ctrl+D / Ctrl+U |
1 画面下 / 上 |
g / G |
先頭 / 末尾 |
Tab / h / l |
ファイルの一覧と差分の間でフォーカスを移す |
s |
左右分割と 1 列の切替 |
v |
確認済みにする(次のファイルへ進む)。もう一度押すと戻る |
c |
この行にコメント(\n で改行) |
d / x |
未送信のコメントを削除 |
y |
コメントを Markdown でコピー |
a |
コメントをエージェントへ送る(プレビューで確認してから) |
Enter / o |
ファイルをエディタで開く |
A / R / S |
承認 / 変更を要求 / コメントのみ、で送信 |
C |
gh pr checkout を実行 |
r |
再読み込み |
q / Esc |
閉じる |
プルリクエストにレビューを送る¶
- 差分の行に移動して
cを押し、コメントを書きます。必要な数だけ繰り返します。 A(承認)、R(変更を要求)、S(コメントのみ)のどれかを押します。- 本文を入力して確定します。未送信のコメントもまとめて送ります。
R と S では、本文かコメントのどちらかが必要です。
コメントをエージェントに渡す¶
y でコメントを Markdown としてクリップボードにコピーできます。
a を押すとプレビューが開き、Enter でターミナルパネルに貼り付けます。詳しくは AI エージェント連携 にあります。