893 字
4 分钟
Qmai 工作流路由：一个任务应该走哪条流程
系列 · Qmai Agent Center
第 4 / 9 篇
工作流路由回答一个问题：当前任务应该进入哪份执行手册？
路由不是越复杂越好。它的目标是让 AI 选择“最小但足够”的 playbook，避免一个小页面问题被当成完整交付流程，也避免跨仓问题被当成单文件修改。
路由前先做两件事
- 按 项目识别 判断当前项目角色。
- 如果需求可能落在
*-vue-international，先查仓库职责清单。
没有完成这两步，不应该直接进入代码修改。
路由原则
- 先按业务需求判断系统，再按当前项目证据判断仓库。
- 选择最小匹配 playbook。
- 不要求所有仓库位于同一个父目录。
- 不维护个人本机路径映射。
- 当前工作区不可见的跨仓上下文，只说明缺失，不猜路径。
- 路由逻辑只维护在新版执行规则中，playbook 索引只做清单。
任务路由表
| 任务类型 | 进入的 playbook | 怎么理解 |
|---|---|---|
| 飞书链接、需求文案、目标仓库不明确 | 需求解析.md | 先把需求翻译成系统和仓库判断 |
| 从需求分析到实现、验证、交付的完整链路 | 国际交付工作流.md | 适合完整需求交付 |
| 普通 Vue2 业务子应用页面、组件、路由、API 改动 | Vue业务子应用.md | 适合明确落在业务仓库的改动 |
| 登录、菜单、头部、容器、微应用挂载、跨应用状态 | 基座与跨应用.md | 适合 qiankun 基座和跨应用问题 |
| 公共业务页、公共配置、打印模板、票据模板 | 公共业务与打印模板.md | 适合 common 仓和模板内容 |
| 打印插件、桥接、国际打印代码、打印通用入口 | 公共业务与打印模板.md，并按 operation 打印项目边界处理 | 打印运行时不是普通业务仓流程 |
| 共享 UI 组件、组件行为、跨仓样式一致性 | 共享组件库.md | 适合 vue-kylin-international |
| UI、UX、页面布局、设计 token、后台视觉规范 | 样式设计规范.md，并先读 UI 详细规范 | 适合页面和组件视觉任务 |
| 装修平台主工程或装修组件库 | 装修平台.md | 适合装修相关需求 |
明确要求普通国际仓 pre 发布、状态检查、OPMS 排障 | 预发布流程.md | 可选发布阶段，必须走配置文件和脚本 |
路由后的输出要求
AI 进入 playbook 前，应该先说明：
- 目标系统。
- 目标仓库。
- 判断置信度。
- 判断证据。
- 是否需要联查基座、组件库、公共业务页或打印项目。
例如，一个“商品选择器在多个业务仓都展示异常”的问题，不能只进入当前业务仓页面修样式。它很可能需要进入 共享组件库.md，检查 vue-kylin-international。
常见误区
| 误区 | 正确做法 |
|---|---|
看到 *-vue-international 就直接改当前仓库 | 先查仓库职责清单 |
| 看到打印就直接归到一个仓库 | 先区分 common 模板和 operation 运行时 |
| UI 任务只看当前页面 | 先读 UI 详细规范，再判断组件库或业务页归属 |
明确发布 pre 时直接部署 feature 分支 | 先合到 pre，推送 origin/pre，再部署 branch/pre |
| 规则中心接入时打开浏览器 | 接入只做本地文件和配置，不用浏览器 |
工作流路由的价值，是把“这个任务应该怎么开始”标准化。
Qmai 工作流路由：一个任务应该走哪条流程
https://blog.961121.xyz/posts/workflow-router/