TaskFlow + ClawHub 摄取快速参考

安装指南

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

什么是

这份 Openclaw Skills 参考将 TaskFlow 工作流编排与 ClawHub CLI 资源发布联系起来。TaskFlow 协调多步骤准备、分类、质量检查、元数据处理、持久化状态、等待、恢复和关联子任务；ClawHub 将资源发布到资源中心，并支持元数据检查和搜索验证。
使用随附的命令模板和发布清单，通过清晰、可重复的步骤将资源从准备推进到发布。本指南侧重于集成工作流，不声称会安装或配置任何一个工具。

应用场景

在将数字资源发布到 ClawHub 之前进行准备和分类。
协调跨越多个步骤或需要持久化工作流状态的摄取工作。
在等待输入或前置任务时暂停并恢复摄取流程。
使用 slug、显示名称、版本和变更日志发布资源。
使用 ClawHub inspect 和 search 命令验证已发布的资源。
在发布前检查必需的元数据、内容质量、链接、标签和敏感信息。

工作原理

准备资源内容及其资源目录。
从工具上下文创建受管理的 TaskFlow 工作流，设置控制器 ID、目标、当前步骤和初始状态。
运行准备工作流：对资源进行分类、执行质量检查并补全元数据；根据需要持久化状态并等待或恢复。
使用 clawhub publish 发布准备好的目录，并指定其 slug、名称、版本和变更日志。
检查已发布的资源并搜索相关关键词，以验证资源是否可用且可被发现。
完成发布前清单，包括内容准确性、元数据完整性、链接可访问性以及不包含敏感信息。

配置指南

本文档是工作流快速参考，而非安装指南。其元数据将 TaskFlow 列为必需工具，并假设 TaskFlow 和 ClawHub CLI 已在工作环境中可用。本文未指定安装命令、身份验证步骤或配置文件。
使用以下 TaskFlow 代码模式创建受管理的工作流，并根据你的资源调整控制器 ID 和初始状态：
const tf = api.runtime.tasks.flow.fromToolContext(ctx);
const flow = tf.createManaged({
controllerId: "demo/ingest",
goal: "ingest digital resource",
currentStep: "prepare",
stateJson: { resource: "", checks: [] },
});
// 根据需要运行任务、设置等待状态、恢复并完成。
使用 ClawHub CLI 发布并验证资源：
clawhub publish ./resource-dir
--slug my-resource
--name "Resource Name"
--version 1.0.0
--changelog "Initial release" clawhub inspect my-resource
clawhub search "keyword"
TaskFlow + ClawHub 摄取快速参考 数据架构与分类体系
本参考使用 TaskFlow 状态跟踪工作流进度，并使用 ClawHub 元数据描述已发布的资源。
数据区域 字段或结构 用途
TaskFlow 工作流 controllerId、goal、currentStep、stateJson 标识受管理的工作流、其目标、当前步骤以及持久化的资源/检查状态。
ClawHub 资源元数据 name、description、author、created、version、tags 提供发布所需的资源身份信息和目录信息。
发布选项 --slug、--name、--version、--changelog 向 clawhub publish 提供资源标识符和发布详情。
资源文件 ./resource-dir 传递给发布命令的目录；本参考未规定内部文件布局。
元数据要求：name 是唯一的 slug/标识符；description 应为 10–200 个字符；created 使用 YYYY-MM-DD；version 遵循 SemVer；tags 应包含 3–8 个相关标签。发布清单还要求内容完整准确、链接可访问且不含敏感信息。

高级特性

通过目标、控制器 ID、当前步骤和持久化 JSON 状态实现受管理的多步骤 TaskFlow 编排。
支持工作流等待和恢复，以及任务执行与完成生命周期操作。
支持关联子任务，将摄取工作拆分为相互协调的工作单元。
使用明确的 slug、名称、语义化版本和变更日志选项通过 ClawHub 发布。
通过资源检查和关键词搜索进行发布后验证。
提供元数据和质量清单，用于在发布前发现描述不完整、标签不准确、链接无法访问和敏感数据等问题。

name: quickref-taskflow-ingest description: "TaskFlow + ClawHub 数字资源入库速查表：两工具串联完成从业务流程处理到资源中心入库的完整操作参考，含命令模板与检查清单。"