DanielPan12/JobHuntBot

JobHuntBot – AI支援による求職応募ワークフロー

機能概要

• AIコーディングアシスタント（Claude Code, Codex CLI, Cursorなど）が求職活動、応募フォームの入力、進捗管理を支援するための構造化されたワークフローを提供します。
• コアとなる指示は SKILL.md に記述されています。エージェントはこのファイルを読み取り、いくつかの必須事項をユーザーに尋ねた上で、テンプレート（プロフィール、ルール、履歴書ルーティング、回答/経験バンクなど）のパーソナライズされたコピーを作成します。
• 軽量なローカルダッシュボード（静的HTML + 小規模なNode.jsサーバー）により、4つのビュー（応募済み、保留中、不採用、内定）と、面接やその他のイベントのための7日間のカレンダーを可視化します。すべてのデータはシンプルなCSVファイルに保存され、ダッシュボードが直接読み書きを行います。

主要コンポーネント

フォルダ / ファイル	役割
SKILL.md	エージェントレベルのワークフローと安全契約 – AIアシスタントの入り口。
references/	詳細なプレイブック（セットアップ、求人発見、応募処理、安全ルール）。
templates/	個人プロフィール、応募ルール、履歴書選択、再利用可能な回答、経験スニペット、CSVダッシュボードスキーマ用の空のJSON/MDテンプレート。
dashboard/	CSVデータを表示・安全に更新するための最小限のNodeサーバー (server.js) とUI (dashboard.html)。
scripts/ & tests/	検証スクリプト、回帰テスト、および個人データの誤公開を防ぐための公開パッケージチェック。

仕組み

1. エージェントの準備 – ブラウザ自動化ツール（Playwright MCP）を提供し、実際の応募ページと対話できるようにします。
2. プライベートワークスペースの作成 – テンプレートをコピーし、履歴書、成績証明書、プロジェクトノートなどを追加します。
3. ワークフローの開始 – エージェントに「SKILL.md を使用して求職活動を初期化して」と伝えます。エージェントが個人ファイルを埋めます。
4. 安全な試行の実行 – エージェントに求人情報の発見とダッシュボードの更新のみを行わせます。フォーム送信は行われません。
5. ダッシュボードを開く – 提供された起動スクリプトを実行します。UIに現在の求人プールが表示され、結果の記録や面接イベントのスケジュール設定が可能になります。
6. 完全な応募 – エージェントがブラウザツールを使用してフォームを入力し、履歴書をアップロードします。ユーザーが明示的に送信を承認した後、応募が完了します。すべての更新はCSVファイルに書き戻されます。

安全性とプライバシー

• ワークフローは厳格な境界を強制します。エージェントは身元、就労許可、給与を推測したり、経験を捏造したりしてはならず、CAPTCHAを回避したり未知の資格情報でログインしたりすることはできません。
• 最終的な送信には明示的なユーザー承認が必要です。既存の承認は元のスコープ内でのみ再利用されます。
• リポジトリには空のテンプレートのみが含まれています。ユーザーは、入力されたデータを非公開に保ち、公開リポジトリにプッシュしないよう警告されています。

対象ユーザー

• LLM搭載のコーディングアシスタントを使用することに慣れており、「ワンクリック大量応募」ボットではなく、再現可能で監査可能なプロセスを求める求職者。
• 透明性が高く、検査・バージョン管理が可能で、完全にオンプレミスで実行できるファイルベース（CSV + JSON）のシステムを好む開発者。

ライセンス

• MITライセンス。Yvonne He氏のオープンソース ApplyPilot ワークフローから派生。

---

すべての詳細はREADMEから直接引用したものであり、追加機能の推論は含まれていません。