viy1204/recruiting-copilot/recruit-init

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

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

网页开工（默认）：目标工作区实际建立后，按 `../recruit-board/references/hosts.md` 统一接入；脚本可用时为 init start、保存 run id，按 `共享进度协议` 补记依赖与建目录的已观测结果，再进入当前真实步骤，尽早确认服务并打开或复用网页，同时交付本轮链接。目录未建立前不 start，不向源码仓库写 runtime；缺脚本或接入失败按共享降级继续初始化，不为看板覆盖旧 skills。

工作区建立后按 `跨轮事项与重点` 读取已有未决事项。需要用户决定且暂未处理的问题登记为工作区或岗位事项；普通安装动作不一律变成“待你确认”。初始化已核实的关键结果及时记 highlight；新事项和重点按共享契约填写 context，整个工作区用 scope:workspace 且不附人岗，已确认的单岗用 scope:role 和 role。details 只记适用的核实短文本，最多 8 项，不填虚构人选；旧格式继续可读。结束 run 前写 summary，未确认岗位要求保留待办而不宣称梳理完成。

Step 1 前置依赖检查

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

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

脚本会检查 Node.js ≥22，安装 Boss / 猎聘 CLI，并在 macOS 等环境中自动修复 npm 全局命令的 PATH。v0.8.3 默认安装固定的 Boss 维护包 @viyzhu/boss-cli-fork@0.8.7。如需替换来源，可在运行前设置 BOSS_CLI_SOURCE。

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

安装后依次确认：

1. node --version —— 需要 Node ≥22。没有 → 引导去 https://nodejs.org 装 LTS。
2. boss help —— Boss 直聘 CLI。没有 → 重跑安装脚本。默认从 npm 安装上述固定版本。

若用 BOSS_CLI_SOURCE 指定带 ref 的 git 来源，本脚本先构建并打包，再安装持久化包文件， 避免部分 npm 版本将 git 全局安装留成指向临时缓存的符号链接。

1. liepin --version —— 猎聘 CLI。没有 → 重跑同一安装脚本，不另外维护第二条安装路径。
2. 本机装有 Chrome 或 Edge（两个 CLI 都靠它驱动真实浏览器）。
3. 可选：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/              ← 邮件简历附件与导入去重索引
    └── recruit-board/        ← 看板脚本按需建立；轮次与跨轮事项需要保留和备份

要点：

• 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）。