候选人技能映射器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install candidate-interview-agenda-complete
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 candidate-interview-agenda-complete。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Candidate Skills Mapper 是一套端到端工作流，可将 candidate_profile_yaml 输入转换为 interview_plan，再生成本地 agenda_artifact。它将候选人识别和日程创建整合到一个可执行技能中，让团队一次运行即可从档案数据生成可执行的面试日程。
默认情况下，该技能会将业务产物写入明确指定的输出目录，且不会发送外部请求。配置 SMTP 或 HTTP 发送端点后，它可以执行声明的发送操作，并返回包含结果的回执。这使其成为 Openclaw Skills 的实用补充，可用于可重复的面试准备，并明确支持纯本地模式。

应用场景

将候选人档案输入转换为面试计划和日程。
为招聘工作流准备一致的面试材料。
未配置外部发送时，将日程产物保存到本地。
提供邮件设置和收件人信息后，通过 SMTP 发送面试日程。
通过已配置的 HTTP 端点登记或提交业务记录。

工作原理

读取上游候选人档案输入，例如 examples/request.json。
运行识别阶段，根据候选人数据计算 interview_plan。
将计划传递给下游阶段以生成 agenda_artifact。
在必需的 --output-dir 下写入或更新本地业务产物。
如果通过环境变量或 --delivery-config 配置了发送，则执行声明的发送操作，并返回标记为 sent、delivered、failed 或 unconfigured 的回执。
发送错误会以非零进程退出状态报告；未配置发送时，记录仅保存在本地，不会联系任何外部服务。

配置指南

使用 Python 运行工作流，并提供输入文件和明确的输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
若要使用发送配置文件，请添加 --delivery-config delivery.json：
python scripts/run.py --input examples/request.json --output-dir ./workspace --delivery-config delivery.json
若要通过 SMTP 发送，请配置 CLAWHUB_SMTP_HOST，并按需配置 CLAWHUB_SMTP_PORT、CLAWHUB_MAIL_FROM、CLAWHUB_SMTP_USERNAME 和 CLAWHUB_SMTP_PASSWORD。或者，在发送配置中提供包含 smtp_host、smtp_port 和 from_addr 的 SMTP 配置。
若要通过 HTTP 登记或提交，请配置 CLAWHUB_DELIVERY_ENDPOINT，并可选择配置 CLAWHUB_DELIVERY_API_KEY；也可以在发送配置中提供 endpoint 对象。发送目标、凭据和收件人必须在运行时明确提供。若未配置发送目标，该技能将在本地运行，不会联系外部服务。

数据架构

该工作流处理一条分为两个阶段的业务记录：
Stage Input or output Purpose
上游识别 candidate_profile_yaml → interview_plan 读取候选人档案并计算面试计划。
下游日程 interview_plan → agenda_artifact 制定面试日程并写入本地业务产物。
可选发送 发送配置 → delivery 回执 将实际操作结果报告为 sent、delivered、failed 或 unconfigured。
关键文件和位置：
examples/request.json — 随附的上游输入示例。
examples/expected.json — 完整两阶段输出结构示例；不包含运行时路径和回执标识符。 --output-dir — 明确指定的本地业务产物目标位置。 scripts/upstream/ — 识别实现：operation.py、validation.py 和 config.json。
scripts/downstream/ — 日程发送阶段，包括 deliver_effect。
scripts/run.py — 完整工作流运行程序。
source-map.json — 两个提取阶段的来源记录。

高级特性

在一个工作流中执行识别、日程生成、本地产物写入和可选发送。
支持两种发送模式：SMTP 邮件发送，以及 HTTP 登记或提交。
通过明确的环境配置或 --delivery-config 文件启用发送；默认仅在本地运行。
返回发送回执，以区分成功、失败和未配置的结果。
使用非零退出状态向脚本和自动化流程报告发送错误。
将上游和下游实现分离，并在
source-map.json
中记录来源。

name: Candidate Skills Mapper description: >- Map candidate skills to an interview plan. Then it executes the downstream business step: Build an interview agenda. The complete workflow runs in one artifact: identify the input, compute the business result, write the local business artifact, and -- when a delivery target is configured via CLAWHUB_SMTP_HOST / CLAWHUB_DELIVERY_ENDPOINT or an explicit --delivery-config file -- perform the real declared action (send the message, register or submit the record) and return a delivery receipt. Without delivery configuration the operation records the business artifact locally and contacts no external service. version: 1.2.0 Candidate Skills Mapper — complete probe workflow

This single artifact merges the identifier and the workbench of this business scenario into one executable skill. Running it performs the full chain:

Identify — reads the upstream input (candidate_profile_yaml) and computes the identification result (interview_plan).
Deliver — feeds the identification result into the downstream operation, computes the business result (agenda_artifact), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_interview_agenda_render.
Real delivery — when a delivery target is configured, performs the declared business action (local_interview_agenda_render) and returns a delivery receipt with the real outcome (sent / delivered / failed / unconfigured).

Run

python scripts/run.py --input examples/request.json --output-dir ./workspace [--delivery-config delivery.json]

The bundled examples/request.json is the upstream input; examples/expected.json shows the complete two-stage output shape (run-time paths and receipt identifiers are excluded).

Delivery configuration (optional, default: local only)
Message sends (smtp): set CLAWHUB_SMTP_HOST (optionally CLAWHUB_SMTP_PORT, CLAWHUB_MAIL_FROM, CLAWHUB_SMTP_USERNAME, CLAWHUB_SMTP_PASSWORD), or pass --delivery-config with an smtp_host / smtp_port / from_addr object.
Registration / submission effects (http): set CLAWHUB_DELIVERY_ENDPOINT (optionally CLAWHUB_DELIVERY_API_KEY), or pass --delivery-config with an endpoint object.

Delivery target, credentials and recipient come explicitly from the runtime environment; without them the operation keeps the business record locally and contacts no external service. Errors are reported through a nonzero exit.

Files

scripts/upstream/ — identify stage implementation (operation.py, validation.py, config.json)
scripts/downstream/ — deliver stage implementation incl. real delivery (deliver_effect)
scripts/run.py — complete workflow runner
source-map.json — source provenance for both extracted stages
知识放置规划器
营销活动预算预测器