kanbanlisted

# Kanban 多 Agent 编排系统 > 版本: v0.54.326-05-26 基于 FSM 的任务编排框架。编排器不直接管理流程，全部由状态机驱动。 ## 命令约定 优先检测 `kanban` CLI（pip 安装），不可用时回退 `<py> -m kanban_framework`（`<py>` 为 config.json 中的 python_bin，默认 venv/bin/python）。 ## 命令路由 **精确命令** 直接匹配，**自然语言** 通过 `kanban nlp` 解析后路由。 | 意图 | 条件 | 路由 | |------|------|------| | `work` | 有 task_id | `run` | | `work` | 无 task_id 且无活跃任务 | 先 `create` 再 `run` | | `work` | 无 task_id 但有活跃任务 | `run <active_task_id>`（关联到已有任务） | | `query` | 含查询动词 | `status` / `show` | **工作意图路由步骤：** 1. `kanban nlp "<用户输入>"` → 获取 intent / task_id / needs_active_task_check 2. 如果 `needs_active_task_check` 为 true → `kanban status` 检查是否有活跃任务 3. 有活跃任务 → 展示当前任务给用户确认，用户同意后 `kanban run <id>` 4. 无活跃任务或用户明确要新建： a. `kanban create "<title>" --json`（必须加 --json 才能读取 mode_confirmation_pending） b. 检查返回值 `mode_confirmation_pending`： - 为 true → **必须**用 AskUserQuestion 展示推荐模式给用户确认 - 展示 `assessment.recommended_mode` 和 `assessment.reason` 作为说明 - 用户确认后如需切换模式 → `kanban task edit <id> --mode full` - 用户无需切换 → 直接下一步 c. `kanban run <id>` **硬性约束：** - `intent == "work"` 时禁止跳过 FSM 直接调用 skill。所有工作必须通过 `kanban create`/`kanban run` 进入框架 - **禁止跳过 `plan.knowledge_search` 步骤**。Full 和 Lightweight 模式的 Plan 阶段第一步都是知识库检索，编排器必须按 `next_step` 返回的 step 顺序执行，不得跳过 ### 常用命令 ``` # 项目初始化与维护 /kanban init # 初始化（首次必须执行：询问工号 → task_id_base） /kanban hook install # 安装 SessionStart hook（每次会话自动注入任务上下文） /kanban update # 升级到最新稳定版 + 同步 skil