供应商名称解析指南

安装指南

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

什么是

供应商名称解析指南是一套可执行的 Openclaw Skills 工作流，使用注册数据和感知后缀的匹配方式来统一供应商别名。它在一次运行中结合识别和后续处理：读取匹配请求、计算供应商匹配结果，并创建或更新本地业务产物。
明确配置 SMTP 或 HTTP 送达目标后，工作流还可以执行声明的外部操作，并返回回执，显示送达状态是已发送、已送达、失败还是未配置。若未设置送达选项，工作流将在本地运行，不会联系任何外部服务。

应用场景

使用注册数据，将供应商或供货商别名统一为规范名称。
根据结构化匹配请求生成本地实体匹配报告。
使用一条命令运行从识别到业务产物生成的完整工作流。
配置经授权的送达目标后，发送消息或提交注册记录。
无需配置外部服务，即可在本地测试或预览工作流。

工作原理

从提供的输入 JSON 中读取上游的 matching_request。
在上游识别阶段验证并处理请求，生成 matching_guidance。
将识别结果传递给下游阶段，由其计算 match_result。
在明确指定的输出目录下创建或更新 local_entity_match_report。
如果通过环境或送达配置文件配置了 SMTP 或 HTTP 送达，则执行声明的操作并返回送达回执；否则，将结果保留在本地。
若发生送达错误，则以非零进程退出状态报告。

配置指南

使用 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。或者，使用包含 smtp_host、smtp_port 和 from_addr 的 SMTP 送达配置对象。
如需通过 HTTP 注册或提交，请设置 CLAWHUB_DELIVERY_ENDPOINT，并可选设置 CLAWHUB_DELIVERY_API_KEY；也可以通过送达配置文件提供端点。送达目标、凭据和收件人必须来自运行时配置。若未配置送达选项，工作流将保持本地运行，不会发起任何外部调用。

数据架构

工作流接收结构化的上游请求，并生成两阶段结果。捆绑的 examples/expected.json 说明了预期的输出结构；运行时路径和回执标识符不包含在该示例中。
数据或文件 用途
matching_request 识别阶段使用的输入。
matching_guidance 传递给下游处理的识别结果。
match_result 计算得出的供应商匹配业务结果。
local_entity_match_report 在 --output-dir 下创建或更新的本地业务产物。
delivery 描述已配置送达结果的回执：sent、delivered、failed 或 unconfigured。
examples/request.json 捆绑的上游输入示例。
examples/expected.json 完整两阶段输出结构示例。
source-map.json 两个提取出的工作流阶段的来源信息。
实现按以下方式组织：scripts/upstream/ 用于识别（operation.py、validation.py 和 config.json），scripts/downstream/ 用于送达处理和 deliver_effect，而 scripts/run.py 用于运行完整工作流。

高级特性

在一个可执行工作流中结合识别和下游业务处理。
支持结合注册数据进行感知后缀的供应商名称匹配。
外部操作采用主动选择方式：未配置运行时送达选项时，仅在本地写入，不会联系任何外部服务。
支持通过环境变量或明确指定的送达配置文件进行 SMTP 消息发送以及 HTTP 注册或提交。
返回包含所报告结果的送达回执，并在发生错误时使用非零退出状态。
包含独立的上游和下游实现，并在
source-map.json
中提供来源信息。

name: Supplier Name Resolution Guide description: >- Reconcile vendor aliases into a canonical supplier name using registration data and suffix-aware matching. Then it executes the downstream business step: Reconcile supplier names. 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 Supplier Name Resolution 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 (matching_request) and computes the identification result (matching_guidance).
Deliver — feeds the identification result into the downstream operation, computes the business result (match_result), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_entity_match_report.
Real delivery — when a delivery target is configured, performs the declared business action (local_entity_match_report) 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
内容处理指南
制品交付规划器