Codespect

すべてのプルリクエストに、何が変わったか、レビュアーにとって何が重要かを平易な言葉で短く説明する。生のdiffを、同僚が数秒で読み流せる要約に変える。これはたいていレビュー時間を食う工程だ。まず流し読みしてからコードを読む人ほど、見慣れない変更に早く入り込める。

レビュアーは変更を実績ある設計原則に照らして採点し、違反を該当行まで指す。重複したロジック、複雑になりすぎた関数、責務を二つ以上抱えるクラスを探す。出力はlinterの警告ではなく同僚への助言として読めるので、受け入れるにも反論するにも楽だ。

Codespectはプルリクエストをまたいで変更を追い、レビュアーが対応済みのコードに同じコメントを繰り返さない。古いツールはコミットごとに同じ指摘を積み上げ、役に立つ情報を埋めてしまう。この機能がスレッドをきれいに保つので、目に入るコメントはまだ有効なものだけになる。

Laravel上のPHP、そしてReactとVue上のJavaScriptとTypeScript向けに調整したモデルを用意し、プルリクエストが開いた時点でスタックを判別する。LaravelのレビューはEloquentとBladeの作法を理解し、Reactのレビューはフックとコンポーネントの作法を理解する。他の言語は汎用モデルに回るので、守備範囲は広いが深さは均一でない。

チームが自社のコード基準を一度決めれば、Codespectは組み込みルールに加えて毎回のプルリクエストをそれに照らす。命名規則や禁止ライブラリなど、汎用レビュアーには分からない会社の決め事を固定できる仕組みだ。有料プランに属し、チームの方針を定めるテックリードを想定している。

コメントにひと押しが要るとき、レビュアーは手で書き直す代わりにワンクリックでAIの提案を整えられる。ツールは同じスレッドにより良い提案を投稿し直す。流れの中では小さな部品だが、コピー&ペーストの寄り道なしにレビューを進められる。

GitHubアプリが求めるのはプルリクエストのdiffへの読み取り専用アクセスだけで、ソースコードを自社サーバーに保存しない。diffは解析後に削除され、レビューが終われば残らない。基盤もGDPRに沿って作られている。コードの行き先を気にするチームにとって、この一点が使えるかどうかを決める。

コメントだけでなく、Codespectはレビュー時間を計測し、工程がどこで伸びるかを示す。このデータがあれば、レビューが特定の段階で詰まるのか、特定の人で詰まるのかが分かる。レビュー本体に並ぶレポート層だ。