はじめに

GitResume を使えば、YAML で履歴書を書いて GitHub にプッシュするだけで、美しい PDF と Web ページが自動生成されます。以下はゼロから始める完全ガイドです。

1. ログイン

gitresume.co にアクセスし、GitHub または Google アカウントでワンクリックログイン。別途アカウント登録は不要です。

2. ユーザー名を選択

ユーザー名はログインアカウントから自動的に設定されます。既に使用されている場合は、初回設定時に手動で選択する必要があります。これは公開履歴書 URL の一部になります：gitresume.co/@username/slug。ユーザー名は一度設定すると変更できません。

3. リポジトリへのアクセスを許可

GitResume が GitHub リポジトリにアクセスして履歴書ファイルを読み取り、自動ビルドするためにアクセス許可が必要です。GitHub の認可ページに遷移し（GitHub App の仕組みを利用）、履歴書を含むリポジトリだけに許可を与えることができます。すべてのリポジトリを開放する必要はありません。

認可後はいつでも GitHub の設定から、GitResume がアクセスできるリポジトリの範囲を変更できます。

4. プロジェクトを作成

ダッシュボードで「プロジェクト作成」をクリックします。2 つの方法があります：

  • 既存のリポジトリを選択 — 認可済みのリポジトリ一覧から選択
  • テンプレートから新規作成 — resume-template を使ってすぐに作成。サンプルの resume.yaml が含まれています

次に以下を入力します：

  • プロジェクト名 — ダッシュボードに表示される名前
  • Slug — 公開 URL（例：gitresume.co/@username/slug）
  • ブランチ — 監視する Git ブランチ（デフォルト：main）
  • Resume パス — リポジトリ内の YAML ファイルのパス（デフォルト：resume.yaml）

5. YAML を書く

お好みのエディタ（VS Code、Vim、AI ツールなど）で resume.yaml を編集します。すべてのフィールドの詳細は YAML Schema Reference を参照してください。

最も基本的な YAML 構造：

personalInfo:
  name: 山田太郎
  title: ソフトウェアエンジニア
  email: [email protected]
  location: 東京, 日本

sections:
  - type: summary
    content: >-
      3年の経験を持つフルスタックエンジニア。React と Go に精通。

  - type: experience
    items:
      - position: ソフトウェアエンジニア
        organization: Example Corp
        startDate: "2022-01"
        description: |
          - コア製品の開発・保守
          - **React** と **Go** によるマイクロサービス構築

  - type: skills
    items:
      - category: プログラミング言語
        items: [TypeScript, Go, Python]

6. ビルド

ビルドをトリガーする方法は 2 つあります：

  1. 自動ビルド — 指定ブランチへの git push のたびに、Webhook で自動的にビルドがトリガーされます
  2. 手動ビルド — プロジェクトページの「今すぐビルド」ボタンをクリック

ビルド完了後、PDF と HTML の両方が同時に生成されます。

7. 成果を確認

ビルド成功後、ダッシュボードで以下が可能です：

  • PDF ダウンロード — そのまま提出できる履歴書ファイルを取得
  • HTML プレビュー — Web ページ版の履歴書を確認
  • 公開 — gitresume.co/@username/slug に公開し、共有可能なリンクを取得

次のステップ