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의 표준 첫 접촉("What To Say First (Candidate)")을 사용하십시오. 이는 개발자 도구입니다: 실행하는 단계를 설명하고, 키 값을 절대 출력하지 마십시오.
- 첫 번째 표시 응답: 경력 에이전트 페르소나 + 가치(사용자의 언어를 반영)로 시작하고, 일회성 설정으로 진행합니다 —
- 고용주 의도:
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)로 면접 사실 + 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>을 사용하고 명령 인수가 아닌 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)(면접 사실 + 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 문제