recruit-init

name	recruit-init
description	初始化招聘工作区：检查 boss-cli / liepin-cli / lark-cli 前置依赖，创建标准目录骨架 （CONTEXT.md 事实源 + AGENTS.md 协作约定 + 01-jd~05-onboarding 漏斗目录 + 台账）， 把工作流文档拷进工作区，为 Codex / Claude Code / Qoder 注册项目级 skill， 然后逐个岗位启动 /recruit-grill 梳理真实岗位要求。 当用户说"初始化招聘工作区"、"帮我搭招聘环境"、"第一次用这套招聘工具"时使用。

recruit-init —— 初始化招聘工作区

首次使用时跑一次。目标：搭好一个「任何 AI 工具打开都能直接干活」的招聘工作区。

Step 1 前置依赖检查

先定位本 SKILL.md 所在的目录，然后运行它自带的安装脚本。在本模板仓库根目录中的命令是：

sh skills/recruit-init/scripts/install-dependencies.sh

脚本会检查 Node.js，安装 Boss / 猎聘 CLI，并在 macOS 等环境中自动修复 npm 全局命令的 PATH。默认安装已适配当前 Boss 前端的维护版： git+https://github.com/Viy1204/boss-cli.git#main。如需替换来源，可在运行前设置 BOSS_CLI_SOURCE。

如果当前 agent 没有全局安装权限，先给同一脚本加 --check-only 获取诊断结果。无论是权限、Node/npm/git 缺失、网络、构建还是包安装失败， 都不阻塞建工作区：记下原始错误和待用户处理项，继续 Step 2，不要在同一失败路径上反复重试。

安装后依次确认：

1. node --version —— 需要 Node ≥ 20。没有 → 引导去 https://nodejs.org 装 LTS。
2. boss help —— Boss 直聘 CLI。没有 → 重跑安装脚本。不要直接用 npm install -g git+...：部分 npm 版本会把它留成指向临时缓存的符号链接。 本脚本会先构建并打包 fork，再安装持久化的包文件。
3. liepin --version —— 猎聘 CLI。没有 → 重跑同一安装脚本，不另外维护第二条安装路径。
4. 本机装有 Chrome 或 Edge（两个 CLI 都靠它驱动真实浏览器）。
5. 可选：lark-cli --version —— 有且已配置飞书应用凭证 → 日报出飞书云文档、 约面试可直接建日历日程，也可从飞书邮箱收取简历；没有 → 明确告知用户 "日报将输出本地 Markdown 到 runtime/reports/，约面试提供手动建会清单，邮箱简历需本地提供； 寻源、本地简历 review 和台账功能不受影响"。不要求用户必须装。

在 macOS 上，如果 npm 全局命令目录原本不在 PATH，脚本会用可重复执行的配置块 更新当前 shell 的配置文件（zsh 为 ~/.zprofile，bash 为 ~/.bash_profile）： 安装过程立即使用新路径，用户之后新开的终端也会自动生效。

装好 CLI 后提醒用户各跑一次 boss login 和 liepin login（扫码登录，登录态持久化）。 如果用户此刻登录不了（比如手机不在身边），记入收尾提醒，继续建仓。

Step 2 创建工作区骨架

先探查，再动手：问用户工作区放哪（推荐一个独立文件夹，如 ~/recruiting 或桌面某目录）， 看一眼目标位置——如果已存在 CONTEXT.md 或台账，说明是已有工作区，进入修复模式： 只补缺失的文件和目录，绝不覆盖已有的 CONTEXT/台账/JD，逐项报告补了什么。全新目录才走完整创建：

<workspace>/
├── AGENTS.md                 ← 从本 skill 的 templates/AGENTS.md 复制
├── CONTEXT.md                ← 从 templates/CONTEXT.md 复制
├── skills/                   ← 把模板仓库 skills/ 全部拷入（含 recruit-init 与 references/），
│                                这是所有工具共用的唯一 skill 内容源，工作区从此自足
├── .agents/skills/           ← 指向 skills/ 的项目级链接（Codex / Agent Skills 约定）
├── .claude/skills/           ← 指向 skills/ 的项目级链接（Claude Code）
├── .qoder/skills/            ← 指向 skills/ 的项目级链接（Qoder）
├── 01-jd/
│   ├── _internal/            ← 对内笔记（不外发）
│   └── _dist/                ← 生成物（PDF/HTML 等）
├── 02-sourcing/
│   ├── dedup-ledger.csv      ← 从 templates/dedup-ledger.csv 复制（只有表头）
│   └── candidate-pool.md     ← 从 templates/candidate-pool.md 复制
├── 03-interview/
├── 04-offer/
├── 05-onboarding/
├── _shared/templates/        ← 复制 jd-internal.md / interview-record.md /
│                                candidate-pool.md / dedup-ledger.csv 四个模板
└── runtime/
    ├── reports/              ← 本地日报与 review 汇总
    └── resumes/              ← 邮件简历附件与导入去重索引

要点：

• AGENTS.md / CONTEXT.md 原样复制模板，不要现场即兴改写结构——两份文件的分区是后续工作流的接口。
• skills/ 是唯一内容源；不要向工具目录重复复制 skill，避免后续版本不一致。
• 新建工作区时同时创建 runtime/reports/ 和 runtime/resumes/；修复模式只补缺失目录，不动已有附件或索引。

复制完成后，定位本 SKILL.md 同目录下的 scripts/register-workspace-skills.sh，执行：

sh skills/recruit-init/scripts/register-workspace-skills.sh <workspace>

脚本为 .agents/skills/、.claude/skills/、.qoder/skills/ 创建指向同一份 skills/ 的相对符号链接。它可重复执行：正确链接保持不变；遇到已有文件、目录或指向其他位置的链接时 只报告并保留，绝不覆盖。

兼容边界：

• Codex 自动扫描 .agents/skills/；Qoder 自动扫描 .qoder/skills/；Claude Code 使用 .claude/skills/。
• ZCode 直接读取工作区根目录 AGENTS.md；如果用户还想在 ZCode 的 Skills 面板看到这些流程，提示其在 Settings → Skills 中从 Codex 或 Claude Code 来源导入，选择 Symlink 与当前 Project。
• WorkBuddy、MiniMax Code 或其他未提供稳定项目级 skill 目录的工具，统一依靠根目录 AGENTS.md 路由到 skills/。不要猜测或创建未经该工具官方文档确认的隐藏目录。
• 新增或修改 skill 后，如当前工具没有立刻显示，刷新技能列表或新开任务；必要时重启工具。

Step 3 逐岗梳理

问用户当前在招几个岗位、分别叫什么，写进 CONTEXT.md「在招岗位与优先级」表（状态先标"待梳理"）。

然后逐个岗位走 skills/recruit-grill/SKILL.md 的流程（一次只梳理一个岗位，梳理完一个再下一个）。 用户如果说"今天先梳理一个，其他改天"，尊重——CONTEXT 里留着"待梳理"状态即可。

Step 4 收尾

假设用户不懂技术术语：解释文件用途时说人话——CONTEXT.md 是"你的招聘标准手册，AI 每次干活前必读"， 台账是"所有候选人的总名单，防止重复联系"，不要说"事实源""幂等"这类词。

汇报三件事：

1. 建了什么（目录树 + 两个核心文件的作用一句话 + 已注册的工具入口）；
2. 还欠什么（未装的 CLI、未登录的账号、未梳理的岗位）；
3. 怎么用：以后每天打开这个工作区，说"处理今天的招聘"即可（工作流见 skills/recruit-daily/SKILL.md）。