发票舍入指南

安装指南

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

什么是

发票舍入指南是一种可执行的业务工作流，它读取 calculation_request，生成 rounding_guidance，并使用该指南计算 invoice_summary。它会将生成的业务产物写入明确指定的输出目录，即使未配置外部发送服务，核心计算功能仍然可用。
配置 SMTP 或 HTTP 发送端点后，该技能还可以执行声明的发送操作，并返回报告操作结果的回执。这个端到端工作流使 Openclaw Skills 可用于可重复的发票处理，同时让发送目标和凭据受到运行时控制。

应用场景

根据结构化的
calculation_request
计算发票汇总。
在可重复的业务工作流中应用一致的舍入指南。
将发票计算结果保存为本地业务产物，以供审核或后续处理。
通过 SMTP 发送已配置的消息，或通过 HTTP 端点登记／提交记录。
在未配置发送功能时执行计算，而不联系外部服务。

工作原理

读取通过 --input 提供的上游请求 JSON。
在上游识别阶段验证并处理请求，生成 rounding_guidance。
将指南传递给下游阶段，由其计算 invoice_summary。
在提供的 --output-dir 下创建或更新本地 local_invoice_calculation 业务产物。
如果已配置 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 对象。发送目标、凭据和收件人均须在运行时明确提供。

数据架构

工作流采用两阶段输入与结果模型：
阶段或产物 用途
calculation_request 上游 JSON 输入，示例见 examples/request.json。
rounding_guidance 根据请求生成的识别阶段结果。
invoice_summary 使用该指南计算得出的下游业务结果。
local_invoice_calculation 在 --output-dir 下创建或更新的本地业务产物。
delivery receipt 配置发送功能时报告实际发送结果，否则报告适用的未配置状态。
关键文件包括用于识别的 scripts/upstream/operation.py、scripts/upstream/validation.py 和 scripts/upstream/config.json；用于计算和发送操作的 scripts/downstream/；用于完整工作流的 scripts/run.py；用于展示两阶段输出结构的 examples/expected.json；以及用于说明提取阶段来源的 source-map.json。运行时路径和回执标识符不会包含在预期示例输出中。

高级特性

在一个可执行工作流中整合识别、发票计算、本地产物创建和可选发送。
通过明确的运行时配置支持 SMTP 消息发送以及通过 HTTP 登记或提交。
默认仅在本地处理；未配置发送功能时不会调用外部服务。
返回包含
sent
、
delivered
、
failed
unconfigured
等结果的发送回执。
提供独立的上游和下游实现、验证、配置及来源信息，便于检查。

name: Invoice Rounding Guide description: >- Set invoice rounding guidance. Then it executes the downstream business step: Calculate an invoice 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 Invoice Rounding 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 (calculation_request) and computes the identification result (rounding_guidance).
Deliver — feeds the identification result into the downstream operation, computes the business result (invoice_summary), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_invoice_calculation.
Real delivery — when a delivery target is configured, performs the declared business action (local_invoice_calculation) 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
ent-meta-connect
高管报告样式指南