本ページはプロモーションを含みます

AIコーディング支援

GitHub Copilotの使い方|効く場面とレビューの実務ポイント

本ページはプロモーションを含みます

結論から言うと

結論から言うと、GitHub Copilotは非エンジニアでも小さなスクリプトには助かります。ただし、分からないコードを貼るだけなら危険。

この記事でわかること

  • 非エンジニアがCopilotを使う距離感
  • 効く場面と任せすぎると危ない場面
  • 生成コードのレビュー観点

結論から言うと、GitHub Copilotは「小さく頼んで、自分で読める範囲だけ採用する」ならかなり助かります。逆に、分からないコードを丸ごと出してもらう使い方は危ないです。

私は都内のメーカーで企画職をしていて、エンジニアではありません。2023年3月からChatGPTを資料づくりや議事録で使い始め、Copilotも小さなスクリプトを書く範囲で試しました。「非エンジニアが触った距離感」で書きます。

結論

✅ ここだけ読めばOK

  • Copilotは「小さく具体的な作業」で最も効果が出やすい
  • コメント駆動とテストコード生成を組み合わせると、実務で使いやすい
  • 生成コードは必ず仕様、例外、既存設計、テストの4点でレビューする

Copilotが効く場面

Copilotは、文脈がはっきりしているほど強くなります。立派なアプリ開発より、既存の処理に少し足すような場面で助かりました。
特に次のような作業では、手を止めずに進めやすくなります。

  • 既存コードに似た処理を追加する
  • DTOや型定義から変換関数を作る
  • バリデーションやエラーメッセージを追加する
  • テストケースの雛形を作る
  • コメントから短い関数を生成する
  • ライブラリの使い方を思い出す

実務では「完全な答えを出してもらう」というより、最初のたたき台を速く出してもらう感覚が近いです。私の場合、CSVを整える小さなスクリプトでこの感覚がありました。

一度、Copilotが出したコードをほぼそのまま貼ったら、列名が1つ違うだけで止まりました。私の手元のデータに合っていなかったわけです。それ以来、提案を読み、削り、直す前提にしています。

Copilotが効きにくい場面

逆に、次のような作業はCopilotだけでは不十分です。

場面 理由
要件が曖昧 何を満たすべきか判断できない
大きな設計変更 影響範囲や責任分界を人間が決める必要がある
セキュリティ判断 仕様と脅威モデルの理解が必要
運用設計 障害時の対応や監視方針まで考える必要がある

Copilotはコードを書く支援ツールであり、プロダクトの目的を決める道具ではありません。
「何を作るか」「なぜ必要か」「どこまで責任を持つか」は、人間が言語化する必要があります。コードを書けるかどうか以前に、目的が曖昧だとAIも迷います。

コメント駆動で精度を上げる

Copilotを使うときは、いきなりコードを書かせるより、先にコメントで意図を書くと精度が上がります。

例として、次のような粒度が扱いやすいです。

  • 入力は何か
  • 出力は何か
  • 例外時にどうするか
  • 既存関数のどれに合わせるか
  • テストしたいケースは何か

コメントは長くなくて構いません。
ただし「いい感じに処理する」ではなく、「空文字はエラーにする」「既存のformatDateに合わせる」のように具体化します。

コメントの書き方例

悪い例 良い例
ユーザーを保存する メール重複を確認し、重複時は例外を返してユーザーを保存する
日付を整形する ISO文字列を受け取り、既存のformatDateと同じ形式で返す
テストを書く 正常系、空文字、存在しないIDの3ケースをテストする

この程度まで書くと、Copilotの提案はかなり扱いやすくなります。
また、コメント自体があとからレビューの観点にもなります。

テストコード生成で使う

Copilotの実務利用で特に便利なのが、テストコードの生成です。
既存テストを開いた状態で、対象関数と期待ケースをコメントに書くと、プロジェクトの書き方に近い雛形を出しやすくなります。

おすすめの使い方は次の流れです。

  1. 既存の似たテストファイルを開く
  2. 対象関数の仕様をコメントで書く
  3. 正常系と異常系を箇条書きする
  4. Copilotに雛形を出させる
  5. アサーションとテストデータを人間が確認する

テスト生成は、単に時間短縮になるだけではありません。
人間が見落としていた境界値に気づくきっかけにもなります。

⚠️ 注意点

Copilotが生成したテストは「通るテスト」になりがちです。実装に合わせて期待値を作ってしまうことがあるため、仕様から見て正しい期待値かを必ず確認してください。

実務で使ってみた立場からの判断基準

Copilotを使いこなせているかは、入力したプロンプトの上手さではなく、チームの開発品質が落ちていないかで判断します。

私なら、背伸びせず次の4点だけは見ます。全部を完璧にレビューできるとは言いませんが、ここを飛ばすと怖いです。

1. 変更範囲が小さいか

Copilotの提案を受け入れているうちに、不要な変更まで入ることがあります。
レビューしやすい差分にするには、1回の作業を小さくします。

  • 1つの関数
  • 1つのテストケース
  • 1つのバリデーション
  • 1つのエラーハンドリング

これを超えて広がる場合は、いったん止めて人間が設計を確認したほうが安全です。

2. 既存の書き方に合っているか

AIのコードは一般的には整っていますが、プロジェクトの癖と違うことがあります。
たとえば、例外の投げ方、ログの出し方、型の置き場所、テスト名の付け方です。

きれいなコードでも、既存ルールと違えば保守負荷になります。
新しい書き方を混ぜる前に、既存パターンに合わせるのが実務では大切です。

3. 例外処理が足りているか

Copilotは正常系を先に出すことが多いです。
そのため、レビューでは次を必ず見ます。

  • nullやundefinedは来ないか
  • 空配列、空文字はどう扱うか
  • 権限エラーはどう返すか
  • 外部API失敗時にどうするか
  • ログに出してよい情報か

特に個人情報や認証情報を扱う処理では、出力をそのまま信用しないほうが安全です。

4. テストで説明できるか

良いCopilot利用は、テストが増えます。
悪いCopilot利用は、コードだけが増えます。

生成コードを採用するなら、少なくとも「このテストが通るから仕様を満たす」と説明できる状態にします。
説明できない差分は、あとで自分やチームが困ります。

おすすめの練習方法

最初から大きな機能を任せる必要はありません。
次の順番で慣れると、失敗しにくいです。

  1. 既存コードの1関数を読ませて説明させる
  2. 小さな変換関数をコメントから作る
  3. 既存テストを参考にテストを追加する
  4. エラーケースを追加させる
  5. Pull Request前に自分で差分を説明する

この練習を数日続けるだけでも、Copilotに任せる作業と任せない作業の境界が見えてきます。

私ならこう使います

GitHub Copilotは、曖昧な要件を解決してくれる魔法の道具ではありません。まず「自分が説明できる小さな処理」だけに使うのが安全です。

小さく具体的な作業に分け、コメント駆動とテスト生成を組み合わせると、非エンジニアでも実務のちょっとした作業を前に進めやすくなります。

大事なのは、生成されたコードを理解してレビューすることです。
仕様、例外、既存設計、テストの4点を毎回確認すれば、Copilotは単なる自動補完ではなく、開発の良い相棒になります。

よくある質問

GitHub Copilotは初心者にも役立ちますか?

役立ちますが、出力を理解せずに貼る使い方は危険です。小さな関数、テスト、既存コードの読み解き補助から使うと学習にもつながります。

Copilotに何を任せるのが効果的ですか?

定型処理、テストケースの雛形、既存コードに似た実装、コメントからの小さな関数生成が効果的です。設計方針や責任分界は人間が決めるべきです。

Copilotのコードはそのまま使っていいですか?

そのまま使う前提にはしないほうが安全です。仕様に合っているか、例外処理が足りるか、既存設計に沿うか、テストで確認できるかを必ず見ます。

管理人

2023年3月から生成AIを業務利用

都内のメーカーで企画職をしている会社員です。2023年に ChatGPT を仕事で使い始めてから、資料づくりと議事録がだいぶ楽になりました。以来、気になったAIツールはとりあえず有料プランで1か月使ってみることにしています。ここは、その記録を残している個人サイトです。勤務先の都合で実名は出していません。

どういう基準で書いているか