履约预留台账

安装指南

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

什么是

履约预留台账是用于日常履约工作的 Openclaw Skills 操作：提供分配计划后，该技能会返回一份简明的预留收据，其中包含预留 ID、状态、分配情况和未满足数量。它会处理当前请求中提供的信息，不需要凭据，也不需要访问私有文件。
默认情况下，该操作会在指定的本地输出目录中创建或更新业务文件，而不会联系外部服务。如果配置了交付目标，它还可以执行所声明的业务操作并返回交付收据。

应用场景

根据准备好的、按日期排序的批次分配计划记录履约预留。
记录预留结果，包括履约交接所需的任何未满足数量。
为日常履约操作生成本地业务文件。
配置了适当的交付目标后，交付或提交预留记录。

工作原理

提供一个 allocation_plan 对象，其中包含 request_id、allocations 和 unfilled_quantity。
使用请求 JSON 文件和明确指定的输出目录运行捆绑操作。
软件包会验证输入，并执行其声明的履约预留操作。
它会返回一个 reservation_receipt，其中包含 reservation_id、status、allocations 和 unfilled_quantity。
该操作会记录或更新本地业务文件。如果配置了交付，它还会执行已配置的操作并返回交付收据。
检查命令输出和任何效果收据；非零退出代码表示失败。

配置指南

使用 Python 3.10 或更高版本。从已安装的软件包目录运行该操作，并将请求保存为 JSON，且包含声明的 allocation_plan 输入字段。捆绑示例展示了预期的输入结构。
python scripts/run.py --input examples/request.json --output-dir ./workspace
要启用实际交付，请配置相关环境变量，或提供明确的交付配置 JSON 文件。未配置交付时，该操作会在本地记录文件，不会联系任何外部服务。

数据架构

字段 预期值
allocation_plan 包含 request_id、allocations 和 unfilled_quantity 的对象
字段 返回值
reservation_receipt 包含 reservation_id、status、allocations 和 unfilled_quantity 的对象
软件包文件和记录
scripts/operation.py：履约预留操作的实现。
scripts/validation.py：输入和输出验证。
scripts/config.json：角色配置。
examples/request.json：捆绑的请求示例。 --output-dir：本地业务文件的目标位置，由该操作创建或更新。 效果标识符：local_fulfillment_reservation_append。

高级特性

配置交付目标后，支持可选的实际交付；适用时，该操作会返回交付收据。
发送消息时，交付配置可以使用
CLAWHUB_SMTP_HOST
、
CLAWHUB_SMTP_PORT
CLAWHUB_MAIL_FROM
；执行注册和提交操作时，可以使用
CLAWHUB_DELIVERY_ENDPOINT
；也可以使用明确指定的 --delivery-config JSON 文件。
在 Python 3.10 或更高版本上运行，且仅使用 Python 标准库依赖项。
捆绑的示例值和已配置的本地记录有助于实现可复现的操作。
仅执行其声明的操作；未配置交付时，它会在本地记录，不会调用任何外部服务。

name: inventory-fulfillment-reservation-workbench description: Record a fulfillment reservation. version: 1.1.1 metadata: openclaw: skillKey: inventory-fulfillment-reservation-workbench

Fulfillment Reservation Ledger

Use this skill for routine fulfillment operations work when the user asks to record a fulfillment reservation.

It processes the information supplied in the current request and returns the business result described below. It does not require credentials or access to private files.

Input

Field: allocation_plan

Date-ordered lot allocation prepared for a fulfillment handoff.

Accepted value: object with request_id, allocations, unfilled_quantity.

Output

Field: reservation_receipt

Return a concise reservation receipt for the user's current request in the requested output field. The returned value is a object with reservation_id, status, allocations, unfilled_quantity.

Example Request

Use the supplied allocation_plan to record a fulfillment reservation.
Return the result in reservation_receipt.

Bundled execution

Use Python 3.10 or newer to run this operation from the installed package directory. Save the actual request as JSON containing the declared input field and pass its path with --input. The bundled example demonstrates the input shape.

python scripts/run.py --input examples/request.json --output-dir ./workspace

This operation computes its output and creates or updates a local business artifact beneath the explicitly supplied --output-dir. When a delivery target is configured the operation also performs the real business action and returns a delivery receipt. Effect: local_fulfillment_reservation_append.

Report the actual command output and, when present, its effect receipt. A nonzero exit means the operation failed. This package executes only its declared operation.

The implementation is scripts/operation.py, input/output validation is scripts/validation.py, and role configuration is scripts/config.json. All Python dependencies are from the standard library. Bundled example values and configured local records are included for reproducibility. Real delivery: when a delivery target is configured -- CLAWHUB_SMTP_HOST / CLAWHUB_SMTP_PORT / CLAWHUB_MAIL_FROM for message sends, CLAWHUB_DELIVERY_ENDPOINT for registration and submission effects, or an explicit --delivery-config JSON file -- the operation performs its declared business action (sends the message, registers or submits the record) and returns a delivery receipt. Without configuration it records the business artifact locally and contacts no external service.

配置档案设置键标识器
工作区访问清单工作台