如何使用本知识库
旧站 81 个页面的逐页去向记录在 catalog/migration-ledger.json;该台账用于切换验收,不充当旧 URL 重定向层。
按任务选择入口
| 目标 | 首选入口 | 完成判据 |
|---|---|---|
| 了解某项能力 | 功能目录 | 找到唯一 Feature、owner、边界与成熟度 |
| 设计或评审方案 | 设计与体验与平台架构 | 设计遵守全局规格且未复制相邻 Feature 合同 |
| 准备开发 | 实施计划 | Requirement、AC、Work Package 和验证关系完整 |
| 查接口或测试 | 资产目录 | 使用 Asset ID 定位固定 revision 下的 owner 资产 |
| 验证完整性 | 质量视图和追踪视图 | 无重复 ID、悬空引用或未解释的覆盖缺口 |
| 处理环境与发布 | 运维与发布 | 进入正确 owner,遵守批准、停止和恢复条件 |
阅读页面元数据
document_status说明文档成熟度:stub、draft、in_review、approved、deprecated。product_lifecycle说明产品生命周期:planned、active、deprecated、retired。owner标识内容 owner,不表示当前执行人。source_of_truth指向权威事实类型;环境和执行现状仍应到 owning system 查询。- Asset ID 是稳定引用;章节号和标题可以调整。
维护原则
- 先更新 owning source,再更新固定 source lock 和中央索引。
- 同一事实只在一个 canonical 页面定义,其它页面用 Asset ID 或链接引用。
- 未知内容保持
stub并写清缺口,不从代码存在推断产品已经可用。 - 临时证据留在 MR、Pipeline、Plane 或运行系统,不沉淀成长期产品事实。
- 发现冲突时以 owner 和固定 revision 为依据,停止自动合并结论。