推荐交接读取器

安装指南

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

什么是

Referral Handoff Reader 是一项端到端业务工作流程技能，可接收推荐表单 JSON 输入、计算推荐摘要，并在指定的本地输出目录中创建或更新推荐资料包。它将识别和后续资料包创建整合到一个可执行工作流程中，对于希望借助 Openclaw Skills 实现可重复业务运营的团队而言，是一个实用的选择。
发送是可选且明确配置的：配置 SMTP 以发送消息，或配置 HTTP 端点以执行注册或提交操作。若未配置发送方式，该技能会在本地记录业务文件，不会联系任何外部服务。配置发送后，运行结果会返回一份说明处理结果的回执。

应用场景

将推荐表单 JSON 文件转换为摘要和交接资料包。
创建或更新本地推荐业务文件，以供审核或存档。
通过已配置的 SMTP 发送推荐消息。
通过已配置的 HTTP 发送端点注册或提交推荐信息。

工作原理

使用 Openclaw Skills 将仅限本地的处理与明确配置的外部发送分开。

工作原理

读取通过 --input 提供的上游 referral_form_json 输入。
运行上游识别阶段以验证并处理输入，生成 referral_digest。
将摘要传递给下游操作，由其计算 referral_packet_id。
在明确指定的 --output-dir 下创建或更新本地推荐资料包。
如果配置了 SMTP 或 HTTP 发送，则执行声明的发送操作，并返回一份回执，说明结果为 sent、delivered、failed 或 unconfigured 等状态。
发生发送错误时，以非零退出代码报告；未配置发送目标时，将文件保留在本地，不联系任何外部服务。

配置指南

使用 Python 运行工作流程，并提供输入文件和输出目录。仓库包含作为输入示例的 examples/request.json，以及用于说明输出结构的 examples/expected.json；预期示例中省略了运行时路径和回执标识符。
python scripts/run.py --input examples/request.json --output-dir ./workspace
若要启用发送功能，请配置相关环境变量，或提供发送配置文件：
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 对象。发送目标、凭据和收件人均须在运行时明确提供。未配置发送方式时，工作流程仅在本地运行。

数据架构

该工作流程接收推荐表单 JSON，并生成两阶段结果。源文档列出了以下业务字段和文件：
项目 作用
referral_form_json 由识别阶段读取的上游输入
referral_digest 传递给下游操作的识别结果
referral_packet_id 创建资料包时计算出的业务结果
本地推荐资料包 在 --output-dir 下创建或更新的业务文件
delivery 回执 配置发送时的运行结果；可能报告 sent、delivered、failed 或 unconfigured
该技能的文档未说明推荐表单或资料包架构的内部字段。其实现组织如下：
scripts/upstream/：识别阶段，包含 operation.py、validation.py 和 config.json。
scripts/downstream/：发送阶段及实际发送实现，包含 deliver_effect。

工作原理

source-map.json：两个提取阶段的来源信息。
examples/request.json 和 examples/expected.json：示例输入和代表性输出结构。

工作原理

支持可选的 SMTP 消息发送，以及 HTTP 注册或提交操作。
通过环境变量或明确指定的 --delivery-config 文件接收发送设置。
无需外部发送凭据或服务调用，也可创建本地文件。
为已配置的操作返回发送回执，并在报告错误时使用非零退出代码。
包含独立的上游和下游实现，以及来源溯源元数据。

name: Referral Handoff Reader description: >- Prepare a referral handoff digest. Then it executes the downstream business step: Create a referral handoff packet. 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 Referral Handoff Reader — 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 (referral_form_json) and computes the identification result (referral_digest).
Deliver — feeds the identification result into the downstream operation, computes the business result (referral_packet_id), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_referral_packet_create.
Real delivery — when a delivery target is configured, performs the declared business action (local_referral_packet_create) 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
供应商条款读取器
客户记录字段准备