unified-workflow-hub

name	Unified-Workflow-Hub
license	MIT
github	https://github.com/starlink-awaken/Unified-Workflow-Hub
description	统一工作流中心 - 企业级 AI 能力编排平台，整合感知、思考、规划、执行、验证、复盘六大子系统。 USE WHEN 用户需要完整 AI 工作流、智能路由到合适子系统、或需要企业级可靠性的任务。
metadata	{"author":"starlink-awaken","version":"1.0.0","language":"zh-CN","entry":"skill/SKILL.md"}

Unified-Workflow-Hub

企业级 AI 能力编排平台

版本：1.0.0 | 状态：✅ 生产就绪

---

📋 目录

1. 核心价值
2. 快速参考
3. 系统架构
4. 能力矩阵
5. 工作流
6. 智能路由
7. 状态管理
8. 错误处理
9. 使用示例
10. 集成指南

---

核心价值

价值	说明	收益
🎯 统一入口	一个 Skill 解决所有 AI 能力需求	降低集成成本 80%
🧭 智能路由	基于意图识别自动路由到最合适的子系统	路由准确率 97%
🔄 完整闭环	支持从感知到复盘的全流程	端到端自动化
🔀 灵活组合	子系统可独立使用或按需组合	适应多种场景
🛡️ 企业级可靠	完善的错误处理和降级机制	99.5% 成功率
📊 可观测性	完整的日志、监控和追踪	问题快速定位

---

快速参考

立即开始

# 方式 1：统一入口（推荐）
→ Unified-Workflow-Hub

# 方式 2：直接调用子系统
→ Unified-Workflow-Hub/ThinkingSystem/FirstPrinciples

# 方式 3：使用工作流
→ Unified-Workflow-Hub/Workflows/FullCycleWorkflow

工作流选择

场景	工作流	触发词
快速检查	QuickCheckWorkflow	"检查"、"验证"
思考规划	ThinkPlanWorkflow	"思考"、"规划"
执行验证	ExecuteVerifyWorkflow	"执行"、"然后检查"
深度分析	AnalysisPlanWorkflow	"深入分析"、"调研"
完整流程	FullCycleWorkflow	"从头到尾"、"完整"

紧急联系

• 📚 文档：README.md
• 🐛 问题：GitHub Issues
• 💬 讨论：GitHub Discussions

---

系统架构

整体架构

┌─────────────────────────────────────────────────────────────────┐
│                    Unified-Workflow-Hub                          │
│                  (统一入口 + 智能路由层)                          │
└─────────────────────────────┬───────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
        ▼                     ▼                     ▼
┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│ 意图识别引擎  │    │  路由决策器   │    │  执行调度器   │
│ - 关键词提取  │    │ - 能力匹配    │    │ - 任务分发    │
│ - 复杂度评估  │    │ - 优先级排序  │    │ - 超时控制    │
│ - 上下文分析  │    │ - 降级策略    │    │ - 状态追踪    │
└───────────────┘    └───────────────┘    └───────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                        能力层 (39 项能力)                        │
├─────────────┬─────────────┬─────────────┬─────────────────────┤
│  Perception │  Thinking   │  Planning   │    Execution        │
│   (12)      │    (6)      │    (6)      │      (7)            │
├─────────────┴─────────────┴─────────────┴─────────────────────┤
│                    Verification    │    Reflection             │
│                       (4)          │       (4)                 │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      基础设施层                                  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐ │
│  │ State Mgmt  │  │ Error Hdl   │  │    Observability        │ │
│  │ 状态管理    │  │ 错误处理    │  │    可观测性             │ │
│  └─────────────┘  └─────────────┘  └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

数据流

用户输入
    │
    ▼
┌─────────────────┐
│  1. 意图解析    │ → 提取关键词、识别任务类型、评估复杂度 (1-5 星)
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  2. 工作流匹配  │ → 选择合适的工作流模板
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  3. 能力路由    │ → 调用子系统能力、设置超时、配置降级
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  4. 执行监控    │ → 追踪进度、处理异常、记录日志
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  5. 结果聚合    │ → 整合输出、生成报告、更新状态
└────────┬────────┘
         │
         ▼
    返回用户

---

能力矩阵

总览

子系统	能力数	核心能力	典型场景	平均延迟
PerceptionSystem	12	搜索、调研、索引	信息收集	2.5s
ThinkingSystem	6	第一性原理、辩论	深度分析	4s
PlanningSystem	6	分解、依赖、时间	任务规划	1.5s
ExecutionSystem	7	执行、追踪、监控	任务执行	10s
VerificationSystem	4	代码、逻辑、质量	质量保证	2s
ReflectionSystem	4	复盘、原则、知识	持续改进	1.5s

---

PerceptionSystem (感知系统)

基于 AggreResearch 构建的多模态感知能力。

能力	触发词	说明	超时	状态
QuickSearch	"搜索"、"查一下"	快速事实查询	30s	✅
Research	"调研"、"研究"	标准研究分析	60s	✅
DeepResearch	"深度调研"	深度系统性研究	120s	✅
DeepReport	"深度报告"	Manus 级深度报告	180s	✅
RAGIndex	"建索引"	知识索引构建	60s	✅
RAGQuery	"查询笔记"	知识检索	30s	✅
UnifiedSearch	"搜索我"	跨数据源搜索	60s	✅
DataSync	"同步"	个人数据同步	30s	✅
BrowserScrape	"抓取"	浏览器内容抓取	60s	✅
OSINTInvestigation	"调查"	OSINT 开源情报调查	120s	✅
MultimediaIndex	"多媒体索引"	音视频内容索引	90s	✅
MultimodalRetrieval	"多模态检索"	图文音视频检索	60s	✅

使用示例:

→ PerceptionSystem/QuickSearch
  query: "2025 年 AI 行业最新趋势"
  
→ PerceptionSystem/DeepResearch
  topic: "量子计算商业应用"
  depth: "comprehensive"

---

ThinkingSystem (思考系统)

深度认知和推理能力。

能力	触发词	说明	超时	状态
FirstPrinciples	"本质"、"根本原因"	第一性原理分析	90s	✅
Council	"多角度"、"权衡"	多角度辩论	120s	✅
BeCreative	"创意"、"创新"	创意发散思维	60s	✅
RedTeam	"风险"、"问题"	风险对抗分析	90s	✅
Science	"验证"、"假设"	科学验证方法	120s	✅
Synthesis	"综合分析"	综合归纳分析	90s	✅

使用示例:

→ ThinkingSystem/FirstPrinciples
  question: "用户增长的本质是什么？"
  
→ ThinkingSystem/Council
  topic: "是否应该进入新市场"
  perspectives: ["市场", "技术", "财务", "风险"]

---

PlanningSystem (规划系统)

结构化任务规划能力。

能力	触发词	说明	超时	状态
TaskDecomposition	"分解任务"	WBS 任务分解	30s	✅
DependencyAnalysis	"依赖"、"先后"	依赖关系分析	30s	✅
TimelinePlanning	"时间安排"	时间线规划	30s	✅
ResourcePlanning	"资源"、"成本"	资源成本规划	30s	✅
RiskAssessment	"风险评估"	风险识别评估	30s	✅
ComprehensivePlan	"完整计划"	完整规划方案	60s	✅

使用示例:

→ PlanningSystem/TaskDecomposition
  goal: "开发用户管理系统"
  constraints: ["2 周完成", "3 人团队"]
  
→ PlanningSystem/ComprehensivePlan
  objective: "产品上线"
  include: ["任务", "时间", "资源", "风险"]

---

ExecutionSystem (执行系统)

任务执行和监控能力。

能力	触发词	说明	超时	状态
TaskExecution	"执行"、"开始做"	任务执行	300s	✅
ProgressTracking	"进度"	进度追踪	30s	✅
StateManagement	"暂停"、"继续"	状态管理	30s	✅
ErrorHandling	"重试"、"出错"	异常处理	60s	✅
Completion	"完成"	完成处理	30s	✅
ParallelExecution	"并行"	并行执行	300s	✅
MonitoringAlerting	"监控"、"告警"	监控告警	持续	✅

使用示例:

→ ExecutionSystem/TaskExecution
  plan: {...}
  mode: "standard"
  
→ ExecutionSystem/ProgressTracking
  project_id: "uuid"

---

VerificationSystem (验证系统)

质量和结果验证能力。

能力	触发词	说明	超时	状态
CodeVerification	"检查代码"	代码审查验证	60s	✅
LogicVerification	"逻辑对不对"	逻辑一致性验证	60s	✅
QualityVerification	"质量如何"	质量评估验证	60s	✅
ResultVerification	"结果对不对"	结果正确性验证	60s	✅

使用示例:

→ VerificationSystem/CodeVerification
  code: "<代码内容>"
  criteria: ["安全性", "性能", "可维护性"]
  
→ VerificationSystem/ResultVerification
  expected: "预期结果"
  actual: "实际结果"

---

ReflectionSystem (复盘系统)

经验总结和知识沉淀能力。

能力	触发词	说明	超时	状态
ProjectRetro	"复盘"、"总结"	项目复盘	60s	✅
IncidentRetro	"事故"	事件复盘	60s	✅
PrincipleExtraction	"提炼原则"	原则提炼	30s	✅
Knowledge 沉淀	"沉淀"、"知识库"	知识沉淀	60s	✅

使用示例:

→ ReflectionSystem/ProjectRetro
  project_id: "uuid"
  participants: ["成员列表"]
  
→ ReflectionSystem/PrincipleExtraction
  experience: "项目经验总结"

---

工作流

工作流选择指南

复杂度	工作流	执行时间	成功率	适用场景
⭐	QuickCheckWorkflow	< 1min	99.9%	快速验证、简单检查
⭐⭐	ThinkPlanWorkflow	2-5min	99.5%	分析规划、方案设计
⭐⭐⭐	ExecuteVerifyWorkflow	5-15min	99%	执行任务、质量保证
⭐⭐⭐⭐	AnalysisPlanWorkflow	10-30min	98%	深度分析、全面评估
⭐⭐⭐⭐⭐	FullCycleWorkflow	30min+	97%	端到端完整方案

---

QuickCheckWorkflow (⭐)

适用场景: 快速验证、简单检查

触发条件："检查一下"、"有没有问题"、"快速验证"

流程:
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 意图识别    │ →  │ 选择验证方式│ →  │ 执行验证    │ →  │ 返回结果    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

调用能力: VerificationSystem/* (根据内容自动选择)

输出:
- ✅ 验证结果
- ⚠️ 问题列表
- 💡 修复建议

详细文档: Workflows/QuickCheckWorkflow.md

---

ThinkPlanWorkflow (⭐⭐)

适用场景: 思考分析、方案规划

触发条件："思考怎么做"、"分析后规划"、"方案设计"

流程:
┌─────────────────────────┐    ┌─────────────────────────┐
│ 思考阶段                │ →  │ 规划阶段                │
│ - FirstPrinciples       │    │ - TaskDecomposition     │
│ - Council (可选)        │    │ - TimelinePlanning      │
│ - RedTeam (可选)        │    │ - ComprehensivePlan     │
└─────────────────────────┘    └─────────────────────────┘

输出:
- 📊 分析报告
- 📋 规划方案
- 🎯 里程碑

详细文档: Workflows/ThinkPlanWorkflow.md

---

ExecuteVerifyWorkflow (⭐⭐⭐)

适用场景: 任务执行、质量保证

触发条件："做一下然后检查"、"执行并验证"

流程:
┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
│ 规划    │ →  │ 执行    │ →  │ 验证    │ →  │ 复盘    │
│ (Quick) │    │         │    │         │    │ (可选)  │
└─────────┘    └─────────┘    └─────────┘    └─────────┘

调用能力:
1. PlanningSystem/TaskDecomposition
2. ExecutionSystem/TaskExecution
3. VerificationSystem/*
4. ReflectionSystem/ProjectRetro (可选)

输出:
- 🔧 执行结果
- ✅ 验证报告
- 📝 问题追踪

详细文档: Workflows/ExecuteVerifyWorkflow.md

---

AnalysisPlanWorkflow (⭐⭐⭐⭐)

适用场景: 深度分析、全面评估

触发条件："深入分析"、"详细调研"、"全面评估"

流程:
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│ 深度感知        │ →  │ 多角度思考      │ →  │ 完整规划        │
│ - DeepResearch  │    │ - Council       │    │ - Comprehensive │
│ - UnifiedSearch │    │ - FirstPrinciples│   │ - RiskAssess    │
│ - RAGQuery      │    │ - RedTeam       │    │ - Timeline      │
└─────────────────┘    └─────────────────┘    └─────────────────┘

输出:
- 📚 调研报告
- 💡 分析结论
- 📋 完整规划

详细文档: Workflows/AnalysisPlanWorkflow.md

---

FullCycleWorkflow (⭐⭐⭐⭐⭐)

适用场景: 端到端完整方案

触发条件："从头做到尾"、"完整方案"、"帮我做个完整的"

流程:
┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
│ 感知    │ → │ 思考    │ → │ 规划    │ → │ 执行    │ → │ 验证    │ → │ 复盘    │
└─────────┘   └─────────┘   └─────────┘   └─────────┘   └─────────┘   └─────────┘

Phase 1: 感知 → Phase 2: 思考 → Phase 3: 规划 → Phase 4: 执行 → Phase 5: 验证 → Phase 6: 复盘

输出:
- 📊 完整流程报告
- 📦 可交付成果
- 📚 经验沉淀

详细文档: Workflows/FullCycleWorkflow.md

---

智能路由

路由决策流程

用户输入
    │
    ▼
┌─────────────────────────────────────────────┐
│  1. 意图分析                                 │
│     - 关键词提取 (Pattern Matching + NLP)   │
│     - 任务类型识别 (分类模型)               │
│     - 复杂度评估 (1-5 星规则引擎)            │
└─────────────────────┬───────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────┐
│  2. 工作流匹配                               │
│     - 精确匹配优先 (触发词完全匹配)         │
│     - 模糊匹配次之 (语义相似度)             │
│     - 默认 FullCycleWorkflow                │
└─────────────────────┬───────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────┐
│  3. 能力路由                                 │
│     - 选择子系统能力 (能力矩阵查询)         │
│     - 确定并行/串行 (依赖分析)              │
│     - 设置超时时间 (默认 + 可配置)          │
└─────────────────────┬───────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────┐
│  4. 执行与降级                               │
│     - 执行主路径                            │
│     - 失败则降级 (备用能力)                 │
│     - 超时则重试 (指数退避)                 │
└─────────────────────────────────────────────┘

触发词 → 工作流映射

触发词	工作流	优先级	置信度
"完整"、"从头到尾"、"全流程"	FullCycleWorkflow	1	95%
"深入分析"、"详细调研"、"全面评估"	AnalysisPlanWorkflow	1	93%
"规划并执行"、"怎么做"、"执行并检查"	ExecuteVerifyWorkflow	1	90%
"思考怎么做"、"分析一下"	ThinkPlanWorkflow	1	92%
"检查"、"有没有问题"、"快速验证"	QuickCheckWorkflow	1	95%
"敏捷"、"迭代"	FullCycleWorkflow(迭代模式)	2	85%
"赶紧开始"、"马上做"	ExecuteVerifyWorkflow(快速)	2	88%

路由配置

routing:
  strategy: "hybrid"  # hybrid | rule-based | ml-based
  
  rules:
    - pattern: ".*检查.*"
      workflow: QuickCheckWorkflow
      confidence: 0.95
      
    - pattern: ".*深入.*分析.*"
      workflow: AnalysisPlanWorkflow
      confidence: 0.93
      
  fallback:
    workflow: FullCycleWorkflow
    notify: true
    
  timeout:
    default: 300s
    QuickCheckWorkflow: 60s
    FullCycleWorkflow: 600s

---

状态管理

会话内状态

ExecutionSystem/StateManagement 负责管理：
├── 当前任务状态
│   ├── pending (待执行)
│   ├── running (执行中)
│   ├── completed (已完成)
│   └── failed (失败)
├── 执行进度
│   ├── completed: X
│   ├── total: Y
│   └── percentage: X/Y*100
├── 中间结果
│   └── 临时数据存储
└── 断点信息
    └── 失败时的恢复点

跨会话持久化

状态存储位置：~/.claude/pai-os/state/
├── projects/
│   └── {project-id}/
│       ├── state.json      # 项目状态
│       ├── progress.json    # 进度详情
│       └── checkpoints/    # 断点列表
└── sessions/
    └── {session-id}/       # 会话状态

断点续传

恢复流程:
1. 加载最近状态
   └── 读取 state.json
   
2. 识别最后成功的步骤
   └── 检查 checkpoints 列表
   
3. 从断点继续执行
   └── 恢复执行上下文
   
4. 跳过已完成任务
   └── 根据进度过滤

状态示例

{
  "project_id": "550e8400-e29b-41d4-a716-446655440000",
  "session_id": "abc123",
  "status": "running",
  "current_workflow": "FullCycleWorkflow",
  "current_phase": "execution",
  "created_at": "2025-02-15T10:00:00Z",
  "updated_at": "2025-02-15T10:30:00Z",
  "progress": {
    "completed": 15,
    "total": 20,
    "percentage": 75
  },
  "checkpoints": [
    {
      "id": "checkpoint-1",
      "phase": "planning",
       
       ...
    
  
   
     
     
     
  

---

错误处理

错误类型与策略

错误类型	处理策略	重试次数	降级方案
网络超时	指数退避	3 次	使用缓存数据
子系统失败	切换备用	2 次	简化处理
验证失败	记录告警	1 次	人工确认
权限错误	立即停止	0 次	提示用户
未知错误	安全降级	2 次	返回错误报告

降级机制

子系统 A 失败
    │
    ▼
┌──────────────────┐
│ 检查是否有备用能力│
└────────┬─────────┘
         │
    ┌────┴────┐
    │ 有备用  │ 无备用
    ▼         ▼
使用备用   返回错误
    │     +  建议
    ▼
继续执行

超时配置

子系统	默认超时	可配置	说明
PerceptionSystem	60s	✅	搜索/调研类
ThinkingSystem	120s	✅	深度思考类
PlanningSystem	30s	✅	规划类
ExecutionSystem	300s	✅	执行类
VerificationSystem	60s	✅	验证类
ReflectionSystem	30s	✅	复盘类

错误响应格式

{
  "error": {
    "code": "SUBSYSTEM_TIMEOUT",
    "message": "PerceptionSystem 执行超时",
    "details": {
      "subsystem": "PerceptionSystem",
      "capability": "DeepResearch",
      "timeout": "120s",
      "elapsed": "125s"
    },
    "recovery": {
      "suggestion": "尝试使用 Research 能力代替",
      "fallback": "PerceptionSystem/Research",
      "retryable": true
    }
  }
}

---

使用示例

基础示例

快速检查

用户：帮我检查一下这个配置文件有没有语法错误

→ 自动路由：QuickCheckWorkflow
→ 调用：VerificationSystem/CodeVerification
→ 输出:
  ✅ 语法检查通过
  ⚠️ 发现 2 个潜在问题：
     1. 第 15 行：缺少逗号
     2. 第 23 行：未使用的变量
  💡 建议修复

深度分析

用户：深入分析一下我们产品的竞争态势

→ 自动路由：AnalysisPlanWorkflow
→ 调用链:
   1. PerceptionSystem/DeepResearch (竞品调研)
   2. ThinkingSystem/Council (多角度分析)
   3. ThinkingSystem/RedTeam (风险识别)
   4. PlanningSystem/ComprehensivePlan (应对策略)
→ 输出：完整的竞争分析报告

高级示例

直接调用子系统

→ Unified-Workflow-Hub/ThinkingSystem/FirstPrinciples
  query: "用户增长的本质是什么？"

→ Unified-Workflow-Hub/PlanningSystem/TaskDecomposition
  goal: "开发一个用户管理系统"
  constraints: ["2 周完成", "3 人团队"]

→ Unified-Workflow-Hub/VerificationSystem/CodeVerification
  code: "<代码内容>"
  criteria: ["安全性", "性能", "可维护性"]

组合使用

用户：先调研一下市场情况，然后分析机会，最后给出进入策略

→ 手动编排:
   1. PerceptionSystem/DeepResearch (市场调研)
   2. ThinkingSystem/Synthesis (机会分析)
   3. PlanningSystem/ComprehensivePlan (进入策略)

---

集成指南

Genesis Cortex 集成

Unified-Workflow-Hub 作为**策略层（前额叶皮层）**与 Genesis 系统深度集成。

工具映射

子系统	Cortex 工具	说明
Perception	cortex_perceive	深度调研能力
Thinking	cortex_think	算法引擎
Planning	cortex_plan	结构化规划
Execution	cortex_execute	任务分发
Verification	cortex_verify	严格验证
Reflection	cortex_reflect	长期记忆更新

使用示例

用户："研究最新的量子计算进展并规划一篇博客"

执行:
1. cortex_perceive(query="quantum computing advances", depth="deep")
2. cortex_plan(goal="Write blog post", context=perceive_result)

PAI Algorithm 集成

ISC 传递机制

PAI Algorithm                    Unified-Workflow-Hub
    │
    ├── ISC: "代码无语法错误"
    │        │
    │        ▼
    │   VerificationSystem/CodeVerification
    │        │
    │        ▼
    │   返回：验证结果 + 证据
    │
    ├── ISC: "生成完整计划"
    │        │
    │        ▼
    │   FullCycleWorkflow
    │        │
    │        ▼
    │   返回：完整计划 + 里程碑

---

附录

A. 相关文档

• README.md - 项目总览
• ARCHITECTURE.md - 架构设计
• API_REFERENCE.md - API 参考
• EXAMPLES.md - 更多示例
• TROUBLESHOOTING.md - 故障排除

B. 版本历史

查看 CHANGELOG.md 了解所有版本更新。

C. 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 了解详情。

---

Unified-Workflow-Hub - 企业级 AI 能力编排平台

🔝 返回顶部