协议义务读取器

安装指南

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

什么是

Agreement Obligation Reader 是一套端到端业务工作流，用于识别协议 Markdown 中的义务，并将所得信息添加到续约计划中。它读取 agreement_markdown 输入，计算 obligation_schedule，并在明确指定的输出目录中创建或更新本地业务产物。
配置交付目标后，工作流还可以执行声明的下游操作并返回交付回执。未配置交付时，工作流仅在本地运行，不会联系任何外部服务，因此这款 Openclaw Skills 工具既适用于本地处理，也适用于明确启用的交付。

应用场景

从协议中提取义务并编制续约计划。
创建或更新本地计划产物，供业务审核。
通过已配置的 SMTP 交付发送消息。
通过已配置的 HTTP 端点登记或提交计划。
在没有外部交付目标或凭据时于本地运行工作流。

工作原理

从通过 --input 提供的 JSON 文件读取上游请求；请求中包含 agreement_markdown 源文本。
使用上游识别阶段验证并处理协议，以计算 obligation_schedule。
将识别结果传递给下游阶段，由其计算 schedule_receipt，并在提供的 --output-dir 下写入业务产物。
如果配置了 SMTP 或 HTTP 交付，则执行声明的操作，并视情况返回报告 sent、delivered、failed 或 unconfigured 的回执。
如果未配置交付，则在本地保留业务记录，不联系外部服务。交付错误会导致非零退出状态。

配置指南

使用 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。也可以提供包含 smtp_host、smtp_port 和 from_addr 等 SMTP 设置的交付配置文件。
要通过 HTTP 登记或提交，请设置 CLAWHUB_DELIVERY_ENDPOINT，并可选设置 CLAWHUB_DELIVERY_API_KEY，或者在交付配置文件中提供端点。使用以下命令传入交付配置文件：
python scripts/run.py --input examples/request.json --output-dir ./workspace --delivery-config delivery.json
交付目标、凭据和收件人必须在运行时明确提供。未配置交付时，工作流仅执行本地处理。examples/request.json 是随附的输入文件，examples/expected.json 说明了预期的输出结构。

数据架构

输入： 通过 JSON 请求文件提供的 agreement_markdown。
识别结果： 由上游阶段计算的 obligation_schedule。
业务结果： 由下游操作生成的 schedule_receipt。
本地产物： 在明确指定的 --output-dir 下创建或更新；声明的效果为 local_renewal_schedule_append。
交付回执： 配置交付时，报告真实结果，例如 sent、delivered 或 failed；否则交付未配置，且不会联系外部服务。
工作流文件： scripts/upstream/ 包含 operation.py、validation.py 和 config.json；scripts/downstream/ 包含交付阶段实现，包括 deliver_effect；scripts/run.py 运行完整工作流；source-map.json 记录两个提取阶段的来源信息。
示例： examples/request.json 提供上游输入，examples/expected.json 展示两阶段输出结构。预期输出示例不包含运行时路径和回执标识符。

高级特性

在一个可执行工作流中整合识别、业务结果计算、本地产物创建和可选交付。
支持通过环境变量或明确提供的交付配置文件进行 SMTP 消息交付。
支持通过已配置的端点进行 HTTP 登记或提交，并可选使用 API 密钥。
交付采用选择启用方式：未明确提供运行时配置时，处理仅在本地进行，不会发出外部调用。
返回交付结果信息，并在报告交付错误时使用非零退出状态。
提供独立的上游和下游实现，以及用于记录阶段来源信息的 source map。

name: Agreement Obligation Reader description: >- Prepare an agreement obligation schedule. Then it executes the downstream business step: Add entries to a renewal 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 Agreement Obligation Reader — 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 (agreement_markdown) and computes the identification result (obligation_schedule).
Deliver — feeds the identification result into the downstream operation, computes the business result (schedule_receipt), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_renewal_schedule_append.
Real delivery — when a delivery target is configured, performs the declared business action (local_renewal_schedule_append) 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
发布分支规划器
本地化设置规划器