账户报告配方规划器

安装指南

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

什么是

Account Report Recipe Planner 是一个可执行的 Openclaw Skills 工作流，它读取 report_request，计算识别谓词，并用它生成 account_group_report。它会在明确指定的输出目录下创建或更新业务成果。
发送为可选操作：配置 SMTP 可发送消息，配置 HTTP 端点可登记或提交结果。如果未配置发送方式，该技能会将报告保存在本地，且不会联系任何外部服务；配置发送方式后，它会返回一份说明处理结果的回执。

应用场景

将上游账户报告请求转换为分组业务报告。
将报告成果保存在本地，以便审核或后续处理。
配置发送目标和凭据后，通过 SMTP 发送报告。
向 HTTP 端点登记或提交报告。
使用随附的示例请求和预期输出，测试预期的两阶段输出结构。

工作原理

从提供的输入 JSON 中读取上游 report_request。
运行识别阶段，以验证并计算 report_predicate。
将识别结果传递到下游阶段，并计算 group_report。
在明确指定的输出目录中创建或更新 account_group_report 成果。
如果配置了 SMTP 或 HTTP 发送方式，则执行声明的操作，并返回发送回执，其中包含 sent、delivered、failed 或 unconfigured 等结果状态。
如果未配置发送方式，则将报告保存在本地，且不调用任何外部服务。发送错误会以非零退出状态报告。

配置指南

使用 Python 运行工作流，并提供输入 JSON 文件和明确指定的输出目录。随附的 examples/request.json 是示例输入，examples/expected.json 展示了两阶段输出结构；运行时路径和回执标识符不包含在该示例中。
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 对象。发送目标、凭据和收件人必须在运行时明确提供。

数据架构

该技能处理 report_request 输入，在识别阶段计算 report_predicate，并生成下游 group_report 业务结果。其声明的业务效果为 account_group_report。
路径或字段 用途
examples/request.json 随附的上游输入示例。
examples/expected.json 完整两阶段输出结构示例，不含运行时路径和回执标识符。 --output-dir 创建或更新本地业务成果的明确指定位置。 scripts/upstream/ 识别阶段实现：operation.py、validation.py 和 config.json。
scripts/downstream/ 下游发送阶段实现，包括 deliver_effect。
source-map.json 记录两个提取阶段的来源信息。
发送回执 配置发送方式后，报告实际发送结果，状态包括 sent、delivered、failed 或 unconfigured。

高级特性

在一个可执行工作流中整合识别、业务结果计算、本地成果创建和可选发送。
支持两种发送渠道：SMTP 消息发送，以及 HTTP 登记或提交。
可通过运行时环境变量或明确指定的 --delivery-config 文件提供发送配置。
未配置发送目标时，本地运行与外部服务隔离。
对已配置的操作返回发送回执，并在发送出错时以非零状态退出。
包含独立的上游和下游实现，以及记录阶段来源信息的 source map。

name: Account Report Recipe Planner description: >- Compose an account grouping recipe. Then it executes the downstream business step: Build a grouped account report. 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 Account Report Recipe 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 (report_request) and computes the identification result (report_predicate).
Deliver — feeds the identification result into the downstream operation, computes the business result (group_report), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: account_group_report.
Real delivery — when a delivery target is configured, performs the declared business action (account_group_report) 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
对账阈值规划器
事件回调规划器