营销活动预算预测器

安装指南

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

什么是

营销活动预算预测器是一项可执行的业务工作流，它读取规划说明，识别并计算方案金额，然后将结果记录为财务规划账簿条目。它的两个阶段——识别和交付——通过一条命令共同运行，因此它是 Openclaw Skills 中可将上游规划输入转化为可追溯业务记录的工具之一。
默认情况下，该技能会将文件写入明确提供的输出目录下，且不会建立任何外部连接。配置 SMTP 或 HTTP 交付端点即可执行实际声明的操作；随后，工作流会返回一份回执，说明交付已发送、已送达、失败或未配置。

应用场景

根据规划说明预测营销活动预算方案。
创建或更新本地财务规划账簿条目，以供审阅或存档。
将规划记录提交到已配置的 HTTP 端点。
通过 SMTP 发送有关生成的业务记录的已配置消息。
运行端到端工作流，并在发生交付错误时以非零退出状态报告。

工作原理

读取上游规划输入，通常为 examples/request.json，其中包含 planning_note。
运行识别阶段，计算方案 amount。
将金额传递给下游阶段，计算 recorded_amount，并在所提供的输出目录下创建或更新本地 finance_planning_ledger_entry。
检查运行时交付配置。如果已配置 SMTP 或 HTTP 端点，则执行声明的外部操作；否则，仅在本地执行操作。
返回工作流结果，并在适用时返回包含实际结果的交付回执。交付错误会导致非零退出状态。

配置指南

使用 Python 从技能目录运行工作流，并明确指定输入文件和输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
如需配置可选交付，可以传入交付配置文件或设置环境变量。SMTP 支持 CLAWHUB_SMTP_HOST，以及可选的 CLAWHUB_SMTP_PORT、CLAWHUB_MAIL_FROM、CLAWHUB_SMTP_USERNAME 和 CLAWHUB_SMTP_PASSWORD。HTTP 注册或提交支持 CLAWHUB_DELIVERY_ENDPOINT，以及可选的 CLAWHUB_DELIVERY_API_KEY。
python scripts/run.py --input examples/request.json --output-dir ./workspace --delivery-config delivery.json
交付配置文件可以提供 smtp_host、smtp_port 和 from_addr 等 SMTP 设置，或提供 HTTP endpoint 对象。必须在运行时明确提供交付目标、凭据和收件人。未配置交付时，工作流只会写入本地业务文件，不会联系任何外部服务。输出格式请参见 examples/expected.json；运行时路径和回执标识符不包含在其中。

数据架构

工作流处理上游规划输入，并生成两阶段结果：
数据元素 作用
planning_note 识别阶段使用的上游输入。
amount 由识别阶段计算的方案金额。
recorded_amount 由下游交付阶段计算的业务结果。
finance_planning_ledger_entry 在 --output-dir 下创建或更新的本地业务文件。
delivery 描述实际交付结果的可选回执：sent、delivered、failed 或 unconfigured。
关键文件包括 examples/request.json（随附输入）、examples/expected.json（代表性输出格式）、scripts/upstream/（识别实现、验证和配置）、scripts/downstream/（交付实现和 deliver_effect）、scripts/run.py（工作流运行器）以及 source-map.json（两个提取阶段的来源信息）。输出目录由用户提供；运行时路径和回执标识符可能有所不同。

高级特性

在一个可执行工作流中整合识别、业务结果计算、本地文件写入和可选交付。
通过明确的运行时配置支持 SMTP 消息发送以及 HTTP 注册或提交。
默认仅在本地运行；未配置交付时不会调用外部服务。
配置目标后，返回包含所报告外部结果的交付回执。
发生错误时以非零进程退出状态报告。
包含独立的上游和下游实现、验证与配置文件，以及来源信息。

name: Campaign Budget Forecaster description: >- Forecast a scenario amount. Then it executes the downstream business step: Append a scenario planning amount. 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 Campaign Budget Forecaster — 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 (planning_note) and computes the identification result (amount).
Deliver — feeds the identification result into the downstream operation, computes the business result (recorded_amount), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: finance_planning_ledger_entry.
Real delivery — when a delivery target is configured, performs the declared business action (finance_planning_ledger_entry) 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
候选人技能映射器
发布变更分析器