制品交付规划器

安装指南

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

什么是

制品交付规划器是一套可执行工作流，可将 export_request 转换为 route_mode，再使用该结果计算 recorded_route，并创建或更新本地业务制品。它在一次运行中结合请求识别与交付规划，并通过 --output-dir 指定明确的输出位置。
提供运行时交付设置后，此技能还可以执行声明的操作——通过 SMTP 发送消息，或通过 HTTP 注册或提交记录——并返回交付回执。没有交付配置时，它仅在本地运行，不会联系任何外部服务。对于需要明确采用本地优先默认行为、同时支持可选现实交付的工作流，这是 Openclaw Skills 中的实用选择。

应用场景

将上游导出请求转换为交付路由和业务记录。
在未配置外部交付或应避免外部交付时，生成本地路由计划。
通过明确配置的 SMTP 服务器发送已规划的制品。
将路由记录注册或提交到明确配置的 HTTP 端点。
使用随附的示例输入和预期输出格式检查两阶段工作流。

工作原理

从输入 JSON 文件读取上游 export_request。
运行识别阶段以确定 route_mode。
将识别结果传递给下游交付操作，并计算 recorded_route。
在明确指定的 --output-dir 下创建或更新本地业务制品。
如果配置了 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 的对象。
HTTP 注册或提交：设置 CLAWHUB_DELIVERY_ENDPOINT；也可选择设置 CLAWHUB_DELIVERY_API_KEY。或者，在交付配置文件中配置 endpoint 对象。
交付目标、凭据和收件人均需在运行时明确提供。如果未配置交付目标，本次运行只会创建本地业务记录。

数据架构

此工作流使用 JSON 输入，并在通过 --output-dir 指定的目录中生成本地业务制品。
数据元素 作用
export_request 由识别阶段读取的上游输入。
route_mode 传递给下游操作的识别结果。
recorded_route 计算得出的业务结果，用于本地路由制品。
delivery 适用时描述外部交付结果的运行时回执。
仓库文件按工作流阶段组织：
examples/request.json — 随附的上游输入示例。
examples/expected.json — 完整两阶段输出格式示例；不包含运行时路径和回执标识符。
scripts/upstream/ — 识别实现、验证和配置（operation.py、validation.py、config.json）。
scripts/downstream/ — 交付阶段实现，包括实际交付操作。
scripts/run.py — 端到端工作流运行器。
source-map.json — 两个提取阶段的来源信息。

高级特性

在单个可执行工作流中整合识别、业务结果计算、本地制品写入和可选的实际交付。
支持 SMTP 消息发送以及 HTTP 注册或提交这两种不同的交付路径。
支持通过运行时环境变量或明确指定的 --delivery-config 文件提供交付设置。
未配置交付时默认仅在本地运行，避免调用外部服务。
返回交付结果信息，并在报告错误时使用非零退出状态。
包含独立的上游和下游实现、验证与配置文件，以及来源信息。

name: Artifact Delivery Planner description: >- Plan the delivery route for an artifact. Then it executes the downstream business step: Register an artifact delivery route. 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 Artifact Delivery Planner — 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 (export_request) and computes the identification result (route_mode).
Deliver — feeds the identification result into the downstream operation, computes the business result (recorded_route), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_route_plan.
Real delivery — when a delivery target is configured, performs the declared business action (local_route_plan) 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
供应商名称解析指南
交付确认指南