工作区访问权限比较器

安装指南

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

什么是

工作区访问权限比较器是一个可执行的 Openclaw Skills 工作流，可将工作区共享 ACL 转换为可执行的访问审查清单。它读取 sharing_acl_json，计算 access_delta，随后生成 checklist_artifact，并将业务记录写入明确指定的输出目录。
完整工作流支持在配置 SMTP 或 HTTP 发送设置后进行可选的实际发送。未配置发送信息时，工作流仅在本地运行，不会联系任何外部服务；尝试发送时，运行结果会返回一份说明结果的回执。

应用场景

比较工作区当前的共享 ACL，并识别访问权限变更。
为定期工作区访问审查创建本地清单。
将访问审查产物纳入运营或合规工作流。
在明确配置 SMTP 或 HTTP 发送目标后，发送消息或提交注册记录。
不需要或未配置外部发送时，在本地运行工作流。

工作原理

读取通过 --input 提供的上游输入 JSON，包括 sharing_acl_json 数据。
在上游识别阶段验证并处理输入，以计算 access_delta。
将识别结果传递给下游阶段并计算 checklist_artifact。
在通过 --output-dir 指定的目录下写入或更新本地访问清单。
如果已配置 SMTP 或 HTTP 发送，则执行声明的发送操作，并返回结果为 sent、delivered、failed 或 unconfigured 的回执。
如果未配置发送，则将业务产物保留在本地，不调用任何外部服务。发送错误会导致非零退出码。

配置指南

使用 Python 运行工作流，并提供输入文件和输出目录。随附的示例请求和预期输出展示了输入以及完整的两阶段结果。
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。或者，通过 --delivery-config 使用 smtp_host、smtp_port 和 from_addr 提供 SMTP 配置。
如需通过 HTTP 注册或提交，请设置 CLAWHUB_DELIVERY_ENDPOINT，并可选择设置 CLAWHUB_DELIVERY_API_KEY；也可以在发送配置文件中传入端点配置。发送目标详细信息、凭据和收件人必须在运行时明确提供。未提供这些信息时，工作流仅在本地运行。

数据架构

工作流采用两阶段业务数据流：
阶段 输入或输出 用途
识别 sharing_acl_json 上游工作区访问列表输入
识别 access_delta 计算得出的访问比较结果
发送 checklist_artifact 下游访问审查清单结果
本地操作 输出目录 在提供的 --output-dir 目录下存储或更新业务产物
可选发送 delivery 回执 配置发送后报告实际发送结果
关键文件和目录：
scripts/upstream/operation.py、scripts/upstream/validation.py 和 scripts/upstream/config.json 实现并配置识别阶段。
scripts/downstream/ 包含发送阶段，包括 deliver_effect。
scripts/run.py 运行完整工作流。
examples/request.json 提供随附的上游输入；examples/expected.json 记录输出结构，但不包括运行时路径和回执标识符。
source-map.json 记录两个提取阶段的来源信息。

高级特性

在一个可执行工作流中整合识别、清单生成、本地产物写入和可选发送。
将上游比较逻辑与下游清单及发送逻辑分离。
支持通过明确的运行时配置进行 SMTP 消息发送，以及 HTTP 注册或提交。
配置发送后，返回包含所报告结果的发送回执。
默认仅在本地运行；缺少发送设置时不会调用外部服务。
发送错误会以非零进程退出状态报告。
包含示例输入、预期输出、阶段配置和来源信息。

name: Workspace Access Comparator description: >- Compare workspace access lists. Then it executes the downstream business step: Create an access review checklist. 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 Workspace Access Comparator — 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 (sharing_acl_json) and computes the identification result (access_delta).
Deliver — feeds the identification result into the downstream operation, computes the business result (checklist_artifact), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_access_checklist_write.
Real delivery — when a delivery target is configured, performs the declared business action (local_access_checklist_write) 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
服务容量窗口规划器
配置文件设置目录