20 个章节 · 支持关键词组合搜索
附录: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 主要回答各仓库如何实现,二者的组织视角互补。
已发现的质量问题:
- 118 个 Markdown 均无 front matter,当前无法直接获得统一来源、类型和状态元数据。
- 三个文件为空或只有标题:
object-config-process.md、object-layout-config-process.md、service-catalog/uipaas-domain.md。它们应进入缺口清单,不作为已完成知识发布。 architecture-principles.md的第二条原则仍有空章节,不能把整篇认定为完整原则集合。- 小程序规范明确说明来自 skill 转录、未经仓库核对;能力卡也保留“文档记载”“待确认”等状态。
- 部分入口提示已落后于正文:例如入口仍提示服务目录是占位,实际
service-catalog/object-domain.md已有真实仓库地址。状态清单需要与正文一起核查。 - 部分发布规范包含真实客户专属环境标识。进入全中心知识库前需按发布范围审核与脱敏。
本轮核对的是文档结构及样本,没有重新核验全部业务源码;源文档的“已核对”应作为来源声明保留, 不能自动升级成此次分析的新核验结论。
现行规范下的目录对照
建议迁移后的结构如下。这是直接在 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。页面迁移只改路径和引用,不重编号。
路径变化必须由完整映射表驱动,覆盖普通链接、图片、跨目录章节链接和阅读/回写路由。