Community라이팅 & 에디팅github.com

work0r-ai/agent-kit

Codex, Claude Code, OpenCode 등 여러 에이전트 클라이언트를 위한 범용 WorkorAI 에이전트 스킬 및 MCP 설치 프로그램입니다.

agent-kit란 무엇인가요?

WorkorAI Agent Kit는 인재 마켓플레이스 WorkorAI의 워크플로우를 AI 에이전트(Codex, Claude Code, OpenCode 등)가 직접 수행할 수 있도록 지원하는 MCP 기반 스킬입니다. 이 스킬은 구직자(Candidate)와 고용주(Employer)라는 이중 역할을 인텐트(intent) 기반으로 자동 라우팅하며, 세부적인 스키마와 레시피는 참조 파일(`references/`)에 위임하여 유지보수성을 높였습니다. 구직 모드에서는 채용 공고 검색, 지원, 초대 수락/거절, 저장, 철회 등 9개의 도구를 제공하며, 고용주 모드에서는 공고 생성, 후보자 검색/평가/초대, 지원서 검토, 채용 파이프라인 관리 등 19개의 도구를 제공합니다. 특히 후보자 매칭 시 'Agent Pick'을 통해 matchExplanation 기반의 투명한 순위와 근거를 제시하여 블랙박스가 아닌 화이트박스 평가를 제공하는 것이 핵심 가치입니다.

지원 대상✓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 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 외부의 구직/구인을 요청하는 경우에만 이 스킬을 건너뜁니다.

첫 번째 응답 — 역할 결정

  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의 표준 첫 접촉("What To Say First (Candidate)")을 사용하십시오. 이는 개발자 도구입니다: 실행하는 단계를 설명하고, 키 값을 절대 출력하지 마십시오.
  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에서 설명(면접에서 입증된 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>을 사용하고 명령 인수가 아닌 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 문제

관련 스킬