career-ops 使用教學：用 Codex 或 Claude Code 管理求職流程

career-ops 是一個在本機 AI 程式設計 CLI 中執行的求職工作區。它把職缺收集、職位評分、履歷調整、公司研究、PDF 輸出和應徵追蹤放在同一個目錄，讓 Codex、Claude Code、OpenCode 等工具根據你的真實資料協助工作。

它不會替你自動獲得工作，也不應該被用來捏造經歷或無差別大量投遞。它真正解決的是檔案版本混亂、不同職缺重複整理，以及應徵後缺少狀態記錄等流程問題。

安裝前準備

最快的安裝方式依賴 Node.js 和 npx。先檢查：

1
2
3


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

另外準備一份 Markdown 或純文字格式的真實履歷。不要把身分證號、家庭地址、證件掃描檔等與職缺分析無關的資訊放進專案目錄。

如果要產生 PDF，還需要 Playwright Chromium；只做職缺分析和文字修改時可以稍後安裝。

一行命令初始化

官方提供的初始化命令是：

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 沒有報錯」更能說明環境是否可用。它會檢查專案需要的前置條件；如果 doctor 失敗，應根據具體項目修復，不要先刪除整個目錄重新安裝。

設定個人資料和目標公司

手動初始化時，可以從範例設定複製：

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 流程，列出產生的檔案路徑，以及仍需人工確認的所有欄位。

最後讓 Agent 更新追蹤狀態：

1

執行 tracker 模式，記錄今天的應徵狀態、下一次追蹤日期和待辦事項。

建議的實際工作流程

不要收到職缺連結後就直接產生履歷。更可靠的順序是：

保存職缺原文或 URL，記錄取得日期。
先評估必要條件、職責和風險訊號。
明確區分已符合、僅有相近經驗，以及真正缺少的條件。
只調整履歷中相關事實的排序和表達。
檢查每個數字、技能和專案是否能由原始資料證明。
匯出 PDF 後人工檢查分頁、字型、連結和聯絡方式。
投遞後更新狀態及下一次追蹤日期。

這樣可以避免 AI 為了提高匹配分數而擅自補上不存在的經歷。

常見故障

找不到 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，檢查頁數、換行、字型和可點選連結，不能只憑命令結束碼判斷成功。

隱私和真實性底線

career-ops 在本機目錄執行，但你使用的 AI CLI 可能把上下文傳送到雲端模型。提交資料前應查看所用服務的資料政策，並刪除工作不需要的身分資訊。

AI 可以重排和改寫已經存在的事實，但不能替你創造任職年資、學歷、證照、客戶名稱或績效數字。自動化的目標是減少重複工作，不是大量製造看起來高度匹配的申請。