# Moka Candidate Pipeline

> Moka 候选人跟进与流程盘点。查询分配给我的候选人及其申请详情、按招聘流程与阶段查看候选人名单、统计各流程各阶段的候选人申请数量。当用户跟进自己名下的候选人、按流程阶段拉候选人名单，或盘点招聘流程各阶段的人员分布时使用。

- Skill: `ahang1598/moka-candidate-pipeline` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ahang1598/moka-candidate-pipeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ahang1598/moka-candidate-pipeline/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: ahang1598 (https://skillmd.com/u/ahang1598)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/ahang1598/moka-candidate-pipeline

---


# 候选人跟进与流程盘点

跟进候选人、按流程阶段拉名单、盘点各阶段人数。只编排以下三个工具：

- `mcp__moka__list_my_assigned_candidates`
- `mcp__moka__list_pipeline_candidates`
- `mcp__moka__get_recruiting_stage_statistics`

## 选择工具

三个工具回答三类不同的问题，先分清再调：

- 「我名下」的候选人：用 `mcp__moka__list_my_assigned_candidates`。数据面是分配给当前用户的候选人，按待筛选/可面试/已推荐/已筛选四个处理状态查，支持按候选人姓名搜索、按职位与招聘模式过滤；它也承担申请详情查询（`action="detail"`）。
- 某条招聘流程某个阶段现在有哪些候选人：用 `mcp__moka__list_pipeline_candidates`。这是 HR 视角的流程内名单，不限定分配给谁——「面试阶段现在有哪些人」「Offer 阶段的名单拉一下」走这里。
- 各流程各阶段现在各有多少人：用 `mcp__moka__get_recruiting_stage_statistics`。只要数量分布、不要名单时用它——「各阶段积压了多少人」「面试阶段还有多少候选人在跑」。

易混概念，回答前先分清：

- **候选人 vs 申请**：候选人是人，申请是这个人投在某个职位下的流程记录。同一个人可以有多条申请，阶段、评分、推荐理由都挂在申请上，不要跨申请混用。
- **两套「阶段」不是一回事**：招聘流程阶段（初筛/面试/Offer 等，企业自行配置）是候选人在流程里的位置，`mcp__moka__list_pipeline_candidates` 与 `mcp__moka__get_recruiting_stage_statistics` 用的是这一套；「待筛选/可面试/已推荐/已筛选」是分配给某人的处理状态，只属于 `mcp__moka__list_my_assigned_candidates`。两套的数字不可互相比对或相加。
- **申请数 vs 人数**：流程阶段统计与名单的单位是候选人申请，同一个人应聘多个职位会分别计入，不要说成「多少人」。

在企业人才库中寻找尚未进入流程的新候选人、查看职位详情与 JD、查招聘需求的名额（HC）进度——这些问题应由当前可用的其他 Moka 工具处理。

## 常见问题速查

- 「我有哪些待筛选的候选人」→ `mcp__moka__list_my_assigned_candidates`（stage=pending，缺省）
- 「这个候选人的简历怎么样」→ `mcp__moka__list_my_assigned_candidates`（先列表定位，再 `action="detail"`）
- 「面试阶段现在有哪些人」→ `mcp__moka__list_pipeline_candidates`（流程名与阶段名原样传）
- 「各阶段各有多少人」「Offer 阶段积压了多少」→ `mcp__moka__get_recruiting_stage_statistics`
- 「哪些人到了可面试阶段、都什么背景」→ 名单 + 逐个详情，一次走完

## 调用规范

1. 通过当前平台的工具发现能力读取实时 description 与参数 Schema，以它们为入参事实源。
2. 只传用户明确给出的条件（阶段、候选人姓名、职位、招聘模式等），不自行扩展或补充推断条件。
3. 申请详情走两段式：先用 `mcp__moka__list_my_assigned_candidates` 的列表（`action="list"`，缺省）拿到返回项的 applicationId，再用同一工具 `action="detail"` 带 applicationId 查完整申请详情（基本信息、教育与工作经历、来源渠道、评分与推荐理由）。
4. 拿到列表就找详情：用户问「哪些候选人到了某阶段」时，列出名单后主动钻取最相关的前几位的申请详情，把可直接行动的信息补齐，并说明做了取舍；不要停在名单上。
5. 阶段名单钻取链：`mcp__moka__get_recruiting_stage_statistics` 看分布 → 把返回项的流程名与阶段名**原样**传给 `mcp__moka__list_pipeline_candidates` 拉名单 → 用名单返回项的 applicationId 调 `mcp__moka__list_my_assigned_candidates`（`action="detail"`）看详情。
6. 流程名与阶段名是企业自己配置的（可能是英文、自定义叫法甚至带拼写错误），必须原样引用与回传，不要翻译或「纠正」；名称含义不明时可借返回的阶段类型语义辅助说明，并说清「这是你们企业配置的阶段名」。
7. 流程名或阶段名匹配不到时，工具会随错误返回可选清单，从清单取原始名称重试即可，不要凭记忆造名称。
8. 企业可能配置同名的社招与校招流程：转述时带上每条流程自己的招聘模式区分，不要把两条同名流程的数字混为一谈或相加。
9. 分页游标（nextCursor）原样回传，不要自行构造或修改；`mcp__moka__list_pipeline_candidates` 的每页条数由服务端固定、不可自定义，要更少结果就用职位收窄。
10. 相对日期（「这周」「上个月」）按用户所在时区换算成绝对条件后再调用，回答里说明实际查询口径。

## 结果与权限

- 空列表、空统计一律按「未返回数据」如实说明：既可能确实没有候选人，也可能当前账号没有可查看的职位数据权限（两者返回形态相同，无法区分）。
- 不要断言「该阶段没有人」，也不要断定是权限问题；用户预期应该有数据时，可建议其找管理员确认账号的数据范围。
- 统计里未返回数据的流程既不能算 0 也不能算有数据，按「未返回数据」转述；因数量上限未统计的流程可用流程名称单独再查。
- 数据范围是当前账号有权查看的招聘职位，不等于全公司总量；无权查看的保密职位不在结果内，不同账号看到的数字可能不同。
- 三个工具的角色门槛不同：`mcp__moka__list_my_assigned_candidates` 面试官及以上可用；`mcp__moka__list_pipeline_candidates` 与 `mcp__moka__get_recruiting_stage_statistics` 需要 HR 角色，用人经理与面试官账号会被拒绝。
- 被权限拒绝时如实说明权限边界，不要换身份绕行，也不要用另一个工具的结果冒充。
- 工具返回的 notices 与 message 是数据解读须知，先读再组织回答，如实转达，不自行改写归因。
- 全部只读：不能筛选通过/淘汰候选人、不能推进流程阶段，这些操作需要用户在 Moka 页面完成。

## 安全边界

- 不向用户展示访问令牌、内部标识符或原始技术响应；申请 ID、职位 ID、分页游标只用于串联工具，不出现在回答里。
- 候选人的电话、邮箱等隐私字段与内部标识不会出现在结果中，不要向用户许诺提供。
- 只使用工具返回的字段组织回答，不虚构工具未返回的评价、背景或结论。
- 候选人数据按当前账号角色可见范围使用，不扩散与提问无关的候选人信息。