変更確認とコミット

q を離れずにリポジトリ全体の変更を確認し、レビュー済みの Conventional Commit を作成します。

Markdown を表示

リポジトリの変更を確認

/changes で q の読み取り専用 Git ブラウザーを開きます。リポジトリのステージ済み、未ステージ、未追跡ファイルを一覧表示します。

  • 上下または j/k でファイルを選択します。
  • Enter で diff にフォーカスし、Tab でファイルと diff のペインを切り替えます。
  • PageUp/PageDown で縦、左右で長い行をスクロールします。
  • r で状態を再読み込みし、Escape でチャットに戻ります。

このビューを開くだけではステージ、編集、コミットは行われません。

ビューを理解

ブラウザーは現在の q ターンより前からあった変更も含む、リポジトリの現状を表示します。エージェントターン単位の監査ログではありません。

ステージ済みと未ステージのパッチは HEAD に対して相殺される場合でも別々に表示されます。既知のテキスト形式は構文強調、バイナリは通知を表示します。不明または大きすぎるソースはプレーンテキストになります。選択したプレビューは 256 KiB または 4,000 行に制限され、部分表示なら明示されます。

コミットを準備

チャットから /commit を実行するか、現在のリポジトリで単独ワークフローを起動します。

powershell
q commit

ステージ済み変更があればそのインデックスを使います。空なら q が所有するルート .q メタデータを除いた作業ツリーの変更をステージします。その後、設定された commit モデルが単一の Conventional Commit メッセージまたは分割コミット案を作成します。

コミット作成前に、q は取得したインデックスが提案と一致するか再確認します。レビュー中に状態が変わった場合は古いグループをコミットせず、再生成または再起動してください。

レビューして完了

コミット画面では上下で分割案を選択し、e でメッセージを編集、Ctrl+S で保存、r で再生成します。Enter で承認した案をコミットします。p はコミットしてプッシュしますが既存 upstream が必要です。Escape はコミットせずに取り消します。

承認前に各分割のファイルとメッセージを確認してください。q は Git 操作を提案・実行できますが、以前からある無関係な変更まで現在の作業の一部とは見なしません。