変更
本当に重要な変更だけを読む。
今や AI は、開発者がレビューできるよりも速くコードを書きます。エージェントから何千行もの diff を渡されても、どのファイルがリグレッションを持ち込みうるのかはわかりません。Panolayer は変更されたすべてのファイルをリスクでスコアリングし、その理由を説明するため、どれを最初にレビューすべきかがわかります。準備ができたら、同じ場所からコミットしてプッシュできます。
3,000 行の diff を読む人はいません。誰もが最後までスクロールしてコミットします。
大きな diff の大半は、lockfile、設定、そして注意を払う必要のない小さな編集です。実際に何かを壊しうる数少ないファイルは、途中のどこかに埋もれています。Panolayer はそれらを前面に引き出すため、まずそこを確認し、エージェントのスピードで進み続けられます。
01
最初にどこを見るべきかがわかる
エージェントが触れたすべてのファイルを読む時間はありませんし、その必要もありません。概要には、変更されたファイルの数、追加・削除された行数が表示され、変更されたすべてのファイルに 0〜100% のリスクスコアと 1 行の理由が付きます。リスクスペクトラムでは、最もリスクの高いファイルが赤い端に配置されます。リスクバーとオーバーラップは、同じスコアを縦に並べたり、各変更が触れた対象ごとにグループ化したりして表示します。
- UI
- ロジック
- データ
- API
- 設定
- インフラ
- 依存関係
- セキュリティ
- テスト
- ドキュメント
- スタイル
- アナリティクス
- その他
02
ファイルを開く
ファイルのランクが高ければ、読む前にその理由を知りたいものです。クリックすると diff が split ビューまたは inline で表示され、その上にスコアの詳しい理由が示されます。
03
スコアだけでは足りないとき
Analyze all 機能は、変更セット全体を読み、概要、全体的なリスク、具体的な懸念事項、各ファイルへのメモを返します。さらに詳しく知りたいときは、Chat で Panolayer Agent との会話を開けます。変更されたファイルと変更内容がすでに添付されているため、一行ずつ読む代わりに質問できます。
04
最近のコミットと比較する
リポジトリにとっての「普通」がわかっていれば、高いスコアの意味もより明確になります。History では、作業ツリーが最近のコミットの上に表示され、それぞれにリスクラベル、作成者、ハッシュが付きます。今回の変更がいつもどおりのものなのか、今週コミットした中で最もリスクの高いものなのかを判断できます。
05
コミットしてプッシュする
重要な部分を確認したら、同じ画面からコミットします。Panolayer が diff からコミットメッセージの下書きを作成し、あなたはそれを編集できます。Commit はローカルブランチに書き込み、Commit & Push は追跡しているリモートにも送信します。コミットには変更されたすべてのファイルが含まれます。部分的にステージングする場合は、Git を直接使用できます。
pull request のレビューは、この後に Git ホスト上で行われます。
Panolayer が保留するのはエージェントであり、あなたではありません
エージェントは、あなたの承認なしに自分の作業をブランチにマージすることはできません。その変更はまず worktree 内で検証され、その後マージするかどうかをあなたが決めます。あなた自身の作業がゲートされることはありません。チェックが失敗していても、いつでも好きなときにコミットできます。失敗は「検証」に一覧表示されたまま残るため、何も隠されません。
よくある質問
リスクのパーセンテージは何を意味しますか？
diff をもとに、ファイルの変更にどの程度の注意が必要かをモデルが 0〜100% で評価したものです。スコアは Safe、Low、Caution、Critical のいずれかに分類されます。
これは検証と同じですか？
いいえ。スコアは diff を読んだものです。検証は、Panolayer がコードから導き出したアーキテクチャとルールに照らして変更をチェックし、ファイルを保存したときとエージェントの作業が完了したときに実行されます。
スコアと Analyze all の違いは何ですか？
スコアは、変更のたびに各ファイルの diff をすばやく読んだものです。Analyze all は、依頼したときに変更全体をまとめて読みます。さらに踏み込んだ質問には、Chat が変更を Panolayer Agent に渡します。
チェックが失敗していてもコミットできますか？
はい。Panolayer が保留するのはエージェントであり、あなたではありません。失敗は「検証」に一覧表示されたまま残ります。
変更の一部だけをコミットできますか？
Panolayer からのコミットには、変更されたすべてのファイルが含まれます。一部だけをコミットするには、Git を直接使ってステージングしてください。
GitHub と連携していますか？
Commit & Push は、ブランチが追跡しているリモートにブランチを送信します。pull request とレビューは Git ホスト上で行われます。