Communityライティング&編集github.com

WorkorAI エージェントスキル&MCP インストーラー

Codex、Claude Code、OpenCode などのエージェントクライアント向けの、WorkorAI エージェントスキル兼 MCP インストーラーです。

WorkorAI エージェントスキル&MCP インストーラー とは?

このスキルは、WorkorAI タレントマーケットプレイスのワークフローをAIエージェント(Claude Code、Cursor、Codex、OpenCodeなど)内で直接実行できるようにします。MCP(Model Context Protocol)サーバーを介して、求職者(キャンディデート)と雇用者(エンプロイヤー)の両方のロールをサポートし、ユーザーの意図に基づいて適切なロールを自動的に判定・ルーティングします。 主な特徴として、求職者は仕事の検索・応募・オファーの管理、雇用者は求人投稿・候補者検索・評価・招待などの操作を、エージェントの自然言語指示で行えます。このスキルは、WorkorAI のMCPサーバーに接続するためのAPIキー管理(スクリプトによる安全な保存/取得)、詳細なレシピとトラブルシューティングガイドを含む参考文献のオンデマンド読み込み、そしてスキルが候補者と雇用者の両方のツールセットを状況に応じて使い分ける高精度なインテント検出を提供します。

対応✓Claude Code✓Codex CLI~Cursor✓Gemini CLI✓OpenCode
npx skills add work0r-ai/agent-kit

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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. ユーザーの意図からロールを判断します。本当に曖昧な場合は、簡単な確認質問を1つ行います(「仕事をお探しですか?それとも採用をご希望ですか?」)。求職者フローと雇用者フローを並行して実行しないでください。
  2. 求職者(キャンディデート)の意図: 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 の正規の初回接触チャネル(「最初に言うこと(求職者向け)」)を使用します。これは開発者ツールです。実行する手順を説明し、キーの値を絶対に出力しないでください。
  3. 雇用者(エンプロイヤー)の意図: 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 を取得 → エビデンスに基づいた独自の比較レビューを作成し、その後招待します。これがプラットフォームの価値です。ホワイトボックスデータに基づいてランキングを正当化し、ブラックボックススコアをユーザーに渡すことはありません。
  4. すべてのツール(求職者、雇用者共に)は匿名の tools/list で表示されます。可視性は発見のためであり、認証のためではありません。使用可能なキーがないというシグナルは、ツールが見つからない のではなく、呼び出しの失敗 です。認証されていない雇用者向けの呼び出しは requires employer authentication を返します。これが発生した場合(または保存されたキーが見つからず最初の呼び出しの前の場合)、ユーザーを対応するオンボーディング URL(求職者ホームまたは雇用者ダッシュボード)に誘導し、新しいキーをインラインで受け入れ、apiKey 引数で再試行してください。
  5. ユーザーが明示的に MCP 接続のデバッグを依頼しない限り、シェルの curl や生の JSON-RPC プローブは使用しないでください。

保存キーの動作

  • scripts/credential-store.mjs はこの SKILL.md からの相対パスで解決します。
  • ユーザーにキーを尋ねる前に、ロールスコープのルックアップを実行します:
    • node scripts/credential-store.mjs get --role=candidate
    • node 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 問題

関連スキル