要約

このAIレポート生成ツールは、コード行数・アクティブなコントリビューター数・テストカバレッジ・コードベースの経過年数・主な型付けスタイルという5つの入力から、新しいエンジニアが最初の重要なPRを出すまでのオンボーディング期間と、コードベースのリスクを算出する。ロジックはGoogle/SmartBearのコードレビュー研究やStripeのDeveloper Coefficientレポートに基づく透明なヒューリスティックであり、ブラックボックスではない。計算はすべてブラウザ内で完結し、コードベースの情報がどこかに送信されることはない。

コードベース診断AI:オンボーディング期間とリスクを算出

コード行数・テストカバレッジ・人数・経過年数を入力するだけで、PRの説明やSlackにそのまま貼れるレポートを生成。登録不要、サーバー往復なし。

AIコードベースレポート生成

下記にコードベースの数値を入力してください。レポートはリアルタイムに更新され、プレーンテキストとしてコピーできます。

推定オンボーディング期間 -
コードベースのリスクスコア - -

最初に直すべきこと

    レポートの仕組み

    見積もりを構成する要素

    行数とカバレッジ

    オンボーディング期間はコード行数に比例して伸び、テストカバレッジが50%を下回るとさらに悪化する。レビュアーも新しく入るエンジニアも、テストスイートを信頼する代わりに実装を1行ずつ読んで動作を確認することになるからだ。

    チームの余力

    アクティブなコントリビューターが5人未満のチームには非公式なセーフティネットがなく、担当者が曖昧な質問はDMの中で1日放置される。15人を超えると、メンターの余力ではなくコードベース自体がボトルネックになっていく。

    経過年数と型付け

    3〜7年を超えたコードベースには、コメントやドキュメントに残らなかった暗黙知が蓄積する。命名規則、削除されずに残った非推奨モジュール、別の場所で修正済みのバグへの回避策などだ。静的型付け(TypeScript, Go, Rust, Java)は、型がドキュメントを兼ねるぶん、動的型付けの言語よりも立ち上がりが早い。

    チケットを割り当てる前に、状況を読む

    リスクスコアはチームで本当のボトルネックを話し合うための出発点であって、確定した判決ではない。次の採用が始まる前に何を直すかを決めるために使うものであり、エンジニアを順位付けするためのものではない。

    コードエディタとレポートウィジェットがぼやけて映るノートパソコンの画面でキーボードを打つ手元のクローズアップ

    よくある質問

    無料で使えますか?
    はい。このレポート生成ツールはブラウザ内で完結して動作します。登録もペイウォールもなく、見積もりの計算のためにサーバーへデータが送られることもありません。
    このベンチマークの根拠は何ですか?
    この数式は査読済みモデルではなく、透明性のあるヒューリスティックです。レビューサイズに関する指針(PRはおよそ400行未満に抑える、集中して読めるのは60分程度が目安という点)は、Googleのエンジニアリングプラクティス文書とSmartBear/Ciscoのコードレビュー研究に基づいています。カバレッジと技術的負債のペナルティの大きさは、エンジニアが週の多くの時間を不具合や保守作業に費やしていると報告したStripeのDeveloper Coefficientレポートを参考にしています。意図的に「ヒューリスティック」と呼んでいます。数値は目安として扱ってください。
    自分のコードベースのデータはどこかに送信されますか?
    いいえ。入力内容はすべてブラウザ内にとどまり、計算はお使いのデバイス上のJavaScriptで行われます。唯一のネットワーク通信は、ウィジェットの利用回数を数えるための匿名のping送信のみで、コードベースの詳細は一切含まれません。
    これは本格的なオンボーディング計画の代わりになりますか?
    いいえ。あくまで計画の出発点となる目安の日数とリスクレベルを示すものです。実際のオンボーディングチェックリスト、担当メンターの割り当て、自分のリポジトリに基づいた最初の週の読書リストと組み合わせて使ってください。
    リスクスコアが予想より高く出たのはなぜですか?
    最も影響が大きい要因は3つあります。テストカバレッジが30%未満であること、コードベースが7年以上経過していること、そしてエンジニア1人あたりのコード行数が多いことです。まずこの3つを確認してください。多くの場合、今四半期のうちに実際に手を打てる項目です。
    自分のリポジトリが複数言語のモノレポの場合はどうすればいいですか?
    新しく入るエンジニアが実際に最初に触れる言語と領域を基準に数値を出してください。モノレポ全体ではありません。200万行のモノレポでも、ジュニアが触るのが4万行の1サービスだけなら、そのサービス単位でスコアを出すべきです。
    コードレビューのキャパシティ計画にも使えますか?
    部分的には使えます。リスクスコアはレビュー負荷と相関しており、リスクが高いコードベースは概してレビューが遅く、コストもかかる傾向にあります。ただし、自分のチームのPRサイクルタイムを実際に自社のメトリクスダッシュボードで測定する代わりにはなりません。
    リスクスコアとオンボーディング見積もりはどう違いますか?
    オンボーディング期間は、1人の新しいエンジニアが戦力になるまでの日数を答えるものです。リスクスコアは、コードベース全体としての脆さを答えるものです。テストカバレッジが低く、コードベースが古く集中している場合、すでに長く在籍しているエンジニアにとってもリスクは高くなります。

    このレポートをオンボーディング資料に

    Skyworkは走り書きのメモをスライドやドキュメント、図表に変換するツール。新しいエンジニアが来週月曜に入社するのに、誰も時間をかけて作れないオンボーディング資料の作成に役立つ。