受众准备指南

安装指南

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

什么是

Audience Readiness Guide 是一项端到端业务工作流技能，可从 audience_request 中识别受众模式，确定哪些内容部分已准备好供客户传阅，并创建本地的客户版简报预览。它还会记录未纳入的内容，供内部跟进。
该工作流以单一产物的形式运行，将识别、业务结果生成和本地记录创建结合起来。明确配置 SMTP 或 HTTP 交付时，它会执行声明的交付操作并返回回执；未配置目标时，则仅在本地运行，不联系任何外部服务。凭借对外部交付的明确控制，这使其成为 Openclaw Skills 中用于准备利益相关方简报的实用选择。

应用场景

在决定哪些内容适合提供给客户之前，对收到的利益相关方简报进行分类。
使用已批准的内容部分生成面向客户的预览，同时保留未纳入的项目供内部跟进。
未配置交付目的地时，在本地保存业务产物。
通过 SMTP 发送消息，或通过已配置的 HTTP 端点登记或提交记录。
记录已配置的交付是已发送、已送达、失败，还是未配置。

工作原理

读取上游 audience_request JSON 输入。
运行识别阶段，计算 audience_mode 结果。
将该结果传递给下游操作，由其计算 briefing_preview，并记录未纳入的内容以供内部跟进。
在明确提供的输出目录下创建或更新本地业务产物。
如果运行时提供了交付配置，则执行声明的 SMTP 或 HTTP 操作并返回交付回执；否则，将产物保留在本地，不联系外部服务。
遇到交付错误时，以非零进程退出码报告。

配置指南

使用 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，或者在交付配置中提供 endpoint 对象。目标、凭据和收件人均需在运行时明确提供。随附的 examples/expected.json 说明了输出结构；运行时路径和回执标识符不包含在其中。

数据架构

该工作流采用两阶段输入和结果模型：
阶段或产物 作用
audience_request 由识别阶段读取的上游 JSON 请求。
audience_mode 传递给下游操作的识别结果。
briefing_preview 基于已批准内容部分、包含面向客户预览的业务结果。
local_briefing_preview 在提供的 --output-dir 下创建或更新的本地业务产物。
delivery 在配置交付时描述实际交付结果的回执；结果包括 sent、delivered、failed 或 unconfigured。
代码库文件组织如下：
scripts/upstream/：识别实现，包括 operation.py、validation.py 和 config.json。
scripts/downstream/：交付阶段实现，包括实际的 deliver_effect 操作。
scripts/run.py：完整的工作流运行程序。
source-map.json：两个提取阶段的来源信息。
examples/request.json：随附的上游输入。
examples/expected.json：输出结构参考。

高级特性

在单个可执行工作流中整合识别和下游简报准备。
支持通过 SMTP 或 HTTP 端点进行可选的实际交付，可通过环境变量或交付配置文件进行配置。
使用明确提供的运行时交付目标和凭据；未提供时，不会执行任何外部网络操作。
返回包含所报告结果的交付回执，并在出错时使用非零退出码。
保留本地业务产物，并支持记录未纳入的内容部分以供内部跟进。
包含提取工作流阶段的来源信息。

name: Audience Readiness Guide description: >- Classify a stakeholder brief by audience and define which sections are ready for client circulation. Then it executes the downstream business step: Build a client-facing brief from approved sections while recording omissions for internal follow-up. 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 Audience Readiness 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 (audience_request) and computes the identification result (audience_mode).
Deliver — feeds the identification result into the downstream operation, computes the business result (briefing_preview), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: local_briefing_preview.
Real delivery — when a delivery target is configured, performs the declared business action (local_briefing_preview) 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
服务类规划器
对账阈值规划器