审批组目录

安装指南

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

什么是

审批组目录是一个 Openclaw Skills 工作流，它接收 review_request，确定其 reviewer_group，并将结果处理为 recorded_group 业务产物。其单一可执行运行器在同一工作流中结合了识别和后续记录处理。默认情况下，该技能会将业务记录写入明确指定的输出目录下，且不会联系任何外部服务。配置 SMTP 或 HTTP 交付端点以启用实际交付，然后检查返回的回执以了解结果。

应用场景

将传入的审核请求路由到已识别的审核人员组。
为请求创建或更新本地业务记录，而不联系外部服务。
在工作流中通过 SMTP 发送已配置的消息。
通过已配置的 HTTP 端点登记或提交请求记录。
使用随附的示例输入和预期输出测试完整的两阶段工作流。

工作原理

读取并验证上游 review_request 输入。
运行识别阶段，计算 reviewer_group 结果。
将识别结果传递给下游操作并计算 recorded_group。
在提供的 --output-dir 下创建或更新 review_request_record 产物。
如果已配置交付，则执行声明的外部操作，并返回包含 sent、delivered、failed 或 unconfigured 等结果的 delivery 回执。
以非零退出状态报告交付错误。未配置交付时，将记录保留在本地，且不调用任何外部服务。

配置指南

使用 Python 运行工作流，并提供输入 JSON 文件和明确的输出目录：
python scripts/run.py --input examples/request.json --output-dir ./workspace
若要从文件提供交付设置，请添加 --delivery-config delivery.json：
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 对象的交付配置。交付目标、凭据和收件人需在运行时明确提供。未提供这些信息时，该技能仅在本地运行。

数据架构

该工作流接收上游 JSON 请求，并生成两阶段结果。examples/expected.json 记录了输出结构；该示例不包含运行时路径和回执标识符。
数据或文件 用途
examples/request.json 随附的上游 review_request 输入。
reviewer_group 由识别阶段计算的结果。
recorded_group 由下游操作计算的业务结果。
review_request_record 在 --output-dir 下创建或更新的本地业务产物。
delivery 配置目标时描述实际交付结果的回执。
examples/expected.json 完整两阶段输出结构示例。
source-map.json 两个提取阶段的来源信息。
实现按以下方式组织：scripts/upstream/ 用于识别（operation.py、validation.py 和 config.json），scripts/downstream/ 用于交付及其 deliver_effect，scripts/run.py 用于完整工作流。

高级特性

在单个可执行技能中结合上游识别和下游业务处理。
支持可选的 SMTP 消息交付以及 HTTP 登记或提交。
默认禁用外部交付；未明确配置时，仅在本地写入，不联系外部服务。
配置交付目标时，返回包含实际结果的交付回执。
使用非零进程退出状态报告交付错误。
附带预期输出示例和记录两阶段工作流的来源映射。

name: Approval Group Directory description: >- Select a reviewer group. Then it executes the downstream business step: Register a request reviewer group. 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 Approval Group Directory — 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 (review_request) and computes the identification result (reviewer_group).
Deliver — feeds the identification result into the downstream operation, computes the business result (recorded_group), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: review_request_record.
Real delivery — when a delivery target is configured, performs the declared business action (review_request_record) 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
配送要求顾问
处理能力规划器