供应商条款读取器

安装指南

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

什么是

供应商条款读取器是一种可执行的业务工作流，用于读取上游供应商输入、识别采购条款，并使用结果创建或更新本地采购草稿。它在一次运行中结合了识别和下游草稿创建阶段，因此可以同时生成业务结果和对应产物。
默认情况下，该技能会在本地存储采购产物，不会联系任何外部服务。如果明确配置了 SMTP 或 HTTP 交付端点，它会执行声明的交付操作，并返回一份回执，显示交付已发送、已送达、失败或尚未配置。Openclaw Skills 用户可以运行完整工作流，同时将交付目标和凭据保留在运行时配置中。

应用场景

将供应商 CSV 请求转换为结构化采购条款和采购草稿。
创建或更新本地采购产物，以供审核或下游处理。
通过已配置的 SMTP 设置发送与业务操作相关的消息。
通过已配置的 HTTP 交付端点注册或提交记录。
未配置交付目标时，在本地运行工作流且不联系外部服务。
通过返回的回执和错误时的非零退出状态检查交付结果。

工作原理

读取上游输入，例如包含供应商数据的捆绑文件 examples/request.json。
运行识别阶段以验证和解读输入，并生成 purchase_terms。
将识别结果传递给下游阶段，由其计算 purchase_draft_id。
在明确指定的 --output-dir 下创建或更新本地采购草稿。
如果通过环境变量或 --delivery-config 配置了 SMTP 或 HTTP 交付，则执行声明的实际交付操作。
返回工作流输出，并在适用时包含交付回执；发生错误时以非零退出状态报告。

配置指南

使用 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 对象。交付目标、凭据和收件人均来自明确的运行时配置。未配置交付时，该技能只会在本地记录产物。

数据架构

该工作流分为两个阶段，并生成一个本地业务产物：
阶段或项目 作用
supplier_csv 供应商数据的上游输入标识符。
purchase_terms 由识别阶段计算得出的结果。
purchase_draft_id 由下游阶段计算得出的业务结果。
local_purchase_draft_insert 声明的效果，用于创建或更新本地采购草稿。
delivery 配置交付时描述实际交付结果的回执；结果包括 sent、delivered、failed 或 unconfigured。
相关文件包括：用于识别逻辑的 scripts/upstream/（operation.py、validation.py 和 config.json）、用于草稿交付和 deliver_effect 的 scripts/downstream/、完整工作流运行器 scripts/run.py、示例输入 examples/request.json、预期输出结构 examples/expected.json，以及记录两个提取阶段来源信息的 source-map.json。捆绑的预期输出示例不包含运行时路径和回执标识符。

高级特性

在一个可执行工作流中结合识别和下游采购草稿创建。
支持可选的 SMTP 消息发送以及 HTTP 注册或提交。
通过环境变量或明确指定的 --delivery-config 文件接受交付设置。
默认禁用外部交付；未配置时，仅在本地写入，不会联系任何外部服务。
配置交付后，返回包含实际结果的交付回执。
使用非零退出状态报告错误。

name: Supplier Terms Reader description: >- Prepare supplier purchasing terms. Then it executes the downstream business step: Create a purchase draft. 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 Supplier Terms 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 (supplier_csv) and computes the identification result (purchase_terms).
Deliver — feeds the identification result into the downstream operation, computes the business result (purchase_draft_id), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_purchase_draft_insert.
Real delivery — when a delivery target is configured, performs the declared business action (local_purchase_draft_insert) 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
现场路线排序器
推荐交接读取器