容量台账工作台

安装指南

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

什么是

容量台账工作台是用于日常服务容量规划的 Openclaw Skills 工具。提供一个时区感知的 capacity_window，它会返回一个 capacity_ledger_entry，其中包含时段日期、持续时间、时段数量、容量状态和重叠状态。
该技能处理当前请求时无需凭据或访问私有文件。它可以在指定的输出目录中创建或更新本地业务文件；配置交付后，它还可以执行所声明的业务操作并返回回执。

应用场景

将服务容量时段记录为日常容量规划的一部分。
生成包含时段持续时间和时段可用性字段的台账条目。
保存本地容量文件，供后续业务工作流使用。
配置适当的交付目标后，发送、登记或提交记录。

工作原理

在 capacity_window 输入字段中提供带时区的日期时间值。
使用请求 JSON 和明确指定的输出目录运行捆绑操作。
该技能验证输入并计算 capacity_ledger_entry 结果。
该操作会在输出目录下创建或更新本地业务文件。
如果配置了交付目标，该操作会执行所声明的外部操作并返回交付回执；否则不会联系任何外部服务。
检查命令输出和任何回执。非零退出代码表示失败。

配置指南

使用 Python 3.10 或更高版本。此软件包仅使用 Python 标准库依赖项。将请求保存为包含指定 capacity_window 字段的 JSON，然后从已安装的软件包目录运行该操作：
python scripts/run.py --input examples/request.json --output-dir ./workspace
捆绑示例展示了输入格式。请将其替换为包含要记录的服务时段的请求。未配置交付时，该操作会在本地写入业务文件。若要进行外部交付，请配置适用的环境变量，或提供明确的交付配置 JSON 文件。

数据架构

输入和返回的业务结果结构如下：
Field Purpose
capacity_window 输入：带时区的服务时段日期时间。
capacity_ledger_entry 输出对象，包含容量时段台账结果。
capacity_entry_id 台账条目的标识符。
start_at, end_at 服务时段的开始和结束时间。
duration_minutes 时段持续时间，单位为分钟。
total_slots, requested_slots, reserved_slots, available_slots 容量和时段数量字段。
capacity_status, overlap_status 容量和重叠状态字段。
该操作会在明确指定的 --output-dir 下创建或更新本地业务文件。源代码未指定文件名称或更详细的记录分类。实现位于 scripts/operation.py；输入和输出验证位于 scripts/validation.py；角色配置位于 scripts/config.json。

高级特性

支持离线本地文件工作流；未配置交付时不会联系外部服务。
支持通过
CLAWHUB_SMTP_HOST
、
CLAWHUB_SMTP_PORT
CLAWHUB_MAIL_FROM
配置消息交付。
支持通过
CLAWHUB_DELIVERY_ENDPOINT
或明确指定的 --delivery-config JSON 文件执行登记和提交操作。
执行已配置的交付操作时返回交付回执。
仅使用 Python 标准库依赖项，并包含示例值和已配置的本地记录，以确保可复现性。
只执行其声明的容量时段操作。

name: service-capacity-window-workbench description: Record a capacity-window entry. version: 1.1.1 metadata: openclaw: skillKey: service-capacity-window-workbench

Capacity Ledger Desk

Use this skill for routine service capacity planning work when the user asks to record a capacity-window entry.

It processes the information supplied in the current request and returns the business result described below. It does not require credentials or access to private files.

Input

Field: capacity_window

Timezone-aware service window selected for the capacity ledger.

Accepted value: date-time.

Output

Field: capacity_ledger_entry

Return a concise capacity ledger entry for the user's current request in the requested output field. The returned value is a object with capacity_entry_id, start_at, end_at, duration_minutes, total_slots, requested_slots, reserved_slots, available_slots, capacity_status, overlap_status.

Example Request

Use the supplied capacity_window to record a capacity-window entry.
Return the result in capacity_ledger_entry.

Bundled execution

Use Python 3.10 or newer to run this operation from the installed package directory. Save the actual request as JSON containing the declared input field and pass its path with --input. The bundled example demonstrates the input shape.

python scripts/run.py --input examples/request.json --output-dir ./workspace

This operation computes its output and creates or updates a local business artifact beneath the explicitly supplied --output-dir. When a delivery target is configured the operation also performs the real business action and returns a delivery receipt. Effect: capacity_window_ledger.

Report the actual command output and, when present, its effect receipt. A nonzero exit means the operation failed. This package executes only its declared operation.

The implementation is scripts/operation.py, input/output validation is scripts/validation.py, and role configuration is scripts/config.json. All Python dependencies are from the standard library. Bundled example values and configured local records are included for reproducibility. Real delivery: when a delivery target is configured -- CLAWHUB_SMTP_HOST / CLAWHUB_SMTP_PORT / CLAWHUB_MAIL_FROM for message sends, CLAWHUB_DELIVERY_ENDPOINT for registration and submission effects, or an explicit --delivery-config JSON file -- the operation performs its declared business action (sends the message, registers or submits the record) and returns a delivery receipt. Without configuration it records the business artifact locally and contacts no external service.

库存补货规划器
部署简报登记