配送要求顾问

安装指南

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

什么是

配送要求顾问是一项端到端的业务工作流技能，可读取配送请求、判断是否需要签名，并编写配送文档部分。随后，它会在明确指定的输出目录中创建或更新业务文件。
配置 SMTP 主机或 HTTP 配送端点后，该工作流还可以发送消息，或登记、提交记录，并返回包含配送结果的回执。未配置配送选项时，工作流会在本地运行，不会连接外部网络，因此这项 Openclaw Skills 工作流既适用于本地处理，也适用于明确配置的配送。

应用场景

检查配送请求是否需要收件人签名。
根据上游请求生成配送文档记录。
未配置外部配送时，保留本地业务文件。
通过明确配置的 SMTP 服务器发送配送消息。
通过明确配置的 HTTP 端点登记或提交配送记录。
根据返回的回执确认已配置的配送是成功、失败还是不可用。

工作原理

读取请求：从输入 JSON 文件加载上游 delivery_request。
识别要求：运行上游识别阶段，计算 requires_signature。
编写业务结果：将识别结果传递给下游操作，由其创建 delivery_document_section。
写入本地文件：在指定的 --output-dir 下创建或更新 delivery_documentation_record。
执行可选配送：如果配置了 SMTP 或 HTTP 端点，则执行声明的配送操作；否则，将记录保留在本地，不联系外部服务。
报告结果：返回工作流结果；在适用时，还会返回配送回执，标明 sent、delivered、failed 或 unconfigured。配送错误会导致非零退出码。

配置指南

使用 Python 运行工作流，并提供输入请求及明确指定的输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
若要从文件提供配送设置，请添加 --delivery-config：
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 的配送配置对象。
若要通过 HTTP 登记或提交，请配置 CLAWHUB_DELIVERY_ENDPOINT，并可选配置 CLAWHUB_DELIVERY_API_KEY；也可以在配送配置文件中提供 endpoint 对象。配送目标、凭据和收件人必须在运行时明确提供。未配置配送选项时，工作流只会写入本地。

数据架构

该工作流使用 JSON 输入，并生成两阶段业务结果。随附的 examples/request.json 展示上游请求；examples/expected.json 说明预期的输出结构，但不包含运行时路径和回执标识符。
数据或文件 用途
delivery_request 用于判断签名要求的上游输入。
requires_signature 传递给下游阶段的识别结果。
delivery_document_section 根据识别输出编写的业务结果。
delivery_documentation_record 在 --output-dir 下创建或更新的本地业务文件。
delivery 回执 可选的实际配送结果，例如 sent、delivered、failed 或 unconfigured。
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
，用于记录上游和下游阶段的来源信息。
Openclaw Skills 集成：
提供一种实用的自动化模式，用于组合业务规则评估、文件生成和受控配送。

name: Delivery Requirement Advisor description: >- Determine a signature requirement. Then it executes the downstream business step: Compose a delivery signature section. 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 Delivery Requirement Advisor — 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 (delivery_request) and computes the identification result (requires_signature).
Deliver — feeds the identification result into the downstream operation, computes the business result (delivery_document_section), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: delivery_documentation_record.
Real delivery — when a delivery target is configured, performs the declared business action (delivery_documentation_record) 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
事件回调规划器
审批组目录