用途:amplihack 中所有非平凡开发与调查任务的默认编排器,取代 ultrathink-orchestrator。流程为:分类任务(Q&A/Operations/Investigation/Development)→ 明确目标与成功标准 → 识别并拆分工作流 → 用 recipe runner 执行(smart-orchestrator)→ 反思校验目标是否达成,未达成则进入第 2、3 轮。
主要能力:关键词自动激活;通过 multitask 并行执行多工作流;会话树递归守卫(依赖 AMPLIHACK_TREE_ID、AMPLIHACK_SESSION_DEPTH、AMPLIHACK_MAX_DEPTH=3),达深度上限时回退单会话并打印提示;每树最多 10 个并发会话,多余 FIFO 排队,状态存于 /tmp/amplihack-session-trees/{tree_id}.json;PostToolUse 钩子监控,若 3 次工具调用无 recipe runner 证据则发出警告;支持状态信号 STATUS(COMPLETE/CONTINUE/PARTIAL)与 GOAL_STATUS(ACHIEVED/PARTIAL/NOT_ACHIEVED)。
使用方式:入口为 /dev <任务描述>,设置后自动激活;依据说明,读取技能后下一步必须用 Bash 启动 recipe runner,例如在 tmux 中运行 run_recipe_by_name("smart-orchestrator"),并采用 env -u CLAUDECODE、PYTHONPATH=src python3、progress=True、chmod 600 日志、tmux new-session -d 等必要命令;不要用 run_in_background(约 10 分钟后会被杀)。需环境变量 AMPLIHACK_HOME(资产查找,缺失时报 orch_helper.py not found)、AMPLIHACK_AGENT_BINARY(默认 claude)、AMPLIHACK_MAX_DEPTH(默认 3)、AMPLIHACK_NONINTERACTIVE。
适用与限制:适用于实现、构建、修复、调查等非平凡任务;Q&A 与 Operations 可直接响应或直接执行,不走 recipe runner。smart-orchestrator 仅在基础设施层失败时,才可显式声明后改用 investigation-workflow 或 default-workflow。可通过 force_single_workstream: "true" 或 AMPLIHACK_MAX_DEPTH=0 强制单工作流。失败需公开报错并可用 gh issue create 提 bug;需检测“空洞成功”。
其他:ultrathink-orchestrator 已废弃并重定向至此,/ultrathink 为废弃别名;相关文件包括 amplifier-bundle/recipes/smart-orchestrator.yaml、default-workflow.yaml、investigation-workflow.yaml、.claude/skills/multitask/orchestrator.py。具体收费与版本支持信息暂未提供。