Workflow

Workflow Orchestration（工作流编排）

概述

工作流编排层，将底层子 skill 的原子能力组合为端到端的复合流程，通过剧本式步骤描述实现 AI 自主调度。

脚本引用

本层不直接引用脚本。工作流编排通过调度子 skill 间接使用底层脚本能力：

路径示例：workflow 步骤 → discovery/creator-search → ../../scripts/search_creators.mjs

参数说明

本层不直接调用脚本参数，通过编排子 skill 间接使用。各步骤的具体参数由对应子 skill 定义，工作流层仅负责步骤编排与数据流转。

编排层定位

设计理念

1. 剧本式编排：每个工作流是一个 Markdown 剧本文件（位于 workflows/ 目录），定义步骤序列、数据流转和决策点。AI Agent 按剧本逐步执行，无需额外编程。

2. AI 自主调度：AI Agent 读取剧本后，按步骤顺序调用对应子 skill 的能力。每步的产出自动作为下一步的输入，形成数据管道。

3. 用户确认点：关键决策步骤（如发送邮件、批量操作）标注 [需用户确认]，AI 暂停执行并展示当前数据，等待用户明确授权后继续。

适用场景

• 用户提出跨领域的复合需求（如"找达人并发建联邮件"）
• 需要多步骤协作且有明确先后顺序的流程
• 需要在关键节点获取用户决策的半自动化流程

工作流索引

调度规则

AI Agent 执行工作流剧本时，遵循以下规则：

执行规则

1. 顺序执行：按步骤编号顺序执行，每步调用标注的子 skill（格式 [领域/子skill名]）
2. 数据传递：步骤间数据通过上下文传递——上一步产出 = 下一步输入
3. 错误中断：任一步骤执行失败时，暂停流程并向用户报告错误原因及当前进度

特殊标注处理

上下文管理

• 每步执行前，AI 汇总前序步骤的关键产出作为当前步骤输入
• 用户确认步骤中，AI 展示结构化数据摘要（数量、关键字段预览）
• 流程结束后，AI 输出完整执行报告

输出格式

工作流执行过程中，AI 按以下格式报告进度：

📋 工作流：{剧本名称}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Step 1: {步骤描述} — 完成（产出: {摘要}）
✅ Step 2: {步骤描述} — 完成（产出: {摘要}）
⏳ Step 3: {步骤描述} — 执行中...
⬚ Step 4: {步骤描述} — 待执行
⬚ Step 5: {步骤描述} — 待执行
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
进度: 2/5 完成 | 当前: Step 3

流程完成后输出执行摘要：

✅ 工作流执行完成：{剧本名称}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
总步骤: {N} | 成功: {N} | 跳过: {N}
关键产出:
  - {产出 1 摘要}
  - {产出 2 摘要}