用途
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 维持连续性。
限制
资料未提供该技能的安装方式、支持的平台、收费与价格信息,也未提供可用性、性能或效果的量化说明,这些内容暂未提供。