TaskFlow究竟是什么？和普通Skills技能有什么区别

TaskFlow任务流

普通Skills技能 vs TaskFlow 技能

普通技能的特点：

// 普通技能：一次性任务
async function normalSkill() {
  // 1. 执行任务
  const result = await doSomething();
  
  // 2. 返回结果
  return result;
  // 3. 结束！状态不保存
}

TaskFlow 技能的特点：

// TaskFlow 技能：持久化工作流
async function taskflowSkill() {
  // 1. 创建持久化工作流
  const flow = await taskFlow.createManaged({
    goal: "长期任务",
    stateJson: { step: 1, data: {} }
  });
  
  // 2. 执行第一步（状态已保存）
  await doStep1();
  await taskFlow.updateState({ step: 2 });
  
  // 3. 程序可以重启，状态不丢失！
  // 重启后可以从 step: 2 继续
  
  // 4. 等待外部事件（几天、几周）
  await taskFlow.setWaiting({
    waitJson: { kind: "user_reply", timeout: "7d" }
  });
  
  // 5. 用户一周后回复，工作流恢复
  await taskFlow.resume();
  
  // 6. 继续执行
  await doStep2();
}

核心区别对比表

特性	普通技能	TaskFlow 技能
持久化	❌ 重启后状态丢失	✅ 状态保存到数据库
长时间运行	❌ 几分钟内完成	✅ 可以运行几天、几周
等待外部事件	❌ 很难实现	✅ 内置等待机制
状态恢复	❌ 从头开始	✅ 从上次状态继续
并发控制	❌ 可能冲突	✅ 版本控制防冲突
任务链接	❌ 独立任务	✅ 可以链接子任务
进度跟踪	❌ 简单日志	✅ 结构化状态跟踪

实际场景对比

场景：处理用户支持工单

普通技能实现：

// 问题：如果程序重启，所有处理中的工单状态丢失！
async function handleSupportTicket(ticketId) {
  const ticket = await getTicket(ticketId);
  
  // 分类工单
  const category = await classify(ticket);
  
  if (category === "urgent") {
    await notifyOnCallEngineer(ticket);
    // 等待工程师回复？很难实现！
  }
  
  // 如果程序在这里重启，工单处理状态完全丢失
  await processTicket(ticket);
}

TaskFlow 实现：

async function handleSupportTicket(ticketId) {
  // 1. 创建持久化工作流
  const flow = await taskFlow.createManaged({
    goal: `处理工单 ${ticketId}`,
    stateJson: { ticketId, status: "received" }
  });
  
  // 2. 分类工单
  const category = await classify(ticketId);
  await taskFlow.updateState({ status: "classified", category });
  
  // 3. 根据分类处理
  if (category === "urgent") {
    // 通知值班工程师
    const threadId = await notifyOnCallEngineer(ticketId);
    
    // 4. 设置等待：等待工程师回复（可能几小时）
    await taskFlow.setWaiting({
      currentStep: "waiting_engineer_reply",
      waitJson: {
        kind: "slack_reply",
        threadId: threadId,
        timeout: "4h"  // 4小时超时
      }
    });
    
    // 程序可以重启！状态已保存
    // 工程师3小时后回复，工作流自动恢复
    
  } else if (category === "normal") {
    // 普通工单：自动处理
    await autoProcess(ticketId);
    await taskFlow.finish({ status: "resolved" });
  }
}

为什么需要 TaskFlow？

1. 可靠性需求

• 银行转账处理（不能因为重启而重复转账）

• 订单处理（需要保证状态不丢失）

• 数据同步（长时间运行，需要断点续传）

2. 长时间运行需求

• 等待用户回复（可能几天）

• 定时批处理（每天运行）

• 监控任务（持续运行）

3. 复杂协调需求

• 多个子任务需要协调

• 需要等待多个外部事件

• 需要人工干预点

4. 状态恢复需求

• 程序升级后继续原有工作

• 故障恢复后继续处理

• 人工暂停/恢复能力

普通技能能做到吗？

技术上可以，但很困难：

// 自己实现持久化（复杂！）
class MyWorkflow {
  constructor() {
    // 需要自己实现：
    // 1. 数据库存储
    // 2. 状态机
    // 3. 版本控制
    // 4. 冲突解决
    // 5. 等待机制
    // 6. 恢复逻辑
    // 7. 任务链接
    // ... 很多复杂代码
  }
}

TaskFlow 提供了：

• ✅ 现成的持久化存储

• ✅ 完善的状态机

• ✅ 内置的版本控制

• ✅ 等待和恢复机制

• ✅ 任务链接管理

• ✅ 监控和调试工具

使用建议

使用普通技能当：

• 一次性任务（几分钟内完成）

• 不需要保存状态

• 不需要等待外部事件

• 简单数据处理

使用 TaskFlow 当：

• 长时间运行任务（几小时/几天）

• 需要保存状态防丢失

• 需要等待用户/外部系统回复

• 复杂多步骤工作流

• 需要可靠性和可恢复性

总结

TaskFlow 不是替代普通技能，而是补充：

• 普通技能 = 工具 （锤子、螺丝刀）

• TaskFlow = 工作台 （有抽屉存放半成品、有夹具固定工件）

你可以用锤子（普通技能）敲钉子，但如果你要做复杂的家具（长时间工作流），就需要工作台（TaskFlow）来：

1. 存放半成品（状态持久化）

2. 固定工件（状态管理）

3. 等待胶水干（等待机制）

4. 分步骤完成（多步骤协调）

所以，TaskFlow 是构建可靠、长时间运行工作流的基础设施 ，而普通技能是执行具体操作的"工具"。