对账阈值规划器

安装指南

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

什么是

对账阈值规划器是一个 Openclaw Skills 工作流，可将对账规则转换为发票匹配阈值和下游对账摘要。其单一运行程序负责识别、计算业务结果，以及在指定输出目录中创建或更新本地文件。
配置 SMTP 或 HTTP 发送目标后，该技能还可以执行所声明的发送操作，并返回回执，说明内容是已发送、已送达、失败还是未配置发送。未配置发送时，记录会保留在本地，不会联系外部服务。

应用场景

根据上游对账规则计算匹配阈值。
在发票处理工作流中生成对账摘要。
在明确选择的工作区目录中保存或更新生成的业务文件。
配置发送功能后，通过 SMTP 发送消息，或通过 HTTP 端点登记或提交记录。
无需外部发送时，运行仅在本地执行的对账工作流。

工作原理

读取并验证上游 reconciliation_rule 输入。
计算识别结果 match_threshold。
将该结果传递给下游操作，并计算 reconciliation_summary。
在提供的 --output-dir 下创建或更新本地业务文件。
如果已配置 SMTP 或 HTTP 发送，则执行所声明的操作并返回发送回执；否则，将文件保留在本地，不联系外部服务。

配置指南

使用随附的请求文件或兼容的输入文件运行完整工作流：
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 对象。发送目标、凭据和收件人均须在运行时明确提供。未设置发送选项时，仅在本地执行。发送错误会通过非零退出状态报告。

数据架构

此工作流采用两阶段输入和结果模型：
阶段 输入或结果 用途
识别 reconciliation_rule → match_threshold 根据上游规则推导发票匹配阈值。
发送 match_threshold → reconciliation_summary 计算业务摘要，并创建或更新本地文件。
可选的实际发送 delivery 回执 报告结果为 sent、delivered、failed 或 unconfigured。
关键文件和目录：
examples/request.json — 随附的上游输入。
examples/expected.json — 完整两阶段输出结构示例；不包含运行时路径和回执标识符。
scripts/run.py — 完整工作流运行程序。
scripts/upstream/ — 识别实现，包含 operation.py、validation.py 和 config.json。
scripts/downstream/ — 下游发送实现，包含 deliver_effect。
source-map.json — 两个提取阶段的来源信息。 --output-dir — 明确选择的本地业务文件存放位置。

高级特性

在一个可执行工作流中整合识别和下游业务处理。
支持可选的实际 SMTP 消息发送，以及通过 HTTP 登记或提交。
将发送端点和凭据保存在运行时环境变量或明确指定的发送配置中，默认无需进行外部发送。
配置发送阶段后，提供包含所报告结果的发送回执。
支持仅在本地运行，不联系外部服务。
发生发送错误时返回非零退出状态。
包含验证、配置、示例输入、预期输出和来源信息文件。

name: Reconciliation Threshold Planner description: >- Derive an invoice-match threshold. Then it executes the downstream business step: Build an invoice reconciliation summary. 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 Reconciliation Threshold 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 (reconciliation_rule) and computes the identification result (match_threshold).
Deliver — feeds the identification result into the downstream operation, computes the business result (reconciliation_summary), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: reconciliation_summary.
Real delivery — when a delivery target is configured, performs the declared business action (reconciliation_summary) 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
受众准备指南
账户报告配方规划器