Communitygithub.com

BattleTree - ポートフォリオ戦略

採用につながるGitHubポートフォリオを構築します。3~5の洗練されたプロジェクトを厳選し、魅力的なREADMEを作成し、ライブデモをデプロイし、リポジトリ全体に一貫したストーリーを展開し、AIネイティブ開発の役割にすべてを合わせます。就職活動に備えてGitHubを準備するとき、ピン留めするものを決めるとき、公開プロフィールを監査するときに使用します。

BattleTree - ポートフォリオ戦略 とは?

このスキルは、採用担当者の目に留まるGitHubポートフォリオを構築するための包括的な戦略を提供します。単なるコードの置き場ではなく、厳選された展示としてGitHubを捉え、ピン留めした各リポジトリが採用担当者の質問に答え、面接につながるようにします。品質重視の原則に基づき、3~5の洗練されたプロジェクトに焦点を当て、未完成のリポジトリはアーカイブまたは非公開にすることを推奨します。また、リポジトリ全体で一貫したストーリーを構築する方法(スペシャリスト、フルスタックビルダー、AIネイティブ開発者などのアーク)、理想的なピン留めレイアウト、30秒でプロジェクトを売り込むREADMEの構造、ライブデモの重要性、コントリビューショングラフの適切な管理方法についても詳しく解説します。特にAIネイティブ開発の役割をターゲットとする場合に、エージェンティックワークフローやLLM統合などを示すリポジトリの重要性を強調し、最終的には採用担当者が「この候補者を次のラウンドに進めたい」と思わせるポートフォリオを作成することを目標としています。

対応✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/portfolio-strategy

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ポートフォリオ戦略

核となる原則

あなたのGitHubは、中途半端なプロジェクトの墓場ではありません。厳選された展示会です。ピン留めされた各リポジトリは、採用担当者があなたについて抱くであろう一つの質問に答え、その答えがすべて面接を予約したいと思わせるものでなければなりません。

印象的なものと平凡なものを分けるもの

平凡なポートフォリオ                    印象的なポートフォリオ
─────────────────                     ────────────────────
30個のリポジトリ、ほとんどがフォーク        5個のリポジトリ、すべてオリジナル作品
READMEなし                              各READMEがストーリーを語る
ライブデモなし                           すべてのプロジェクトがデプロイされている
ランダムなチュートリアルのクローン         明確なテーマと進歩
最終コミット: 8ヶ月前                     一貫性のある最近の活動
リポジトリに説明文なし                     すべてのリポジトリに一言説明あり
「my-first-react-app」                    「AI搭載コードレビューツール」

違いは才能ではありません。厳選です。最高のポートフォリオは、計画を持った人のように見えます。触れたものを何でもコミットする人のように見えません。


量より質

3〜5の洗練されたプロジェクトは、30の放棄されたリポジトリに勝ります。毎回。

重要な計算

リポジトリ数README数デプロイ数採用担当者の印象
3020「物事を始めるが、完成させない」
1551「手を出すが、何が得意か不明」
554「集中している。リリースする。技術を熟知している」
333「触れるものすべてが洗練されている」

クリーンアップルール

何か新しいものを追加する前に、すでにあるものを監査します。

1. 未完成で修復不可能なものはアーカイブまたは非公開にする。
2. 変更を加えていないフォークリポジトリは削除する。
3. 公開しておくものすべてにREADMEを追加する。
4. 表示されているすべてのリポジトリに説明文を設定する。
5. 残ったものは公開に値するものでなければならない。

履歴書に載せないのであれば、公開GitHubに載せるべきではありません。


リポジトリ全体でストーリーを語る

ピン留めされたリポジトリは、ランダムなサンプルではありません。それらは章です。訪問者がナラティブを見ることができるように配置します。

効果的なストーリー構造

スペシャリストアーク:

「私はAI/MLを深く掘り下げ、それを証明できます。」

リポジトリ1: 特定ドメインタスク向けにファインチューニングされたLLM
リポジトリ2: 評価フレームワークを備えたRAGパイプライン
リポジトリ3: ツール使用を伴うエージェンティックワークフロー
リポジトリ4: LangChain/LlamaIndexへのオープンソースコントリビューション

フルスタックビルダーアーク:

「データベースからデプロイまで、完全な製品を構築します。」

リポジトリ1: フルスタックSaaSアプリ (Next.js + API + DB + Auth)
リポジトリ2: AI搭載CLIツール (バックエンド/システムの力量を示す)
リポジトリ3: オープンソースライブラリ (API設計の思考を示す)
リポジトリ4: 個人用自動化ツール (自分のために構築していることを示す)

AIネイティブデベロッパーアーク:

「AIを使うだけでなく、AIを使って構築し、AIのために構築します。」

リポジトリ1: エージェンティックワークフロー / マルチエージェントシステム
リポジトリ2: プロダクショングレードアプリへのLLM統合
リポジトリ3: AIを活用した開発者ツール (リンター、レビューア、ジェネレーター)
リポジトリ4: AIフレームワークまたはツールチェーンへのコントリビューション

進歩を示すシグナル

採用担当者は、リポジトリが成長を示していることに気づきます。

シグナル示すもの
初期のリポジトリ: シンプルなCRUDアプリどこかから始めた
中盤のリポジトリ: テストとCIを備えたAPIエンジニアリングプラクティスを学んだ
最近のリポジトリ: 評価を備えたAIエージェントフロンティアで構築している
主要なOSSプロジェクトへのコントリビューション大規模なコードベースで作業できる

何をピン留めし、なぜか

ピン留めできるリポジトリは6つです。戦略的に使いましょう。

理想的なピン留めレイアウト

スロットピン留めするもの理由
1フルスタックプロジェクト完全な製品を構築できることを証明する
2AI/MLプロジェクトフロンティアで作業していることを示す
3オープンソースコントリビューション実際のコードベースで協力できることを証明する
4開発者ツールまたはCLI自分の問題を解決していることを示す
5ドメインプロジェクト (専門分野)ターゲットの役割に対する深さのシグナル
6ワイルドカード — 個人またはクリエイティブなもの個性と純粋な好奇心を示す

ピン留めルール

ピン留めすべきもの:
  - ライブデモまたはデプロイリンクがあるプロジェクト
  - 徹底したREADMEとスクリーンショットがあるリポジトリ
  - 応募している役割に一致する作業
  - 最も最近の、最も洗練された作業

ピン留めすべきでないもの:
  - 意味のある変更を加えていないフォークリポジトリ
  - チュートリアルのフォローアロング (完了しても)
  - READMEがないリポジトリ
  - 面接で説明できないもの

ポートフォリオのピッチとしてのREADME

ピン留めされた各リポジトリには、30秒でプロジェクトを売り込むREADMEが必要です。採用担当者は、読み続けるかどうかを決める前にそれ以下の時間しか費やしません。

ポートフォリオリポジトリのREADME構造

# プロジェクト名
何をするのか、なぜ重要なのかを一文で説明。

## デモ
[ライブデモへのリンク] | [ビデオウォークスルーへのリンク]

アプリの動作を示すスクリーンショットまたはGIF。

## 問題
これはどのような問題を解決しますか?誰がこの問題を抱えていますか?

## 仕組み
アーキテクチャの概要。主要な技術的決定。
システムに複数のコンポーネントがある場合は図。

## 技術スタック
テクノロジーのリスト — ただし意味のあるものだけ。
HTML/CSSはリストしないでください。AI統合、データベース、デプロイターゲットはリストしてください。

## 主な機能
- 機能1 — 技術的に興味深い理由
- 機能2 — 構築する上で何が難しかったか
- 機能3 — 次に何を改善するか

## はじめに
明確なセットアップ手順。誰かが5分以内にこれを実行できるように。

## 学んだこと
最も困難な技術的課題と、それをどのように解決したかについての簡単な振り返り。

READMEのアンチパターン

悪いREADMEより良いREADME
「Reactアプリ」「AIを搭載した会議要約ツール。録音をアクションアイテムに変換します」
スクリーンショットなしファーストビューにヒーロースクリーンショットまたはGIF
セットアップ: 「clone and run」セットアップ: 前提条件を記載したステップバイステップ
アーキテクチャの説明なしコンポーネントの接続方法を示すシステム図
すべてのnpmパッケージをリスト重要な3〜4のテクノロジーに焦点を当てる

ライブデモとデプロイリンク

コードは仮説です。デプロイされたアプリは証拠です。

デプロイが重要な理由

採用担当者がデモのないリポジトリを見る:
  「面白いコードだ… 実際に動くのか?」

採用担当者がライブリンクのあるリポジトリを見る:
  「試してみよう。」 → 2分後 → 「この人はリリースできる。」

プロジェクトタイプ別のデプロイオプション

プロジェクトタイプ無料デプロイ先適している用途
フルスタックWebアプリVercel, Railway, Fly.ioプロダクション感のあるアプリ
API / バックエンドRailway, Renderバックエンドスキルの披露
静的サイト / ドキュメントGitHub Pages, Netlifyドキュメント、ランディングページ
AI/MLデモHugging Face Spaces, Streamlit Cloudモデルデモ、データアプリ
CLIツールnpm publish, Homebrew tap配布シグナル

デプロイできない場合は、デモを録画する

すべてをクラウドで実行できるとは限りません。ローカル専用ツール、CLIアプリ、または複雑なシステムの場合:

1. 60〜90秒のビデオウォークスルーを録画する。
2. YouTubeにアップロードする (公開設定は「限定公開」で問題ない)。
3. 主要なインタラクションのGIFを作成する。
4. 両方をREADMEに配置する。

ビデオデモは、デモがないより10倍優れています。


コントリビューショングラフ

一貫性が示すもの

採用担当者はあなたのコントリビューショングラフに目をやります。彼らが実際にそこから読み取るものは次のとおりです。

パターン解釈
ほとんどの日が安定した緑「この人は定期的にコードを書いている。良い習慣だ。」
プロジェクトを中心に集まっている「集中したスプリントで作業している。普通だ。」
平日のみ緑「仕事があり、それでも個人作業をリリースしている。」
自分のリポジトリとコントリビューションの混合「協力的だ。個人プロジェクトだけではない。」

操作の見分け方

経験豊富なレビュー担当者は、これらを即座に見抜くことができます。

危険信号:
  - 完全に均一な緑 (毎日、同じ強度)
  - READMEの編集や空白の変更のみのコミット
  - 空のリポジトリへの1日500コミット
  - 1週間で作成された数十のリポジトリ、すべて単一コミット
  - 自動生成されたコミットボット

グラフを操作することは、ギャップがあることよりも悪いです。それは必死さと判断力の欠如を示します。本当の一貫性とは、ギャップがあっても、自分が気にかけていることに定期的なリズムで取り組むことです。

本当のグラフを構築する

偽装する代わりに:
  1. 1つのプロジェクトを選び、1日30分取り組む。
  2. オープンソースにコントリビュートする — ドキュメント、テスト、バグ報告でも構わない。
  3. メモや実験をコミットする学習リポジトリを維持する。
  4. 実際に使うツールを構築する。自然に改善し続けることになる。

ポートフォリオを希望する役割に合わせる

あなたのポートフォリオは、採用された場合に行う仕事のプレビューのように見えるべきです。ターゲットに合わせて調整します。

AIネイティブ開発の役割

これらの役割は、AIを使って構築し、AIのために構築できることを示すことを求めています。

シグナル例となるリポジトリ
ワークフローでのAIツールの使用.claude/ 設定、AI支援コミット、Claude Codeスラッシュコマンドを含むプロジェクト
エージェンティックワークフロー調査、計画、タスク実行を行うマルチステップエージェント
LLM統合構造化出力、プロンプトエンジニアリング、モデルルーティングを備えたアプリ
RAGと検索埋め込み検索と評価指標を備えた知識ベース
評価とテストLLM出力評価フレームワーク、プロンプト回帰テスト
AI支援開発AIツールがどのように開発を加速したかを文書化したプロジェクトREADME

役割別ポートフォリオターゲット

ターゲット役割必須リポジトリあると良いもの
AI/MLエンジニアファインチューニングモデル、評価フレームワーク、データパイプライン論文実装、モデル比較
フルスタックAI開発者LLM統合アプリ、RAGシステム、デプロイされたSaaSオープンソースコントリビューション、CLIツール
プラットフォーム/インフラエンジニアCI/CDパイプライン、IaCリポジトリ、監視設定パフォーマンスベンチマーク、OSSコントリビューション
開発者ツール/DXCLIツール、SDK/ライブラリ、VS Code拡張機能ドキュメントサイト、開発者コミュニティツール

ポートフォリオレビューチェックリスト

就職活動のたびにこの監査を実行します。正直に。

第一印象 (30秒)

  • プロフィール写真はプロフェッショナル (または意図的に特徴的)
  • 自己紹介文に自分の活動と探しているものが記載されている
  • ピン留めされたリポジトリに、第三者にも意味がわかる説明がある
  • 少なくとも3つのピン留めリポジトリのREADMEにスクリーンショットまたはデモリンクがある
  • 最初のページに恥ずかしいリポジトリ名が見えない

深さチェック (2分)

  • ピン留めされた各リポジトリに、何を、なぜ、どのようにを説明するREADMEがある
  • 少なくとも1つのプロジェクトにライブデモまたはデプロイリンクがある
  • ピン留めされたリポジトリのコード品質が現在のスキルレベルを反映している
  • コミット履歴が実際の開発を示している (単一の「initial commit」ブロブではない)
  • 少なくとも1つのリポジトリがテストまたはCI/CDを示している

ストーリーチェック (5分)

  • ピン留めされたリポジトリが、あなたのスキルについて一貫したストーリーを語っている
  • 古いプロジェクトから新しいプロジェクトへの目に見える進歩がある
  • ポートフォリオがターゲットとする役割に合致している
  • ピン留めされた各リポジトリを60秒のエレベーターピッチで説明できる
  • このGitHubを見て、自分自身を採用したいと思う

究極のテスト

シークレットウィンドウで自分のGitHubを開きます。あなたに会ったことのない採用担当者になったつもりで、60秒間費やします。この候補者を次のラウンドに進めますか?

答えが即座に「はい」でない場合は、繰り返し改善を続けてください。


アンチパターン

アンチパターンなぜ有害か修正方法
変更のないフォークリポジトリ水増しのように見える削除するか非公開にする
チュートリアルのクローン (「todo-app」、「weather-app」)構築できることではなく、指示に従ったことを示すフォークして、チュートリアルをはるかに超えて拡張する
空のリポジトリまたはREADMEのみのリポジトリ放棄されたアイデアを示すアーカイブまたは削除する
公開リポジトリにREADMEがない「自分の仕事についてコミュニケーションしない」公開しておくすべてのものにREADMEを追加する
厳選されていない50以上の表示リポジトリ圧倒的なノイズ、シグナルなし積極的にアーカイブし、戦略的にピン留めする
古いピン留めリポジトリ (2年以上前)「最近何も構築していない」最近の作業を示すためにピンをローテーションする
自動生成された統計情報のみのプロフィールREADME非人間的、努力不足焦点と目標を書いた本当の自己紹介文を書く
「test」、「temp」、「asdf」という名前のリポジトリ不注意名前を変更するか削除する

パワームーブ

「[あなたのGitHub URL] で私のGitHubポートフォリオをレビューしてください。AIネイティブ開発の役割の採用担当者として評価してください。ピン留めされた各リポジトリを、READMEの品質、技術的な深さ、デプロイ状況、AI/MLの役割への関連性で採点してください。その後、優先順位付けされたアクションプランを教えてください。何をアーカイブすべきか、何を改善すべきか、何が欠けているか、そして最大の違いを生む新しいプロジェクトはどれか。」

エージェントはあなたのポートフォリオ批評家となり、GitHubをコードの墓場からキャリア資産に変えるために必要な、正直で具体的なフィードバックを提供します。

関連スキル

スキル使用するタイミング
github-profileGitHubプラットフォームの仕組みを実装する — プロフィールREADME、リポジトリのピン留め、トピック、アクティビティグラフ
career-resumeキャリアライフサイクル全体 — 就職活動、面接、オンボーディング、パフォーマンスレビュー

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

MikeCheng1208/BattleTree

Index-based file discovery using ABOUTME headers. Use INSTEAD of grep or Explore agent when searching for files by purpose or feature. Faster and more accurate than scanning code. Invoke this skill when user asks "which files handle X", "where is Y implemented", or when you need to find files related to a feature or task.

MikeCheng1208/BattleTree

Factor modeling and portfolio construction (Markowitz, Black-Litterman, constraints, turnover).

MikeCheng1208/BattleTree

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

MikeCheng1208/BattleTree

Analyze the CustomGPT.ai Labs Innovation workbook and cost tracking data to surface portfolio-level insights, trends, and recommendations for where to focus Innovation efforts.

MikeCheng1208/BattleTree

Personal meta-skill for Arach. Use this as the entry point to understand arach's projects, conventions, and available skills. Activates on "arach's projects", "what does arach work on", or when working in any arach/* repo.

MikeCheng1208/BattleTree

High-converting landing pages. Copy + design + implementation. Triggers: landing page, conversion page.

MikeCheng1208/BattleTree

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios,...

MikeCheng1208/BattleTree

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

MikeCheng1208/BattleTree

Minimalist, typography-focused portfolio design system inspired by neo-brutalist and Swiss design principles. Emphasizes bold typography, generous whitespace, monochromatic color schemes, and elegant simplicity for developer/designer portfolios.

MikeCheng1208/BattleTree

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

MikeCheng1208/BattleTree

Optimize project portfolio selection under constraints using mathematical optimization

MikeCheng1208/BattleTree

Detect and explain risk drift in lending portfolios over time using vintage analysis, migration matrices, and concentration metrics. Use when monitoring portfolio credit quality trends, preparing board risk reports, conducting stress testing, or when risk metrics deviate from appetite thresholds.

関連スキル