katazuku-shukatsu

就活の「めんどい」を、あなたのPCの中で片づける。 メールの見張り・予定の登録・提出物の追跡・面接の前夜準備を自動で回し、 「送る・出す・決める」だけをあなたに残す、オープンソースの就活オートパイロットです。

現在はターミナル操作とGoogle Cloudの設定が必要な開発版です。 認証なしのデモで画面を試せます。自分のデータで使う場合は、接続確認と定期実行の登録まで必要です。

カタヅク就活の公式HPでは、ブラウザだけで試せる機能、無料OSSの導入方法、個別導入支援、開発への参加方法を案内しています。

紹介動画(準備中): 公開したらここにリンクを置きます。

English / デモで試す / セットアップ / AIプロバイダ / 参加方法

架空データから集計CSVを作り、Databricksで分析を試す手順は Databricksガイド にまとめています。正本DBや個人情報は自動送信しません。

---

あなたはどちら?

使いたい人(ターミナル操作あり)	開発に参加したい人
1. デモで画面を見る(アカウント接続なし)	1. CONTRIBUTING.md を読む
2. docs/SETUP.md の順に、Google と AI をつなぐ	2. docs/ARCHITECTURE.md で全体像をつかむ
3. 毎日のワークフローを登録して、朝のまとめを待つ	3. 最初の貢献ガイド から課題を選んで参加する

Windowsポータブル試用版は、Node/npmなしで初回設定と架空データの8画面閲覧を開けます。 ビルド・実機検証と対応範囲を確認してください。Google本人認証・実同期・定期登録・コード署名は未検証または未対応です。

AIの利用料は、あなた自身の ChatGPT プラン(Sign in with ChatGPT)・Claude Code・Codex、または API キーで払います。 katazuku 側のサーバや課金はありません。正本DBとローカルの閲覧データは、あなたのPCに保存します。 Googleとの通信や、選択したAIプロバイダへの情報送信は発生します。AIへ渡す情報は各ワークフローの --dry-run と AIプロバイダ で確認できます。

何ができるか

機能	中身	AI	つなぐもの
メール見張り(毎時)	未読を見張り、面接案内・結果・提出依頼など緊急なものだけ返信下書き・カレンダー登録・通知	ツールを使えるAI(Claude Code / Codex)	Gmail・カレンダー
毎朝の選考同期	メールを読み取り専用で取得 → AIが選考の動きを構造化 → 検証してから正本DBへ反映	どれでも(ChatGPT プラン / API キーも可)	Gmail
きょうやること(毎朝)	本人がやることを最大3件に。送り忘れの下書き・締切の作業ブロック(時刻入り)・故障報告	ツールを使えるAI	Gmail・カレンダー
前夜ブリーフ(毎晩)	明日の面接の相手・前回の記録・想定問答をまとめる。予定が無い日はAIを呼ばない	ツールを使えるAI	Gmail
カレンダー同期(30分)	カレンダー → 正本DB。空き判定は「空き / 重複 / 不明」で、情報不足を空きと扱わない	不要(判断が要る予定だけAI)	カレンダー
提出物台帳	誓約書・証明書・ES などを成果物1件ずつ追跡し、完了するまで毎日再評価	不要	—
番犬(4時間)	自動処理が止まっていないか・AIの利用枠が全滅していないかを見張る	不要	—
ハーネス改善ループ	run台帳を匿名化した最小観測へ変え、失敗を合成回帰caseにしてbaseline比較する。合格候補も人がrevisionを確認するまで反映しない	不要	—
閲覧アプリ8本	きょう / 選考 / 企業 / メール / 人 / 面接準備 / プロフィール / 効果	不要	—
面談の録音(任意・Windows)	オンライン面談を相手の声つきで録る	不要	—
安全なローカルログイン(任意・Windows)	DPAPIで保護した資格情報を隔離Chromeへだけ入力。origin・テナントパスを再検査し、MFA/CAPTCHA/規約同意では停止	不要	本人が登録した採用サービス
ブラウザ操作計画(開発者向け)	生値・任意JavaScriptなしの型付き計画。dry-runは無操作、実行は正本・本人承認hash・外部冪等キー・再照合が一致した専用Executorだけ	不要	規約確認済みのサイトadapter
Gemini Spark 連携(任意)	スマホから予定・選考状況を聞く	不要	自分の Cloudflare
katazuku MCP(任意)	Muse・Codex・Claude Codeから正本を読み、明示scopeで冪等入力と承認提案を行う。利用者のMuseアカウントが対象メールボックスに対応する場合は、毎回承認・action hash・Sent再照合付きのemail connector経路を使える。未対応のiCloudはprivate adapterへ分離する。フォーム提出と採用ポータル送信も、汎用workflow契約で本人承認・外部冪等キー・監査を必須にする。remote用OAuth gatewayもセルフホスト可能	不要	対応MCPクライアント・任意で自分のCloudflare

詳しい動きは docs/WORKFLOWS.md、AIの選び方は docs/AI-PROVIDERS.md。 MCPはMCPガイド、MuseはMuse接続ガイド、安全なWindowsログインはローカル認証ブローカー、ブラウザ実行の共通境界はブラウザ操作計画、運用を失敗から改善する仕組みはハーネス改善ループを参照してください。private版との差と意図的な秘密境界は追随台帳に固定しています。

やらないこと(コードで止めている安全境界)

• 定常処理は第三者へ自動送信しない。 通常は下書きまで。明示的に固定した宛先・本文を本人が承認した場合だけ、専用ExecutorまたはMuseの毎回承認付きemail connectorが同じaction hashを一度実行し、Sentを再照合する。
• 定常処理や一般MCPはES・エントリー・フォームの送信、予約確定、辞退を実行しない。 本人が固定内容を承認し、正本・action hash・外部冪等キー・直前再照合が一致した専用Executorだけが1回実行できます。
• Web適性検査・コーディングテストの代理受験はしない。
• AIにデータベースを直接書かせない。AIの出力は形と網羅性を検証してから、決まった規則で反映します。

詳しくは SECURITY.md。

しくみ

flowchart LR
  G[("Google<br/>Gmail / Calendar")]
  A["外部AI provider<br/>ChatGPT プラン / Claude Code / Codex / API"]
  subgraph PC["あなたのPC(正本・実行・閲覧)"]
    direction TB
    S["スケジューラ<br/>タスクスケジューラ / cron / launchd"] --> W["ワークフロー<br/>scripts/workflow.ts"]
    W -->|自分のOAuthで読み取り| G
    W -->|プロンプト| A
    A -->|厳格JSON| V["検証<br/>Schema・網羅性・暴走ブレーキ"]
    V --> DB[("正本DB<br/>SQLite 1ファイル")]
    DB --> SNAP["snapshot.json"] --> APPS["閲覧アプリ8本<br/>(見る窓)"]
    A -.->|下書き・予定作成だけ| G
  end
  YOU(["あなた"]) -->|送る・出す・決める| G

• 正本は1つ(ローカルの SQLite)。アプリ・カレンダーは「見る窓」です。
• 戻せる。 バックアップはSQLite整合性と参照を検査して既存ファイルを上書きせず作り、復元も稼働中の正本を置換せず新しいパスへ作ります。
• 書き手はエージェントだけ。 状態は遷移規則(transition())を必ず通して更新し、変化は台帳に残ります。
• AIは取り替えられる。 未ログイン・利用枠切れなど「何もしていない失敗」のときだけ、次のAIへ切り替えます。

デモで試す(資格情報ゼロ)

Node.js 22.13以降の22系、または24以降(推奨 24)が必要です。

git clone https://github.com/kokotatan/katazuku-shukatsu.git
cd katazuku-shukatsu
npm run demo

架空のデータでホーム画面がブラウザに開きます。8画面へ同じローカルURLから移動できます。 アカウント接続もAIも使いません。初回は8画面の依存導入・ビルドがあるため数分〜十数分かかります。 2回目からは既存ビルドを使い、ソースが変わった画面だけビルドし直します。パッケージ取得にはインターネットが必要です。 別のアプリから始めるなら npm run demo -- insight。ブラウザを自動で開かない場合は --no-open、 ポートが使用中なら npm run demo -- --port 4174 を使います。停止は Ctrl+C。

デモは実データや正本DBを読みません。自分のデータを見るときはセットアップ後に npm start を実行します。 朝のまとめ・前夜の準備はホーム、成果物ごとの未完了提出物は「今日やること」から確認できます。

ほかに手元で試せること:

npm test                                 # 架空データで全部の規則を検証
npm run seed                             # 架空の正本DBを組み立てて表示
npm run workflow -- asa --dry-run        # 朝のまとめのプロンプトと、使うAIの順番を表示(外部に触れない)

自分のデータで使う

docs/SETUP.md の順に進めます。流れは次のとおりです。

最初に npm run init を実行すると、リポジトリ外のOS利用者別領域へ空の正本DBを作成します。 再実行しても既存データを消さず、必要なマイグレーションだけを適用します。保存先を変える場合は KATAZUKU_DB、または npm run init -- /absolute/path/to/katazuku.db を使います。

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗