19

附录:118 篇迁移分类与目录

迁移盘点

迁移资产盘点

按本地文件统计,源库共 118 个 Markdown:

分类 文件数(含目录说明与模板) 价值与处理重点
00-playbooks/ 7 角色阅读顺序、产出物、Agent 执行与回写规则
01-business-domain/ 70 术语、领域规则、核心流程、公共模型、能力卡与契约,是优先融合部分
02-architecture-principles/ 9 与公司原则有交集;服务身份需复核
03-engineering-standards/ 18 与公司规范重复最多,含分端细则
04-testing-standards/ 7 通用测试规范去重;业务验收与团队测试经验保留
05-incident-postmortems/ 3 说明、模板及一篇 Mongo 重复键异常漏捕获事故,具有防再发价值
根目录文件 4 README、index、AGENTS、CLAUDE

其中已有 5 张能力卡和 5 组接口契约:

  • 能力:对象列表、列表布局设计器、新建编辑表单、新建保存、Web 菜单。
  • 契约:列表、表单、保存、租户菜单、用户菜单。

这部分能将“用户页面 → 业务规则 → 涉及仓库 → 接口 → 可观察的验收结果”串联起来。 现有单仓 wiki 主要回答各仓库如何实现,二者的组织视角互补。

已发现的质量问题:

  1. 118 个 Markdown 均无 front matter,当前无法直接获得统一来源、类型和状态元数据。
  2. 三个文件为空或只有标题:object-config-process.md、object-layout-config-process.md、 service-catalog/uipaas-domain.md。它们应进入缺口清单,不作为已完成知识发布。
  3. architecture-principles.md 的第二条原则仍有空章节,不能把整篇认定为完整原则集合。
  4. 小程序规范明确说明来自 skill 转录、未经仓库核对;能力卡也保留“文档记载”“待确认”等状态。
  5. 部分入口提示已落后于正文:例如入口仍提示服务目录是占位,实际 service-catalog/object-domain.md 已有真实仓库地址。状态清单需要与正文一起核查。
  6. 部分发布规范包含真实客户专属环境标识。进入全中心知识库前需按发布范围审核与脱敏。

本轮核对的是文档结构及样本,没有重新核验全部业务源码;源文档的“已核对”应作为来源声明保留, 不能自动升级成此次分析的新核验结论。

现行规范下的目录对照

建议迁移后的结构如下。这是直接在 ai-wiki 维护的文档结构;.wiki 生成页继续遵循发布器的原路径策略。

domains/udobj/udobj-knowledge-base/
├── README.md
├── knowledge/
│   ├── index.md
│   ├── business-glossary.md
│   ├── domain-overview/
│   ├── core-processes/
│   ├── capabilities/
│   │   ├── capability-index.md
│   │   ├── page-index.md
│   │   ├── object-domain/
│   │   └── uipaas-domain/
│   ├── playbooks/
│   ├── architecture/
│   └── team-standards/
├── api/
│   ├── object-domain/
│   └── uipaas-domain/
└── runbook/
    └── incident-lessons/
        └── 2026-10-08-mongo-duplicate-key-catch-miss.md
源目录或文件 建议落点 处理方式
根 README.md、index.md 根 README、knowledge/index.md README 提供团队定位与入口;index 保留角色、主题、页面、仓库和变更路由
00-playbooks/ knowledge/playbooks/ 保留团队适用范围;成熟通用流程可另提议上提到对应工种规范
01-business-domain/business-glossary.md knowledge/business-glossary.md 保留对象建模、UIPaaS 专用术语,链接公司公共词汇
01-business-domain/domain-overview/ knowledge/domain-overview/ 保留子结构与 shared-models,降低重写成本
01-business-domain/core-processes/ knowledge/core-processes/ 保留端到端流程与边界,空页只登记缺口
01-business-domain/capabilities/ knowledge/capabilities/ 保留能力编号、页面反查和 验收标准 编号
01-business-domain/api-contracts/ api/ 保留接口 ID、字段与状态,关联实现仓 wiki
架构原则 公司共识到 architecture/principles/;团队约束到 knowledge/architecture/ 比较条款后归并,不覆盖现有原则
服务目录 knowledge/architecture/ 中的团队导航 服务身份与实现职责引用已有仓库 wiki、stats 服务卡片
工程通用、后端、Web、小程序规范 对应 standards/dev/general/、server/、web/、miniapp/ 经规范 维护责任人 审核后合入增量;团队独有约束留 knowledge/team-standards/
通用测试规范、测试模板 standards/qa/ 保留唯一公司正文;分端测试细则放对应技术栈规范目录并交叉链接
已有 Mongo 事故 runbook/incident-lessons/ 保留来源和待办;通用防再发规则经核验可归入现有事故规则层
将来新增的真实事故 现有事故数据源与规则体系,或经约定的新来源适配 不手工写入已生成的 incidents/
_template.md、AGENTS、CLAUDE 有效模板迁入对应分类;Agent 规则转入团队指南或适用的本仓指令 改写旧路径和回写要求,根指令遵循 ai-wiki 约定

保留 obj.*、uipaas.*、api.*、AC-* 已有 ID。页面迁移只改路径和引用,不重编号。 路径变化必须由完整映射表驱动,覆盖普通链接、图片、跨目录章节链接和阅读/回写路由。