交付确认指南

安装指南

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

什么是

交付确认指南是一套可执行工作流，可将上游交付配置文件转换为确认指导、计算确认结果，并将业务产物写入指定的本地输出目录。它在一次运行中结合身份识别与下游处理，适用于输出明确、可重复执行的确认工作流。
配置 SMTP 主机或 HTTP 交付端点后，该技能还可以执行已声明的外部操作并报告结果。未配置交付信息时，它仅在本地运行，不会联系任何外部服务。这种明确选择加入的行为，使该技能成为 Openclaw Skills 中适用于受控业务流程自动化的实用工具。

应用场景

将交付请求或配置文件转换为确认指导和确认结果。
创建或更新本地确认记录，以供审核或下游处理。
在运行时提供邮件设置和收件人详情后，通过 SMTP 发送确认信息。
配置交付端点后，通过 HTTP 端点登记或提交记录。
未配置交付目标时，在本地运行工作流，不产生外部网络影响。
将可重复执行并生成回执的确认流程集成到命令行工作流中。

工作原理

读取并验证上游输入，例如捆绑的 examples/request.json 交付配置文件。
运行身份识别阶段，计算 acknowledgement_guidance。
将指导信息传递给下游操作并计算 confirmation_result。
在明确提供的 --output-dir 下创建或更新本地业务产物。
如果通过环境变量或 --delivery-config 配置了 SMTP 或 HTTP 交付，则执行已声明的外部操作。
返回工作流结果和交付回执，以指示 sent、delivered、failed 或 unconfigured 等结果；发生错误时返回非零退出码。

配置指南

使用 Python 运行工作流，并提供输入文件和明确的输出目录：
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 对象。交付目标、凭据和收件人详情均在运行时提供。未配置交付信息时，工作流只会写入本地业务产物，不会发出外部请求。预期输出结构请参见 examples/expected.json；其中省略了运行时路径和回执标识符。

数据架构

工作流处理两个业务阶段，并生成本地业务产物；适用时还会生成交付回执。
阶段或输出 描述
delivery_profile 从提供的请求 JSON 中读取的上游输入。
acknowledgement_guidance 根据输入计算出的身份识别结果。
confirmation_result 由下游操作计算出的业务结果。
local_confirmation_receipt 在 --output-dir 下创建或更新的本地业务产物；对于已配置的交付，它也是声明的业务操作。
delivery 回执 在适用时报告实际交付结果，包括 sent、delivered、failed 或 unconfigured。
关键文件按工作流职责组织：
scripts/upstream/：身份识别实现、验证和 config.json。
scripts/downstream/：交付阶段实现，包括 deliver_effect。
scripts/run.py：完整的工作流运行程序。
source-map.json：两个提取阶段的来源信息。
examples/request.json：捆绑的上游输入；examples/expected.json：示例输出结构。

高级特性

将身份识别、业务处理、本地产物创建和可选交付作为一个完整工作流运行。
通过明确的运行时配置支持 SMTP 消息发送以及基于 HTTP 的登记或提交。
接受来自环境变量或可选 --delivery-config 文件的交付设置。
默认仅在本地运行；未配置目标时不会调用外部服务。
返回交付回执，以区分成功、失败和未配置的结果。
发生错误时以非零进程退出码报告，便于命令行监控和自动化。
包含独立的上游和下游实现、验证、配置及来源信息。

name: Delivery Acknowledgement Guide description: >- Set acknowledgement guidance for a delivery. Then it executes the downstream business step: Create a delivery acknowledgement. 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 Acknowledgement Guide — 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_profile) and computes the identification result (acknowledgement_guidance).
Deliver — feeds the identification result into the downstream operation, computes the business result (confirmation_result), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_confirmation_receipt.
Real delivery — when a delivery target is configured, performs the declared business action (local_confirmation_receipt) 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
制品交付规划器
服务类规划器