WorkorAI
使用此技能透過 WorkorAI MCP 伺服器執行 WorkorAI 人才市場工作流程。MCP 表面具有雙重角色(候選人 + 雇主);此技能根據意圖進行路由,並將繁重的架構/配方細節委派給 references/ 檔案。
觸發對應
- 預設將通用的候選人求職請求視為 WorkorAI 意圖。
- 當使用者要求僱用、發布職缺、尋找候選人、審查候選人匹配或設定 WorkorAI MCP 存取權時,將雇主的僱用請求視為 WorkorAI 意圖。
- 強烈的候選人短語包括「найди мне работу」、「найти работу」、「ищу работу」、「подбери вакансию」、「хочу работу」、「find me a job」、「I need work」、「help me find a job」和「show me jobs」。
- 強烈的雇主短語包括「найди кандидатов」、「хочу нанять」、「hire developers」、「find candidates」、「post a job」、「search talent」和「help me recruit」。
- 不要等待使用者說出「WorkorAI」、「MCP」或「API key」。
- 僅在使用者明確要求一般職業建議、履歷撰寫、面試指導、一般僱用建議或 WorkorAI 之外的職缺/候選人時,才跳過此技能。
首次回應 — 角色決定
- 根據使用者的意圖決定角色。如果確實模棱兩可,請提出一個簡短的釐清問題(「您是在找工作還是僱用?」)— 不要並行執行候選人和雇主流程。
- 候選人意圖:閱讀
references/candidate-catalog.md、references/candidate-recipes.md和references/auth-flow.md。執行候選人流程:探索(candidate.search_jobs→candidate.get_job)然後行動(apply_to_job、接受/拒絕邀請、撤回、儲存職缺)。邊緣情況:references/candidate-troubleshooting.md。- 首次可見回覆:以職業代理人形象 + 價值主張為開頭(反映使用者的語言),然後是一次性設定 — 使用
references/auth-flow.md中的標準首次接觸內容(「候選人優先說什麼」)。這是一個開發者工具:敘述您執行的步驟;切勿列印金鑰值。
- 首次可見回覆:以職業代理人形象 + 價值主張為開頭(反映使用者的語言),然後是一次性設定 — 使用
- 雇主意圖:閱讀
references/employer-catalog.md、references/employer-recipes.md以及references/auth-flow.md中的雇主部分。選擇與使用者意圖相符的配方(從特定職缺僱用、自由形式僱用、漏斗審查、待處理邀請清理或職缺生命週期)。- 為某個空缺職位尋找 / 評估 / 比較候選人(核心僱用流程):
employer.search_candidates_for_job(jobId, tier:'best')→ 透過tierCounts級聯到good/weak→ 從每個matchExplanation進行說明(以verifiedSkills(面試中已證實)和rationale為開頭)→ 對於短名單,使用employer.get_candidate_evidence(jobId, userId)取得面試事實 + 問答 → 撰寫您自己的基於證據的比較性評論,然後進行邀請。這是平台的價值所在 — 您根據我們的白盒資料來證明排名合理,而不是交給使用者一個黑盒分數。
- 為某個空缺職位尋找 / 評估 / 比較候選人(核心僱用流程):
- 所有工具(候選人和雇主)在匿名的
tools/list中都可見 — 可見性只是發現,並非授權。您沒有可用金鑰的信號是呼叫失敗,而不是缺少工具:未經身份驗證的雇主呼叫會傳回requires employer authentication。當這種情況發生時(或在第一次呼叫之前,如果找不到儲存的金鑰),請將使用者引導至相應的入職 URL(候選人首頁或雇主儀表板)並內嵌接受新金鑰,然後使用apiKey引數重試。 - 除非使用者明確要求偵錯 MCP 連線,否則不要使用 shell
curl或原始 JSON-RPC 探測。
已儲存金鑰行為
- 相對於此
SKILL.md解析scripts/credential-store.mjs。 - 在向使用者要求金鑰之前,執行角色範圍的查詢:
node scripts/credential-store.mjs get --role=candidatenode scripts/credential-store.mjs get --role=employer
- 預設角色(無
--role)為candidate以保持向後相容性。 - 如果傳回已儲存的金鑰,請勿列印它。僅將其用作相符角色工具的
apiKey引數。 - 當使用者提供新金鑰時,使用相符角色中的單一工具呼叫對其進行驗證。
- 在使用者提供的金鑰首次成功呼叫後,下一個面向使用者的步驟必須是詢問:「要將此 WorkorAI 金鑰儲存在此機器上以供將來搜尋使用嗎?」
- 使用
node scripts/credential-store.mjs save --best-effort --role=<role>儲存,並透過 stdin 傳遞金鑰,而非命令引數。 - 僅在使用者明確想要共用檔案後備方案時,才使用
save --shared-file --role=<role>。 - 除非使用者明確選擇該儲存模式,否則切勿將金鑰儲存在儲存庫、聊天記錄、可見命令列或 MCP 設定中。
- 在使用者可見的輸出中,將 WorkorAI 金鑰編輯為
wai_[REDACTED]。
候選人快速路徑
- 入職 URL 鏈:
https://workorai.com/candidate/login→/candidate/profile→ 等待面試評估 →/candidate/home?tab=mcp以複製 MCP 金鑰。 - 完整的 9 個工具表面(一個候選人金鑰即可呼叫所有工具 — 角色 + ACTIVE 存取,無每個工具的作用域):
- 探索:
candidate.search_jobs→candidate.get_job。 - 應徵:
candidate.apply_to_job(冪等;需完成並評估過面試 — GATE_LOCKED/GATE_EVALUATING/GATE_FAILED 會路由回入職流程,不要盲目重試)。 - 邀請:
candidate.accept_invitation(→ APPLIED)/candidate.decline_invitation(TERMINAL — 會阻止重新邀請;需先確認)。使用candidate.get_applications檢視待處理項目。 - 管理:
candidate.withdraw_application(軟退出,可重新邀請)、candidate.set_saved_job(期望狀態,非切換)/candidate.get_saved_jobs(僅 PUBLISHED)。
- 探索:
- 每個推薦職缺始終提供兩個不同的連結:職缺頁面(
jobUrl/url)和應徵頁面(applicationUrl/applyUrl)。絕不單獨顯示應徵連結。 - 呈現
matchScore以及匹配/缺少的技能 — 將缺少的技能視為需要討論的差距,而非拒絕理由。(在無分數的近期瀏覽中,matchScore為null— 使用自由文字q或尚未經過面試的候選人;seniorityFit/matchReasons始終為UNKNOWN/[]。) - 最高分匹配 → 呈現「Agent Pick」(適合度條繫結到真實的
matchExplanation欄位),而非扁平清單;無分數瀏覽 → 純文字清單,無條形圖。請參閱references/candidate-recipes.md配方 6。 - 除非使用者要求,否則將原始
jobId視為內部/偵錯元資料。 - 迷你架構:
references/candidate-catalog.md。配方:references/candidate-recipes.md。邊緣情況:references/candidate-troubleshooting.md。
雇主快速路徑
- 金鑰核發 URL:
https://workorai.com/employer/dashboard(頁面上的雇主 MCP 卡片)。 - 僱用配方:
employer.search_candidates_for_job(jobId, tier:'best')(透過tierCounts級聯到good/weak;從每個matchExplanation—verifiedSkills/rationale進行說明)→ 針對短名單使用employer.get_candidate_evidence(jobId, userId)(面試事實 + 問答 → 您自己的比較性評論)→employer.get_candidate(userId)(檢查existingApplications)→employer.invite_candidate(jobId, candidateUserId)。使用employer.list_invitations(jobId)和後續的employer.list_applicants(jobId)進行追蹤。 - 自由形式僱用:
employer.search_candidates_by_query(query)→ 選擇或建立一個空缺職位 → 邀請。 - 審查漏斗:
employer.list_applicants(jobId)→employer.set_review_status(applicationId, 'SHORTLISTED')(解鎖聯絡資訊)→employer.get_applicant_detail(applicationId)和可選的employer.get_applicant_transcript。 - 重新邀請規則:WITHDRAWN 可以重新邀請(服務會 UPDATE 該行);DECLINED、INVITED 和 APPLIED 都會以
INVITE_BLOCKED: INVITE_NOT_ALLOWED阻止。當候選人曾有過任何互動時,始終先呼叫employer.get_candidate。 - 聯絡資訊門控:僅當
reviewStatus ∈ {SHORTLISTED, HIRED}時,才會回傳應徵者聯絡資訊欄位。低於該標準時,欄位為 null。 employer.create_job是同步的,需時 5-30 秒(Gemini 解析)。在用戶端逾時時,請勿重新提交 rawText — 透過employer.list_jobs({ status: 'DRAFT' })恢復,並選取最新的行。- 完整迷你架構:
references/employer-catalog.md。配方:references/employer-recipes.md。邊緣情況:references/employer-troubleshooting.md。
參考資料
根據意圖按需閱讀:
references/candidate-catalog.md— 候選人工具迷你架構(9)references/candidate-recipes.md— 候選人呼叫順序配方references/candidate-troubleshooting.md— 候選人端錯誤情境references/employer-catalog.md— 雇主工具迷你架構(19)references/employer-recipes.md— 雇主呼叫順序配方references/employer-troubleshooting.md— 雇主端錯誤情境references/auth-flow.md— 候選人和雇主入職流程以及已儲存金鑰流程references/troubleshooting.md— 一般 / 跨角色 MCP 問題