SuperAPI AI 工具集

workflow-router

智能体与模型

查看项目

更新于 10-14 19:30

技能介绍

用途

workflow-router 是一个基于目标的流程编排器(goal-based workflow orchestrator)。它的职责是理解用户想完成什么,然后把任务路由到合适的专家智能体,并做最优的资源分配。

适用时机:

  • 用户想开始一个新任务但还没有指定工作流
  • 用户问“我该怎么入手这个问题?”
  • 用户提到想探索、规划、构建或修复某件事
  • 需要为复杂任务编排多个智能体

主要能力

目标选择:通过 AskUserQuestion 工具询问用户本次任务的主要目标,选项包括 Research(研究,理解或探索不熟悉的代码、库或概念)、Plan(规划,设计解决方案、制定实施计划、拆解复杂问题)、Build(构建,实现功能、编写组件、按计划实现)、Fix(修复,调查并解决缺陷、调试失败的测试)。如果从上下文能明确判断用户意图,也可以推断目标,否则再显式询问。

计划检测:在执行前检查是否已有计划:

ls thoughts/shared/plans/*.md 2>/dev/null

如果存在计划:对于 Build 目标,询问是否要实施已有计划;对于 Plan 目标,提示已有计划以避免重复;对于 Research/Fix,照常进行。

资源分配:通过 AskUserQuestion 询问希望如何分配资源:Conservative(1-2 个智能体、顺序执行,上下文占用最小,适合简单任务)、Balanced(推荐,按任务匹配合适的智能体,部分并行,适合大多数任务)、Aggressive(最大并行,多个智能体同时工作,适合时间紧迫的任务)、Auto(由系统按任务复杂度决定)。未指定或选择 Auto 时默认使用 Balanced。

专家映射:

目标 主智能体 别名 说明
Research oracle Librarian 使用 MCP 工具(nia、perplexity、repoprompt、firecrawl)做综合研究
Plan plan-agent Oracle 以分阶段方式制定实施计划
Build kraken Kraken 实现型智能体,通过 Task 工具处理编码任务
Fix debug-agent Sentinel 通过代码库探索与日志进行调查

Fix 的特殊处理:先启动 debug-agent(Sentinel)进行排查;若问题已定位且需要改动代码,再启动 kraken 实施修复。

确认环节:执行前展示执行摘要(目标、资源分配、将要启动的智能体、将要发生什么及预期产出),然后通过 AskUserQuestion 请求确认。用户选择“Adjust settings”时返回相关步骤重新调整;必须等待用户确认后才启动智能体。

使用方式

各目标对应的智能体启动示例:

Research(Librarian):

Task(
  subagent_type="oracle",
  prompt="""
  Research: [topic]

  Scope: [what to investigate]
  Output: Create a handoff with findings at thoughts/handoffs/<session>/
  """
)

Plan(Oracle):

Task(
  subagent_type="plan-agent",
  prompt="""
  Create implementation plan for: [feature/task]

  Context: [relevant context]
  Output: Save plan to thoughts/shared/plans/
  """
)

Build(Kraken):如果已有计划,先运行 premortem:

/premortem deep <plan-path>

这会识别风险,如发现 HIGH 级严重问题则阻塞流程,用户可以选择接受、缓解或研究解决方案。预检通过后:

Task(
  subagent_type="kraken",
  prompt="""
  Implement: [task]

  Plan location: [if applicable]
  Tests: Run tests after implementation
  """
)

Fix(先 Sentinel 后 Kraken):

# Step 1: Investigate
Task(
  subagent_type="debug-agent",
  prompt="""
  Investigate: [issue description]

  Symptoms: [what's failing]
  Output: Diagnosis and recommended fix
  """
)

# Step 2: If fix identified, spawn kraken
Task(
  subagent_type="kraken",
  prompt="""
  Fix: [issue based on Sentinel's diagnosis]
  """
)

使用建议

  • 尽可能推断目标:例如用户说“这个测试挂了”,明显属于 Fix 目标。
  • 保持自适应:先以 Balanced 分配开始,任务变复杂时再上调。
  • 串联智能体:复杂任务的推荐流程为 Research -> Plan -> Premortem -> Build。
  • 运行预检:在 Build 前始终对计划运行 /premortem deep,尽早发现风险。
  • 保留上下文:智能体之间用 handoff 维持连续性。

限制

资料未提供该技能的安装方式、支持的平台、收费与价格信息,也未提供可用性、性能或效果的量化说明,这些内容暂未提供。