WorkorAI
WorkorAI 人材マーケットプレイスのワークフローを、WorkorAI MCP サーバーを通じて利用するためのスキルです。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 外の求人/候補者を求めている場合にのみ、このスキルをスキップします。
最初の応答 — ロールの決定
- ユーザーの意図からロールを判断します。本当に曖昧な場合は、簡単な確認質問を1つ行います(「仕事をお探しですか?それとも採用をご希望ですか?」)。求職者フローと雇用者フローを並行して実行しないでください。
- 求職者(キャンディデート)の意図:
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から EXPLAIN する(verifiedSkills(面接で確認済み)とrationaleを前面に出す)→ ショートリストに対しては、employer.get_candidate_evidence(jobId, userId)で面接の事実と Q&A を取得 → エビデンスに基づいた独自の比較レビューを作成し、その後招待します。これがプラットフォームの価値です。ホワイトボックスデータに基づいてランキングを正当化し、ブラックボックススコアをユーザーに渡すことはありません。
- 求人に対する候補者の検索/評価/比較(コアとなる採用フロー)を行うには:
- すべてのツール(求職者、雇用者共に)は匿名の
tools/listで表示されます。可視性は発見のためであり、認証のためではありません。使用可能なキーがないというシグナルは、ツールが見つからない のではなく、呼び出しの失敗 です。認証されていない雇用者向けの呼び出しはrequires employer authenticationを返します。これが発生した場合(または保存されたキーが見つからず最初の呼び出しの前の場合)、ユーザーを対応するオンボーディング URL(求職者ホームまたは雇用者ダッシュボード)に誘導し、新しいキーをインラインで受け入れ、apiKey引数で再試行してください。 - ユーザーが明示的に MCP 接続のデバッグを依頼しない限り、シェルの
curlや生の JSON-RPC プローブは使用しないでください。
保存キーの動作
scripts/credential-store.mjsはこのSKILL.mdからの相対パスで解決します。- ユーザーにキーを尋ねる前に、ロールスコープのルックアップを実行します:
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>で保存し、キーはコマンド引数ではなく、標準入力から渡します。- ユーザーが明示的に共有ファイルのフォールバックを希望する場合にのみ、
save --shared-file --role=<role>を使用します。 - ユーザーがそのストレージモードを明示的に選択しない限り、キーをリポジトリ、チャットのトランスクリプト、表示可能なコマンドライン、または MCP 設定に保存しないでください。
- ユーザーが見る出力では、WorkorAI キーを
wai_[REDACTED]としてマスクします。
求職者クイックパス
- オンボーディング URL チェーン:
https://workorai.com/candidate/login→/candidate/profile→ 面接評価を待つ →/candidate/home?tab=mcpで MCP キーをコピー。 - 全9ツールのサーフェス(1つの求職者キーで全てを呼び出せます — ロールと 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 のみ)。
- 発見:
- 推奨する求人ごとに、常に2つの異なるリンクを提示します: 求人ページ(
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)(面接の事実 + Q&A → あなた自身の比較レビュー)→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 問題