服务类规划器

安装指南

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

什么是

服务类规划器是一项端到端业务工作流技能，可读取 task_profile，计算 scheduling_guidance，并利用结果构建 task_schedule。它会在明确指定的输出目录下写入本地业务文件，将识别和后续执行整合在一次运行中。
配置 SMTP 或 HTTP 交付目标后，该技能可以执行声明的交付操作，并返回说明结果的回执。未配置交付时，它仅在本地运行，不会联系任何外部服务。因此，它是 Openclaw Skills 的实用补充，可用于可重复的任务规划，并支持可选且明确的交付步骤。

应用场景

将收到的任务配置文件转换为排期指导和完整的运营任务计划。
为后续业务工作流创建或更新本地任务计划文件。
当工作流需要通知时，通过 SMTP 发送已配置的消息。
通过已配置的 HTTP 端点登记或提交业务记录。
未配置交付目标时，在本地运行工作流，不进行外部调用。
使用捆绑的示例输入和预期结果检查预期输出结构。

工作原理

从输入 JSON 文件读取上游 task_profile。
使用上游识别阶段验证并处理输入，以计算 scheduling_guidance。
将指导信息传递给下游操作，由其计算 task_schedule。
在指定的 --output-dir 下创建或更新本地业务文件。
如果通过环境变量或交付配置文件配置了 SMTP 或 HTTP 交付，则执行声明的操作。
返回交付回执，结果可能为 sent、delivered、failed 或 unconfigured；交付错误会导致非零退出状态。

配置指南

使用 Python 运行捆绑的工作流，并提供输入 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 对象。交付目标、凭据和收件人均在运行时提供。未配置交付时，该技能只写入本地文件，不会发出外部请求。捆绑的 examples/expected.json 描述了输出结构；运行时路径和回执标识符不包含在其中。

数据架构

该工作流使用 JSON 输入和输出数据：
数据元素 作用
task_profile 描述待规划任务的上游输入。
scheduling_guidance 识别阶段的结果，供下游操作使用。
task_schedule 计算得出的运营计划业务结果。
delivery 在适用时报告实际交付结果的回执。
关键文件和目录：
examples/request.json — 捆绑的上游输入示例。
examples/expected.json — 完整两阶段输出结构示例。 --output-dir — 本地业务文件的必需目标目录。 scripts/upstream/operation.py、scripts/upstream/validation.py 和 scripts/upstream/config.json — 识别阶段的实现和配置。
scripts/downstream/ — 下游交付阶段实现，包括 deliver_effect。
scripts/run.py — 完整工作流运行器。
source-map.json — 两个提取阶段的来源信息。

高级特性

将识别和下游排期整合为一个可执行工作流。
支持可选的 SMTP 消息交付，以及 HTTP 登记或提交。
接受来自运行时环境变量或显式 --delivery-config 文件的交付设置。
未配置交付目标时，默认仅在本地运行。
返回交付回执，以区分
sent
、
delivered
、
failed
unconfigured
等结果。
交付错误会以非零退出状态报告。
包含特定阶段的实现、验证、配置和来源信息，便于检查。

name: Service Class Planner description: >- Set service-class guidance for a task. Then it executes the downstream business step: Build an operations task schedule. 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 Class 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 (task_profile) and computes the identification result (scheduling_guidance).
Deliver — feeds the identification result into the downstream operation, computes the business result (task_schedule), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_task_schedule.
Real delivery — when a delivery target is configured, performs the declared business action (local_task_schedule) 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
交付确认指南
受众准备指南