高管报告样式指南

安装指南

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

什么是

高管报告样式指南是一个可执行的 Openclaw Skills 工作流，可将样式请求转换为格式化的业务报告。它在一次运行中结合样式识别、报告格式化和本地产物创建，并在你指定的输出目录下生成报告预览。
发送是可选且明确的：配置 SMTP 以发送消息，或配置 HTTP 端点以登记或提交记录。未设置发送配置时，工作流仅在本地运行，不会联系任何外部服务；配置发送后，它会返回一份报告结果的回执。

应用场景

为高管、客户或项目利益相关者格式化定期状态报告。
在创建本地预览前，将
style_request
转换为一致的报告格式。
在需要外部发送前进行审阅时，生成本地业务产物。
配置发送目标和收件人后，通过 SMTP 发送格式化报告。
通过 HTTP 端点登记或提交报告记录。
验证端到端报告工作流，包括业务结果和发送结果。

工作原理

从提供的输入 JSON 中读取上游 style_request。
识别请求的样式并计算 format_mode。
将识别结果传递给下游格式化操作，并计算 applied_format。
在明确提供的输出目录下创建或更新本地报告预览。
如果配置了 SMTP 或 HTTP 发送，则执行声明的发送操作，并返回包含 sent、delivered、failed 或 unconfigured 等结果的回执。
如果未配置发送，则将业务产物保留在本地，不发起外部请求。发送错误会以非零退出码报告。

配置指南

从 skill 目录使用 Python 运行工作流。随附的请求是示例输入；examples/expected.json 记录了预期的输出结构，但不包括运行时路径和回执标识符。
python scripts/run.py --input examples/request.json --output-dir ./workspace
如需提供明确的发送配置，请添加 --delivery-config：
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 对象。请在运行时明确提供发送目标、凭据和收件人。

数据架构

该工作流使用两阶段业务数据流：
阶段 输入或结果 用途
上游识别 style_request → format_mode 确定报告格式化模式。
下游格式化 format_mode → applied_format 计算并应用请求的报告样式。
本地产物 local_report_preview 在所需的 --output-dir 下创建或更新报告。
可选发送 delivery 回执 记录外部操作结果：sent、delivered、failed 或 unconfigured。
关键文件：
examples/request.json — 随附的上游输入。
examples/expected.json — 完整两阶段输出结构示例；不包括运行时路径和回执标识符。
scripts/upstream/operation.py、scripts/upstream/validation.py 和 scripts/upstream/config.json — 识别阶段的实现和配置。
scripts/downstream/ — 格式化和发送阶段的实现，包括 deliver_effect。
scripts/run.py — 端到端工作流运行器。
source-map.json — 两个提取阶段的来源信息。

高级特性

将识别、格式化、本地产物创建和可选发送作为一个可执行工作流运行。
支持两种明确的发送模式：SMTP 消息发送和 HTTP 登记或提交。
保持发送为主动选择，并使用运行时提供的目标和凭据；未配置时不会进行外部调用。
返回可区分发送结果的发送回执，包括
unconfigured
。
通过非零进程退出码报告发送错误。
包含独立的上游和下游阶段实现、验证和配置文件，以及来源信息。

name: Executive Report Style Guide description: >- Set the style guidance for an executive report. Then it executes the downstream business step: Format a status report for stakeholders. 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 Executive Report Style 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 (style_request) and computes the identification result (format_mode).
Deliver — feeds the identification result into the downstream operation, computes the business result (applied_format), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_report_preview.
Real delivery — when a delivery target is configured, performs the declared business action (local_report_preview) 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
发票舍入指南
交付恢复指南