知识放置规划器

安装指南

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

什么是

知识放置规划器是一种可执行工作流，将输入识别与下游业务操作结合起来。它读取请求、计算放置路径、生成记录结果，并在明确选定的输出目录中创建或更新业务产物。
作为 Openclaw Skills 工作流，它默认仅在本地运行：未配置发送功能时，不会联系任何外部服务。配置 SMTP 或 HTTP 发送端点后，它会执行声明的发送操作，并返回描述处理结果的回执。

应用场景

将结构化请求转换为建议的知识库放置路径。
将计算出的业务结果保存为本地工作区产物，以便审核或后续跟进。
发送已配置的消息，或通过 HTTP 端点提交/注册记录。
从命令行运行可重复的两阶段工作流，并检查发送状态。
未配置外部发送凭据或目标时，保持在本地处理。

工作原理

从通过 --input 提供的 JSON 文件中读取上游请求。
运行识别阶段，计算放置结果 path。
将该结果传递给下游操作，并计算 recorded_path。
在必需的 --output-dir 下创建或更新本地业务产物。
如果通过环境变量或 --delivery-config 配置了 SMTP 或 HTTP 端点，则执行声明的发送操作，并生成回执；回执会包含 sent、delivered、failed 或 unconfigured 等结果状态。
发生错误时以非零状态退出；否则返回工作流输出。

配置指南

从技能目录使用 Python 运行工作流。附带的请求是示例输入，而 examples/expected.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。对于 HTTP 注册或提交，请配置 CLAWHUB_DELIVERY_ENDPOINT，并可选配置 CLAWHUB_DELIVERY_API_KEY，或者在配置中提供 endpoint 对象。发送目标、凭据和收件人必须明确来自运行时配置。未配置发送目标时，工作流仅写入本地产物，不会进行任何外部调用。

数据架构

工作流使用请求 JSON 文件作为上游输入，并生成包含识别结果 path 和下游结果 recorded_path 的两阶段结果。它还会在 --output-dir 指定的目录下写入或更新业务产物。
位置或字段 用途
examples/request.json 附带的上游请求示例。
examples/expected.json 完整两阶段输出结构示例；省略运行时路径和回执标识符。 --output-dir 本地业务产物的必需目标目录。 delivery receipt 配置发送功能时报告实际发送结果，包括 sent、delivered、failed 或 unconfigured 等状态。
scripts/upstream/ 识别阶段实现：operation.py、validation.py 和 config.json。
scripts/downstream/ 下游发送阶段实现，包括 deliver_effect。
source-map.json 两个提取阶段的来源信息。
scripts/run.py 运行完整工作流的入口点。

高级特性

组合工作流：
在一个可执行进程中运行识别、业务结果计算、本地产物写入和可选发送。
明确的副作用控制：
仅写入提供的输出目录；只有配置发送目标时才会进行外部通信。
多种发送模式：
支持 SMTP 消息发送以及 HTTP 注册或提交。
运行时配置：
通过环境变量或明确指定的 --delivery-config 文件接收发送设置。
发送回执：
在可用时报告发送状态和结果标识符。
失败信号：
通过非零进程退出代码报告错误。
阶段来源追踪：
包含上游识别阶段和下游发送阶段的来源映射。

name: Knowledge Placement Planner description: >- Plan a knowledge-base placement path. Then it executes the downstream business step: Write a workspace export file. 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 Knowledge Placement 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 (file_request) and computes the identification result (path).
Deliver — feeds the identification result into the downstream operation, computes the business result (recorded_path), and creates or updates a local business artifact beneath the explicitly supplied --output-dir. Effect: controlled_workspace_file_write.
Real delivery — when a delivery target is configured, performs the declared business action (controlled_workspace_file_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
客户简报路由台
候选人技能映射器