657 字
3 分钟
Qmai Playbook 索引：AI 执行手册清单
系列 · Qmai Agent Center
第 5 / 9 篇
Playbook 是 AI 执行任务时使用的场景手册。
它不替代宏观规则，也不替代仓库职责清单。正确顺序是：先判断需求和仓库，再选择最小 playbook。
使用前先读
Playbook 清单
| Playbook | 适合处理什么 |
|---|---|
需求解析.md | 需求、飞书、工单或接口文档还没有明确目标仓库时，先分析系统和仓库归属 |
国际交付工作流.md | 一个需求需要从分析、方案、实现、验证一直走到交付说明 |
Vue业务子应用.md | 普通 *-vue-international 业务页面、组件、路由、API、i18n、样式改动 |
基座与跨应用.md | qiankun 基座、登录、菜单、头部、容器、微应用挂载、跨应用状态 |
公共业务与打印模板.md | 公共业务页、公共配置、打印模板、票据模板，以及 operation 打印项目边界判断 |
共享组件库.md | vue-kylin-international 共享组件、组件样式、组件 API、跨仓一致性问题 |
样式设计规范.md | UI、UX、页面布局、后台视觉、设计 token、长文本和 RTL |
装修平台.md | 装修平台主工程和 design-v0-international 组件库相关任务 |
预发布流程.md | 明确进入发布阶段后的普通国际仓 pre 发布、发布状态检查和 OPMS 排障 |
为什么不把路由写在索引里
索引只负责“有哪些手册”。
完整路由逻辑统一放在工作流路由中，避免同一套规则在多个文档里重复维护，最后出现分叉。
使用示例
| 需求描述 | 应该怎么走 |
|---|---|
| “飞书需求说要改会员权益，但没说仓库” | 先走 需求解析.md |
| “商品列表页新增一个筛选项” | 明确归属后走 Vue业务子应用.md |
| “菜单入口不显示” | 走 基座与跨应用.md，必要时联查业务仓 |
| “多个仓库的门店选择器样式都不一致” | 走 共享组件库.md |
| “打印纸面内容字段顺序要调整” | 先判断 common 模板还是 operation 运行时，再走 公共业务与打印模板.md |
| “部署预发布环境” | 这是可选发布阶段，走 预发布流程.md |
新增 playbook 的规则
新增 playbook 前，先确认现有手册无法覆盖。
如果确实需要新增，要同步检查：
- 工作流路由。
- Playbook 索引。
- 维护映射。
- 相关宏观文档是否已经先更新。
Playbook 的目标不是越多越好，而是让 AI 在正确边界内稳定执行。
Qmai Playbook 索引：AI 执行手册清单
https://blog.961121.xyz/posts/playbook-index/