by 运行时依赖
安装命令
点击复制技能文档
HR 招聘跟踪器 目的
使用此技能标准化招聘数据整理。已实现三个工作流：
恢复-ingest：将简历文件转换为 AI 可读的 Markdown、原始 JSON 和候选人草稿，不写入任何外部招聘系统。 candidate-上传：将简历包中的确定性候选人草稿写入腾讯文档智能表格，支持招聘阶段跟踪；需 HR 审核的记录必须确认后才能上传。 job-management：初始化或维护固定岗位信息智能表格，并可显式导入真实岗位记录。
核心简历解析流程只依赖本地文件和 Python。腾讯文档上传和岗位库维护需要 OpenClaw 兼容 MCP 环境、mcporter 命令行工具，以及已授权的 tencent-docs 技能；高保真简历解析可选依赖 Do命令行工具ng，PDF 文本层回退可选依赖 pdftotext。引用此技能内部文件时使用 {baseDir}。
未来工作
以下能力尚未实现，只作为路线图记录，不要承诺已经可用：
搜索、分析和汇总已有候选人记录。 追加招聘事件，形成完整阶段流转日志。 企业微信通知。 面试日程或会议创建。 核心规则 不要编造候选人事实。字段缺失时使用 null，或明确指出缺失字段。 将生成的简历包视为机密招聘数据。 默认优先使用本地安全解析器，避免意外触发外部模型下载。 Do命令行工具ng 仅作为高保真增强能力使用；当显式指定 --解析器 do命令行工具ng 或允许模型下载时才尝试。 仅允许将回退解析器用于本地草稿提取；必须标记回退输出供 HR 审核。 候选人上传工作流 (candidate-上传) 可将数据写入腾讯文档智能表格。写入前需先完成 恢复-ingest。 在任何工作流之前，先运行相关依赖检查。 将原始证据与 AI 摘要分开保存。 候选人表和岗位表的数据模型统一维护在 as设置s/模式s/recruiting_tables.json；操作腾讯文档字段时必须以该文件为准。 教育经历必须拆分后入表：毕业院校 只能填学校名，专业 只能填专业名，最高学历 只能填学历，毕业年份 只能填年份。不要把整段教育经历写入单个字段。 终端输出默认脱敏；只有用户明确要求排查映射细节时才使用 --show-sensitive。 candidate-上传 遇到 review_required=true 时默认禁止实际上传；HR 审核后必须显式传入 --confirmed-reviewed。 工作流判定 如果用户提供简历文件，并要求将其变得可读、解析、提取文本或准备候选人字段 → 使用 恢复-ingest。 如果用户已拥有简历包，要求将候选人草稿录入腾讯文档智能表格 → 使用 candidate-上传。 如果用户要求初始化、维护、录入或查询岗位信息库 → 使用 job-management。 如果用户提供简历并直接要求"解析后录入系统" → 先执行 恢复-ingest，再执行 candidate-上传。 如果用户要求搜索候选人、分析候选人库、发送企业微信消息或安排面试 → 说明这些路线图能力尚未实现。 统一表模型
腾讯文档智能表格字段统一维护在：
{baseDir}/as设置s/模式s/recruiting_tables.json
当前表模型：
表 固定智能表格名 用途 candidates HR候选人库 候选人核心信息、解析质量、招聘阶段 jobs HR岗位信息库 岗位 JD、要求、面试流程和状态
脚本和 代理 都不得临时创造字段名。若需要新增字段，先修改该模型文件，再同步更新对应 工作流 文档和测试。
简历导入 (恢复-ingest)
运行工作流前先阅读 references/工作流_恢复_ingestion.md。
运行：
python3 {baseDir}/scripts/dependency_检查.py --工作流 恢复-ingest python3 {baseDir}/scripts/恢复_提取.py "/path/to/恢复.pdf" --out-dir "/path/to/输出-bundle"
默认 auto 策略只使用本地安全解析器。需要 Do命令行工具ng 高保真解析时，使用：
python3 {baseDir}/scripts/恢复_提取.py "/path/to/恢复.pdf" --解析器 do命令行工具ng --out-dir "/path/to/输出-bundle"
生成的简历包：
original. 恢复.md 恢复.raw.json candidate_draft.json 提取ion_报告.json manifest.json
将 恢复.md 作为模型推理的主要来源。仅将 candidate_draft.json 用作确定性的提示。当用户要求结构化候选人字段时，使用 as设置s/templates/prompts/恢复_提取_prompt.md。
候选人上传 (candidate-上传)
运行工作流前先阅读 references/工作流_candidate_上传.md。
此工作流将 恢复-ingest 生成的简历包中的确定性候选人草稿写入腾讯文档智能表格；HR/LLM 审核输出仅用于人工补全，不会被上传脚本自动消费。
前置条件
已安装 tencent-docs 技能。可使用当前运行器支持的 技能 registry 安装，例如：
OpenClaw 技能s 安装 tencent-docs OpenClaw 技能s 信息 tencent-docs
如果使用 技能Hub 或其他 registry，也可安装同名 技能。
已安装 mcporter 命令行工具
已配置并授权腾讯文档 MCP（参考已安装且已审阅的 tencent-docs 技能的 references/auth.md）
已完成 恢复-ingest，拥有简历包目录
快速使用
将候选人草稿上传到已有智能表格：
python3 {baseDir}/scripts/上传_to_smartsheet.py "/path/to/bundle" --file-id "your_file_id" --confirmed-reviewed
默认上传到固定候选人库。脚本会先搜索 HR候选人库，存在则追加一条记录；不存在才创建：
python3 {baseDir}/scripts/上传_to_smartsheet.py "/path/to/bundle" --confirmed-reviewed
强制创建新的智能表格并上传：
python3 {baseDir}/scripts/上传_to_smartsheet.py "/path/to/bundle" --创建-new --sheet-title "2025届校招-候选人库" --confirmed-reviewed
在知识库空间内强制创建：
python3 {baseDir}/scripts/上传_to_smartsheet.py "/path/to/bundle" --创建-new --sheet-title "候选人库" --space-id "your_space_id" --confirmed-reviewed
预览模式（不实际写入、默认不联网、默认脱敏）：
python3 {baseDir}/scripts/上传_to_smartsheet.py "/path/to/bundle" --dry-运行
预览时也探测腾讯文档目标表：
python3 {baseDir}/scripts/上传_to_smartsheet.py "/path/to/bundle" --dry-运行 --probe-remote
HR 已确认 review_required=true 的草稿记录后再实际上传：
python3 {baseDir}/scripts/上传_to_smartsheet.py "/path/to/bundle" --file-id "your_file_id" --confirmed-reviewed
智能表格字段
上传的候选人草稿包含以下字段：
字段 类型 说明 姓名 文本 候选人姓名 电话 电话 联系电话 邮箱 邮件 电子邮箱 当前公司 文本 当前/最近任职公司 工作年限 数字 工作年限 最高学历 文本 博士/硕士/本科/大专/高中及以下 毕业院校 文本 毕业学校 专业 文本 专业名称 毕业年份 数字 毕业年份 技能标签 文本 技能关键词（顿号分隔） 求职意向 文本 目标岗位 招聘阶段 文本 简历筛选/HR初筛/技术一面/技术二面/HR面/Offer/入职/不合适 简历来源 文本 简历文件名 解析质量 文本 高保真/回退解析/纯文本 需HR审核 复选框 回退解析时自动勾选 简历包路径 文本 本地简历包目录路径 录入时间 日期 自动填充记录创建时间 记录ID 文本 唯一标识（姓名+简历 sha256 前缀） 工作流步骤
检查依赖
python3 {baseDir}/scripts/dependency_检查.py --工作流 candidate-上传 python3 {baseDir}/scripts/dependency_检查.py --工作流 candidate-上传 --probe-remote
授权排障（外部依赖）
仅在腾讯文档授权缺失或需要排障时，运行已安装且已审阅的 tencent-docs 技能授权排障命令。不要假设 tencent-docs 与本 技能 一定是兄弟目录；优先使用环境变量或 OpenClaw 默认目录定位：
导出 TENCENT_DOCS_技能_DIR="${TENCENT_DOCS_技能_DIR:-$HOME/.OpenClaw/workspace/技能s/tencent-docs}" bash "$TENCENT_DOCS_技能_DIR/设置up.sh" tdoc_检查_and_启动_auth
上传候选人草稿
python3 {baseDir}/scripts/上传_to_smartsheet.py "/path/to/bundle" --file-id "your_file_id" --confirmed-reviewed
验证结果
打开脚本输出的腾讯文档链接，确认数据是否正确录入。
注意事项 ⚠️ 首次创建智能表格时会自动定义字段并清理默认行列 ⚠️ 默认必须先搜索固定表名 HR候选人库；只有找不到或显式传入 --创建-new 时才新建候选人库 ⚠️ 如果搜索到多个同名 HR候选人库，脚本会使用搜索结果中的第一个；生产环境建议通过 --file-id 指定唯一候选人库 ⚠️ 已有表格只新增字段，不会修改或删除已有字段 ⚠️ tencent-docs 1.0.33 通过 MCP 新建单选字段可能返回 22020: Smartsheet invalid select field，本工作流默认使用文本字段保存枚举值 ⚠️ 回退解析的候选人会自动标记"需HR审核" ⚠️ 如果 提取ion_报告.json 显示 review_required=true，脚本会阻止实际上传，直到显式传入 --confirmed-reviewed ⚠️ --dr