採用担当が高評価するGitHubポートフォリオの"必須3要素"＆NG例

この記事で分かること

• 採用担当がGitHubで実際にチェックしている項目
• 高評価されるポートフォリオの必須3要素
• 絶対に避けるべきNG例と改善方法
• GitHubプロフィールの最適化方法
• コミット履歴で実力を証明する方法
• 実際に内定を勝ち取ったGitHub活用事例

採用担当者へのアンケート結果（2024年）

• GitHubを必ずチェックする：72%
• GitHubの内容で採用を決めたことがある：58%
• 職務経歴書よりGitHubを重視：41%
• コード品質で技術力を判断：89%
• 継続性（草の生え具合）を評価：65%

GitHubで分かること

• 実際のコーディング能力
• 問題解決のアプローチ
• 技術への興味・関心の幅
• 学習の継続性
• コミュニケーション能力（PR、Issue）

GitHub評価と初任給の相関

GitHub評価	平均初任給	内定率	選考通過率
優秀（上位10%）	520万円	68%	82%
良好（上位30%）	450万円	45%	61%
普通	380万円	28%	35%
なし/貧弱	350万円	15%	20%

必須項目

• 本名またはニックネーム（一貫性があること）
• プロフィール写真（顔写真推奨）
• 簡潔な自己紹介（2-3行）
• スキルセット（使用言語・フレームワーク）
• 連絡先（メール or Twitter）
• ポートフォリオサイトへのリンク

採用担当の視点：
「プロフィールが空欄の人は、コミュニケーション能力に疑問を感じる」

READMEで必須の項目

1. プロジェクト概要：何を解決するものか
2. デモ：動作するURL or GIF動画
3. 技術スタック：使用技術の明記
4. セットアップ方法：誰でも動かせる手順
5. 使い方：基本的な操作方法
6. 今後の改善予定：継続的な開発意欲

採用担当者の80%が「READMEの充実度で第一印象が決まる」と回答

評価される要素

• 適切な変数名・関数名
• コメントの適切な使用
• DRY原則の遵守
• エラーハンドリング
• テストコードの有無

減点要素

• インデントの不統一
• 不要なコメントアウト
• console.log の残存
• セキュリティキーの露出

幅の評価

• フロントエンド＋バックエンド
• 複数言語の使用経験
• 様々なジャンルのプロジェクト

深さの評価

• 1つの言語での高度な実装
• パフォーマンス最適化
• アーキテクチャ設計

高評価プロジェクトの共通点

1. 課題解決型
   実際の問題を解決している
2. 完成度
   最後まで作り込まれている
3. 独自性
   チュートリアルのコピーではない
4. 実用性
   実際に使える・使われている
5. 技術的チャレンジ
   新しい技術や難しい実装に挑戦

「1つの完成度の高いプロジェクト ＞ 10個の未完成プロジェクト」

初級レベル（〜6ヶ月）

• 個人用タスク管理ツール（カレンダー連携）
• 支出管理アプリ（グラフ表示機能付き）
• ブックマークマネージャー（タグ管理・検索）

中級レベル（6ヶ月〜1年）

• リアルタイムチャットアプリ（WebSocket使用）
• 画像共有SNS（いいね・コメント機能）
• ECサイト（決済機能模擬実装）

上級レベル（1年以上）

• 開発者向けツール（VSCode拡張、CLIツール）
• 機械学習Webサービス
• ブロックチェーンアプリケーション

最初にチェックされるファイル

1. エントリーポイント（index.js、main.py等）
2. 主要な機能のコード
3. テストコード（あれば高評価）
4. 設定ファイル（.eslintrc、package.json等）

5分で判断される項目

• 命名規則の一貫性
• 関数の責務が明確か
• 適切なコメント量
• エラー処理の有無
• コードの重複がないか

❌ 悪い例
```javascript
// データを取得
function getData(id) {
let data = fetch('/api/data/' + id)
return data
}
```✅ 良い例
```javascript
/**
* ユーザーデータを取得する
* @param {string} userId - ユーザーID
* @returns {Promise} ユーザーオブジェクト
* @throws {Error} ユーザーが見つからない場合
*/
async function fetchUserById(userId) {
try {
const response = await fetch(`/api/users/${userId}`)
if (!response.ok) {
throw new Error(`User not found: ${userId}`)
}
return await response.json()
} catch (error) {
console.error('Error fetching user:', error)
throw error
}
}
```

エラー処理、型情報、適切な命名が評価ポイント

今すぐできる改善

1. リンター導入（ESLint、Pylint等）
2. フォーマッター設定（Prettier、Black等）
3. 型定義追加（TypeScript、型ヒント）
4. 定数の切り出し（マジックナンバー排除）
5. 早期リターン（ネストを減らす）

1週間でできる改善

• ユニットテスト追加（カバレッジ60%目標）
• CI/CD設定（GitHub Actions）
• コードレビューを自分で実施

理想的な草の状態

• 直近3ヶ月：週4日以上の活動
• 直近1年：200日以上の活動
• 連続記録：30日以上あると好印象

草の色が薄くても評価される場合

• 質の高いコミット（機能追加、バグ修正）
• OSSへの貢献
• ドキュメント改善

採用担当の65%が「継続的な活動は技術力より重要」と回答

毎日コミットより質を重視

• 無意味な空コミットは逆効果
• READMEの誤字修正だけは避ける
• 最低でも10行以上の変更を心がける

効果的な活動パターン

• 月曜：新機能の実装開始
• 水曜：バグ修正、リファクタリング
• 金曜：ドキュメント更新、テスト追加
• 週末：新技術の学習、実験的プロジェクト

問題点：

• 「React-Tutorial」「Django-Tutorial」が並ぶ
• READMEが元のチュートリアルのまま
• 独自の工夫が一切ない

改善方法：

• チュートリアルをベースに独自機能を追加
• 「○○-Enhanced」として差別化
• 学んだことを自分の言葉でREADMEに記載

実際のNG例：
```
# my-app
This is my app.
```最低限必要な内容：

• 何をするアプリか（3行以上）
• 使用技術
• セットアップ方法
• スクリーンショット

効果的なプロフィールREADMEの構成
```markdown
# Hi there 👋 I'm [Your Name]## About Me
- 🔭 現在取り組んでいること
- 🌱 学習中の技術
- 💬 得意分野
- 📫 連絡先

## Skills
  

## GitHub Stats

## Featured Projects
- [Project 1](link) - 簡単な説明
- [Project 2](link) - 簡単な説明

## Recent Blog Posts
- [記事タイトル](link)
```

視覚的に魅力的なプロフィールは印象2倍

必須項目
- [ ] プロフィール写真設定
- [ ] 本名またはニックネーム
- [ ] 簡潔な自己紹介文
- [ ] 所在地（都道府県レベル）
- [ ] メールアドレスまたはTwitter
- [ ] 個人サイト/ブログのURL
- [ ] プロフィールREADME作成
- [ ] 6個のリポジトリをピン留め推奨項目
- [ ] 所属組織（会社/学校）
- [ ] GitHub Statsの表示
- [ ] 使用言語の可視化
- [ ] コントリビューショングラフの公開
- [ ] Pro版の検討（プライベートリポジトリ）

目標とする状態

• 公開リポジトリ：3-5個
• コミット数：100-200
• 最長連続記録：7日以上
• 主要言語：1-2言語

必須プロジェクト

• 個人ポートフォリオサイト
• 簡単なWebアプリ（ToDoリスト等）
• 学習記録リポジトリ

このレベルで応募可能な企業
SES、受託開発、スタートアップ（インターン）

目標とする状態

• 公開リポジトリ：10-15個
• コミット数：500-1000
• 最長連続記録：30日以上
• スター獲得：合計10以上

必須要素

• フルスタックアプリケーション1つ以上
• OSSへのコントリビュート経験
• CI/CD設定されたプロジェクト
• テストコード付きプロジェクト

狙える企業レベル
Web系企業、中堅IT企業、メガベンチャー

理想的な状態

• 公開リポジトリ：20個以上（質重視）
• コミット数：1000以上
• コントリビューション：200日/年以上
• スター獲得：50以上（1プロジェクト）

差別化要素

• 自作ライブラリ/ツールの公開
• 技術記事との連携
• 複数人でのコラボレーション実績
• スポンサー獲得

到達可能なポジション
GAFA、ユニコーン企業、テックリード候補

GGさんのGitHub戦略

• 期間：独学8ヶ月
• リポジトリ数：12個
• スター獲得：最高42個
• 転職先：大手IT企業（年収480万円）

成功要因：

• 業務効率化ツールを5個作成し実用性をアピール
• 全プロジェクトにデモサイトを用意
• 技術ブログと連携（記事内でコード解説）
• 毎日1時間のコーディングを6ヶ月継続

「GitHubが履歴書以上に評価された」（GGさん）

HHさんのGitHub改善

• Before：リポジトリ3個、更新なし
• After：リポジトリ15個、毎日更新
• 期間：3ヶ月で改善
• 結果：年収150万円アップ

改善ポイント：

• 既存プロジェクトのREADME充実化
• 英語でのドキュメント作成
• OSSに10個のPRを送信
• プロフィールREADMEで実績を可視化

「3ヶ月の努力で人生が変わった」（HHさん）

IIさんのGitHub営業術

• 公開ツール：業務効率化Chrome拡張
• スター数：523個
• 結果：月単価80万円の案件獲得

GitHub経由の案件獲得方法：

• 実用的なツールを無料公開
• Issueへの迅速な対応で信頼構築
• プロフィールに「お仕事募集中」を明記
• 企業の技術者からスカウト

「GitHubが最強の営業ツールになった」（IIさん）

GitHub成功の方程式高評価 = (オリジナルプロジェクト × コード品質) + 継続性 + プレゼンテーション

この方程式が示すように、質の高いオリジナルプロジェクトを、読みやすいコードで実装し、継続的に改善し、魅力的に見せることが成功の鍵です。

即実行（1時間以内）

1. プロフィール写真と自己紹介を更新
2. 最も自信のあるプロジェクトのREADME改善
3. 6個のリポジトリをピン留め

今週中に実行

• プロフィールREADMEを作成
• 全リポジトリのREADMEを最低限整備
• 不要なリポジトリを整理（アーカイブ or 削除）

1ヶ月以内に達成

• オリジナルプロジェクトを1つ完成
• 30日連続コミットにチャレンジ
• OSSに1つ以上コントリビュート

GitHubは、あなたの成長の記録です。今日のコミットが、
明日のあなたを作ります。

1年後、振り返った時、
確実に成長している自分がそこにいます。

さあ、git pushから始めましょう。