服务容量窗口规划器

安装指南

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

什么是

服务容量窗口规划器是一项可执行工作流，它接收 capacity_request，计算匹配的 capacity_window，并将结果转换为 capacity_ledger_entry。它在一次运行中结合识别与后续业务处理，并在你指定的输出目录中创建或更新本地 capacity_window_ledger 业务产物。
作为适用于业务工作流的实用 Openclaw Skills 之一，它支持通过 SMTP 或 HTTP 端点进行可选的实际发送。默认情况下禁用发送：如果没有明确配置，该技能只会在本地记录业务产物，不会联系任何外部服务。

应用场景

将收到的服务容量请求转换为计算所得的容量窗口和台账记录。
维护本地容量窗口台账，以便审核或后续处理。
工作流生成业务结果后，通过 SMTP 发送已配置的消息。
将容量窗口记录注册或提交到 HTTP 端点。
使用随附的示例输入和预期输出结构测试完整的两阶段工作流。

工作原理

读取并验证通过 --input 提供的上游 capacity_request。
运行识别阶段以计算 capacity_window。
将识别结果传递给下游阶段，并计算 capacity_ledger_entry。
在明确提供的 --output-dir 下创建或更新 capacity_window_ledger 业务产物。
如果配置了 SMTP 或 HTTP 发送，则执行声明的外部操作，并返回发送回执；回执结果可能为 sent、delivered、failed 或 unconfigured。
如果未配置发送，则将记录保留在本地，且不发起任何外部服务请求。发送错误会导致非零退出状态。

配置指南

使用 Python 运行工作流，并提供输入 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 对象。发送目标、凭据和收件人必须在运行时明确提供。未设置发送选项时，工作流仅在本地运行。

数据架构

工作流会处理以下业务数据阶段：
阶段 数据 用途
输入 capacity_request 由识别阶段读取的上游请求。
识别结果 capacity_window 计算所得并传递给下游的服务容量窗口。
业务结果 capacity_ledger_entry 下游操作的结果。
本地产物 capacity_window_ledger 在 --output-dir 下创建或更新的业务记录。
可选发送结果 delivery 回执 报告已配置的实际发送操作结果。
仓库文件组织如下：
examples/request.json — 随附的上游输入。
examples/expected.json — 完整两阶段输出结构示例；不包含运行时路径和回执标识符。
scripts/run.py — 完整的工作流运行程序。
scripts/upstream/ — 识别实现，包括 operation.py、validation.py 和 config.json。
scripts/downstream/ — 下游发送实现，包括 deliver_effect。
source-map.json — 两个提取阶段的来源信息。

高级特性

在单个可执行工作流中结合上游识别和下游业务处理。
支持可选的 SMTP 消息发送，以及通过 HTTP 注册或提交。
接受来自运行时环境变量或显式 --delivery-config 文件的发送配置。
默认仅在本地运行，未配置发送时不会发起外部请求。
为已配置的发送尝试返回发送回执，并在出错时以非零状态退出。
附带示例请求和预期输出结构，可用于工作流测试。
Openclaw Skills 用户可以通过来源映射检查独立的上游和下游实现及其来源信息。

name: Service Capacity Window Planner description: >- Select a service capacity window. Then it executes the downstream business step: Record a capacity-window entry. 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 Service Capacity Window 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 (capacity_request) and computes the identification result (capacity_window).
Deliver — feeds the identification result into the downstream operation, computes the business result (capacity_ledger_entry), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: capacity_window_ledger.
Real delivery — when a delivery target is configured, performs the declared business action (capacity_window_ledger) 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
发布变更分析器
工作区访问权限比较器