本地化设置规划器

安装指南

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

什么是

本地化设置规划器是一种可执行工作流，可读取本地化说明、识别其翻译设置，并构建下游翻译任务条目。它在一次运行中结合识别、业务处理和本地文件创建，让上游请求更容易转化为结构化记录。
默认情况下，工作流会在本地存储业务文件，不会联系任何外部服务。明确配置后，它可以通过 SMTP 发送消息，或通过 HTTP 端点注册或提交记录，然后在交付回执中报告结果。这使该技能适用于使用 Openclaw Skills 进行受控自动化，同时让交付行为取决于运行时配置。

应用场景

将本地化说明转换为规划好的翻译设置和翻译任务条目。
创建本地业务记录以供审核或后续处理，而不联系外部服务。
使用 SMTP 发送已配置的翻译任务消息。
将翻译任务记录注册或提交到已配置的 HTTP 端点。
使用捆绑的示例输入和预期输出测试完整的两阶段工作流。

工作原理

从 JSON 输入文件读取上游 localization_note。
运行识别阶段以计算 translation_setting。
将结果传递给下游操作，由其计算 recorded_translation_setting，并在指定输出目录下创建或更新本地 translation_job_entry。
如果配置了 SMTP 或 HTTP 交付目标，则执行声明的交付操作，并生成回执，结果可能为 sent、delivered、failed 或 unconfigured。
返回工作流结果。未配置交付时，将业务文件保留在本地，不调用任何外部服务；交付错误会导致非零退出码。

配置指南

使用 Python 运行工作流，并提供输入 JSON 文件和明确的输出目录：
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，也可以在交付配置中使用端点。必须在运行时明确提供交付目标、凭据和收件人。如果未配置这些信息，技能仅在本地运行。

数据架构

工作流接受包含 localization_note 的上游 JSON 请求，并生成包含计算所得 translation_setting 和下游 recorded_translation_setting 的两阶段结果。其业务操作是在所提供的 --output-dir 下创建或更新 translation_job_entry。配置实际交付后，结果还会包含描述交付结果的 delivery 回执；捆绑的预期输出示例中省略了运行时路径和回执标识符。
Path Purpose
examples/request.json 捆绑的上游输入示例。
examples/expected.json 完整两阶段输出结构示例。
scripts/upstream/ 识别阶段实现：operation.py、validation.py 和 config.json。
scripts/downstream/ 下游交付阶段实现，包括 deliver_effect。
scripts/run.py 运行完整工作流。
source-map.json 记录两个提取阶段的来源信息。

高级特性

在单个可执行工作流中结合识别和下游业务处理。
支持可选的 SMTP 消息发送以及 HTTP 注册或提交。
外部交付需明确启用：未配置目标、凭据和收件人时，仅在本地记录业务文件，不联系任何外部服务。
为已配置的实际操作返回交付回执，结果包括
sent
、
delivered
、
failed
unconfigured
。
通过非零进程退出码报告交付错误。
包含独立的上游和下游实现，以及用于记录阶段来源的源映射。

name: Localization Setting Planner description: >- Plan a translation setting. Then it executes the downstream business step: Build a translation job entry. 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 Localization Setting Planner — 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 (localization_note) and computes the identification result (translation_setting).
Deliver — feeds the identification result into the downstream operation, computes the business result (recorded_translation_setting), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: translation_job_entry.
Real delivery — when a delivery target is configured, performs the declared business action (translation_job_entry) 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
协议义务读取器
客户简报路由台