账户合并指南

安装指南

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

什么是

账户合并指南是一个用于处理账户修订版本的可执行两阶段工作流。它读取 revision_profile，计算 merge_guidance，将该结果传递给下游合并操作，并将生成的 merge_result 写入明确指定的输出目录。
默认情况下，工作流会在本地记录业务产物，不会联系任何外部服务。配置 SMTP 或 HTTP 交付目标后，它会执行声明的操作并返回交付回执。这让 Openclaw Skills 用户能够清楚地区分本地处理与实际交付。

应用场景

使用提供的请求 JSON 文件处理账户修订版本。
生成本地账户合并业务产物，以供审核或下游使用。
在合并工作流中通过 SMTP 发送已配置的消息。
通过已配置的 HTTP 端点注册或提交合并记录。
未配置交付时，在本地运行工作流，不联系外部服务。

工作原理

读取上游输入文件，例如包含 revision_profile 的 examples/request.json。
运行识别阶段，验证并处理输入，生成 merge_guidance。
将识别结果传递给下游操作并计算 merge_result。
在必需的 --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。对于 HTTP 注册或提交，请设置 CLAWHUB_DELIVERY_ENDPOINT；CLAWHUB_DELIVERY_API_KEY 为可选项。也可以通过文件提供交付配置，其中包含相关 SMTP 字段（smtp_host、smtp_port、from_addr）或 HTTP endpoint 详细信息。收件人和交付凭据必须在运行时明确提供。未设置交付目标时，执行仅在本地进行。

数据架构

阶段 输入或输出 用途
识别 revision_profile 上游账户修订版本输入
识别 merge_guidance 计算得到并传递至下游的识别结果
交付 merge_result 账户合并操作的业务结果
交付 delivery 回执 配置交付时报告实际交付结果
关键文件和目录：
examples/request.json — 随附的上游输入。
examples/expected.json — 完整两阶段输出结构示例；不包含运行时路径和回执标识符。
scripts/upstream/ — 识别阶段实现，包括 operation.py、validation.py 和 config.json。
scripts/downstream/ — 下游交付实现，包括 deliver_effect。
scripts/run.py — 完整工作流运行器。
source-map.json — 两个提取阶段的来源信息。
本地业务产物会在明确指定的 --output-dir 下创建或更新。

高级特性

在一个可执行工作流中整合识别、业务结果计算、本地产物创建和可选交付。
支持通过运行时配置进行 SMTP 消息交付，以及 HTTP 注册或提交。
默认禁用外部操作；未配置交付时，仅在本地运行。
配置交付操作后，返回说明结果的交付回执。
使用明确的运行时设置指定交付目标、凭据和收件人，而非将其嵌入工作流。
发生错误时返回非零退出状态。

name: Account Merge Guide description: >- Set account merge guidance. Then it executes the downstream business step: Merge an account revision. 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 Account Merge Guide — 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 (revision_profile) and computes the identification result (merge_guidance).
Deliver — feeds the identification result into the downstream operation, computes the business result (merge_result), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_account_merge.
Real delivery — when a delivery target is configured, performs the declared business action (local_account_merge) 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

ASO Audit

ent-meta-connect