AIツール

career-opsの使い方：CodexまたはClaude Codeで就職活動を管理する

career-opsを導入し、事実に基づく履歴書、希望職種、企業リストを設定して、CodexやClaude Codeで求人評価、履歴書調整、PDF生成、応募追跡を行います。

career-opsは、AIコーディングCLI内で動作するローカルの就職活動ワークスペースです。求人収集、職種評価、履歴書調整、企業調査、PDF出力、応募追跡を1つのディレクトリにまとめ、Codex、Claude Code、OpenCodeなどが本人の実データを基に支援できるようにします。

このツールが自動的に仕事を獲得してくれるわけではありません。経歴の捏造や無差別な一括応募にも使うべきではありません。実際の価値は、ファイルの版管理、求人ごとの重複作業、応募後の追跡漏れを減らすことにあります。

インストール前の準備

最も速い導入方法ではNode.jsと npx を使います。最初に確認します。

1
2
3

node --version
npm --version
npx --version

Markdownまたはプレーンテキスト形式の、事実に基づく履歴書も用意します。身分証番号、自宅住所、証明書のスキャンなど、求人分析に不要な情報をプロジェクトディレクトリへ置かないでください。

PDF生成にはPlaywright Chromiumも必要です。求人分析と文章編集だけを行うなら、後から追加できます。

1コマンドで初期化する

公式の初期化コマンドは次のとおりです。

1

npx @santifer/career-ops init

最新リリースが現在の場所の career-ops ディレクトリに配置され、依存関係がインストールされます。そのディレクトリへ移動し、実際に使うAgentを起動します。

1
2

cd career-ops
codex

最後のコマンドを次に変更することもできます。

1

claude

初回はAgentに履歴書、プロフィール、希望職種の設定を案内させます。本物の個人情報を移す前に、架空または機密性の低いサンプルで一連の処理を確認してください。

手動インストールと環境診断

自動初期化が失敗する場合は手動で実行します。

1
2
3
4

git clone https://github.com/santifer/career-ops.git
cd career-ops
npm install
npm run doctor

PDFが必要になった時点でブラウザをインストールします。

1

npx playwright install chromium

npm run doctor は、ディレクトリが存在することや npm install が終了したことよりも有効な検証です。必要な前提条件を確認するため、失敗した場合は表示された項目を修復し、すぐにプロジェクト全体を削除して再インストールしないでください。

プロフィールと対象企業を設定する

手動セットアップではサンプル設定をコピーします。

1
2

cp config/profile.example.yml config/profile.yml
cp templates/portals.example.yml portals.yml

Windows PowerShellでは次を使います。

1
2

Copy-Item config/profile.example.yml config/profile.yml
Copy-Item templates/portals.example.yml portals.yml

プロジェクトルートに cv.md を作成し、次の原則を守ります。

  • cv.md には事実である経歴、プロジェクト、スキルだけを書く。
  • 希望職種、好み、制約は profile.yml に保存する。
  • 対象企業や求人ソースは portals.yml で管理する。
  • 元の履歴書は別途バックアップし、AI編集版はバージョン管理する。
  • API Key、求人サイトのパスワード、CookieをGitへコミットしない。

Codexでの使い方

Codexではスラッシュコマンドは不要です。自然言語でモードを指定できます。最初は評価だけを依頼します。

1

この求人票を読み、career-opsのscanモードを実行してください。必須条件、合致する点、不足点を説明し、履歴書は変更しないでください。

応募する価値があると判断してから次へ進みます。

1

cv.mdを基に、この求人向けの調整版を作成してください。元の履歴書にないスキル、数値、経歴を追加せず、先に変更点を示してください。

資料生成が必要な場合は次のように依頼します。

1

直近で評価した求人についてPDFワークフローを実行し、生成ファイルのパスと、人による確認が必要な全項目を列挙してください。

最後に応募状態を更新します。

1

trackerモードを実行し、今日の応募状態、次回フォロー日、未完了タスクを記録してください。

推奨する実務フロー

求人URLを受け取ってすぐに履歴書を生成しないでください。次の順序が安全です。

  1. 求人原文またはURLを保存し、取得日を記録する。
  2. 必須条件、業務内容、警戒すべき点を評価する。
  3. 証明できる合致、近い経験、本当の不足を分ける。
  4. 履歴書内の関連する事実の順序と表現だけを調整する。
  5. すべての数値、スキル、プロジェクトが元資料で裏付けられるか確認する。
  6. PDFを開き、改ページ、フォント、リンク、連絡先を目視確認する。
  7. 応募後に状態と次回フォロー日を更新する。

この順序により、Agentが適合度を上げるために存在しない経験を補う問題を防げます。

よくある問題

npxがない、または古すぎる

現在サポートされるNode.jsをインストールし、端末を開き直します。システム版Node、nvm、複数の個別インストールを混在させると、node、npm、npx が異なるバージョンを参照する場合があります。

npm installは成功するがdoctorが失敗する

npm run doctor の具体的な出力を確認します。PDF関連の失敗はPlaywright Chromiumの未導入が原因であることが多いです。設定関連では、サンプルファイルのコピー、YAMLのインデント、cv.md の配置場所を確認します。

PDFが空、またはレイアウトが崩れる

まずブラウザが導入済みか確認します。

1

npx playwright install chromium

短い履歴書で再テストし、生成されたPDFを実際に開きます。ページ数、折り返し、フォント、クリック可能なリンクを確認し、終了コードが0という理由だけで利用可能と判断しないでください。

プライバシーと事実性

career-ops自体はローカルディレクトリで動作しますが、利用するAI CLIはコンテキストをクラウドモデルへ送信する場合があります。サービスのデータポリシーを確認し、作業に不要な個人情報は削除してください。

AIは既存の事実を並べ替え、表現を改善できますが、在職期間、学歴、資格、顧客名、実績数値を作ってはいけません。自動化の目的は反復作業を減らすことであり、見かけ上だけ高く適合する応募を量産することではありません。

参考資料