703 字
4 分钟
Qmai 维护映射：规则变更后怎么同步
系列 · Qmai Agent Center
第 9 / 9 篇
维护映射回答一个问题：规则变了以后，应该同步哪些文档？
新版规则中心不鼓励直接改 AI 执行细则。更稳的方式是：
先改宏观文档 -> 查维护映射 -> 同步 AI 执行规则 -> 检查入口、链接和重复事实源为什么需要维护映射
如果所有规则都写在 AI 执行文件里，会出现两个问题：
- 人不好读，只知道 AI 应该怎么做，不知道业务边界为什么这样定。
- 规则容易重复，多个入口各写一套，后续更新时很容易分叉。
维护映射把规则分成两类：
| 类型 | 作用 |
|---|---|
| 宏观文档 | 人和 AI 都能读懂的业务语义源 |
| AI 执行规则 | AI 真正执行任务时读取的约束、路由和 playbook |
新版维护原则
00-04是业务语义源。05-AI执行规则是 AI 执行投影。06-维护映射是同步协议。
也就是说，业务边界、仓库职责、UI 规范、命名规则这些内容，应优先维护在宏观文档里。
AI 执行规则只负责把这些内容投影成可执行动作。
常见同步场景
| 你修改了什么 | 需要同步检查什么 |
|---|---|
| 系统全景、仓库角色、系统边界 | 项目识别、工作流路由、playbook 索引 |
| PRD 归属、需求类型、接口规则 | 需求解析、国际交付工作流、全局约束 |
| 国际 Vue 仓库职责清单 | 需求解析、项目识别、工作流路由 |
| 基座、业务子应用、公共页、打印、装修平台结构 | 对应 playbook 和工作流路由 |
| 页面、路由、API、i18n、样式命名 | Vue 业务子应用、国际交付工作流、全局约束 |
| UI 规范、主题变量、组件库依赖 | 样式设计规范、共享组件库、基座与跨应用 |
| 打印模板和打印运行时边界 | 公共业务与打印模板、项目识别、全局约束 |
一次规则变更怎么做
例如，团队新增一个业务仓库职责：
- 先更新仓库职责清单，让人能看懂这个仓库负责什么。
- 再检查项目识别是否能识别这个仓库。
- 再检查工作流路由是否需要新增或调整分流。
- 再检查 playbook 索引是否需要补充说明。
- 最后检查博客入口和旧规则残留。
AI 同步输出模板
规则变更后，AI 应该用这种格式说明：
已修改宏观文档：已同步微观规则：未同步但已检查：可能影响：自检结果：需确认：一句话总结
维护映射让规则中心保持一个事实源：人先维护业务地图，AI 再同步执行细则。
Qmai 维护映射：规则变更后怎么同步
https://blog.961121.xyz/posts/maintenance-map/