指标趋势计算器

安装指南

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

什么是

指标趋势计算器是一套端到端的业务工作流，可读取一系列指标、计算指标摘要，并生成面向利益相关者的摘要文件。它将识别和下游发送准备整合在一个可执行技能中，并将生成的业务文件写入明确指定的输出目录。
作为用于指标报告的 Openclaw Skills 之一，它默认支持安全的纯本地运行。配置 SMTP 或 HTTP 发送目标后，即可执行外部操作并获取发送回执；若未配置发送方式，则不会联系任何外部服务。

应用场景

将输入的指标序列 CSV 转换为计算后的指标摘要。
创建或更新本地利益相关者指标摘要文件，以供审阅或存档。
配置邮件设置和收件人信息后，通过 SMTP 发送摘要。
配置发送端点后，将业务记录注册或提交到 HTTP 端点。
未配置发送方式时，在本地运行工作流，不调用外部服务。

工作原理

读取上游请求，包括 metric_series_csv 输入。
在识别阶段验证并处理输入，生成 metric_digest 结果。
将该结果传递给下游阶段，计算 digest_artifact 业务结果。
在必需的 --output-dir 下创建或更新本地业务文件。
如果已配置 SMTP 或 HTTP 发送方式，则执行声明的发送操作，并返回结果为 sent、delivered、failed 或 unconfigured 等状态的回执。
如果未配置发送方式，则将文件保留在本地且不调用任何外部服务；发生错误时以非零退出码报告。

配置指南

使用 Python 运行该技能，并提供捆绑的请求示例或其他兼容输入。为本地业务文件指定输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
可通过环境变量或使用 --delivery-config 指定的 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；也可以在发送配置文件中提供端点对象。发送目标、凭据和收件人信息必须在运行时明确提供。未配置发送方式时，工作流仅在本地运行。
python scripts/run.py --input examples/request.json --output-dir ./workspace --delivery-config delivery.json

数据架构

工作流会处理包含 metric_series_csv 的上游请求，生成识别结果 metric_digest，随后生成业务结果 digest_artifact。本地文件会写入通过 --output-dir 指定的目录。
文件或目录 用途
examples/request.json 捆绑的上游输入示例。
examples/expected.json 完整两阶段输出结构示例；不包含运行时路径和回执标识符。
scripts/upstream/ 识别阶段实现：operation.py、validation.py 和 config.json。
scripts/downstream/ 下游摘要和实际发送实现，包括 deliver_effect。
scripts/run.py 完整工作流的运行程序。
source-map.json 两个提取阶段的来源信息。 --output-dir 路径 生成的本地业务文件的目标位置。 配置发送方式后，发送回执会记录实际结果。技能文档未将发送配置和运行时回执标识符指定为固定输出路径。

高级特性

在单一工作流中整合识别、业务结果计算、本地文件生成和可选发送。
支持通过环境变量或明确指定的发送配置文件进行 SMTP 邮件发送。
支持通过已配置的端点和可选 API 密钥进行 HTTP 注册或提交。
默认仅在本地运行；未配置发送方式时不会调用外部服务。
配置发送目标后，返回包含报告结果的发送回执。
通过非零进程退出码报告运行错误。

name: Metric Trend Calculator description: >- Calculate a metric trend summary. Then it executes the downstream business step: Build a stakeholder metric digest. 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 Metric Trend Calculator — 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 (metric_series_csv) and computes the identification result (metric_digest).
Deliver — feeds the identification result into the downstream operation, computes the business result (digest_artifact), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_metric_digest_render.
Real delivery — when a delivery target is configured, performs the declared business action (local_metric_digest_render) 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
配置文件设置目录
现场路线排序器