Skip to main content

如何使用本知识库

旧站 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 是稳定引用;章节号和标题可以调整。

维护原则​

  1. 先更新 owning source,再更新固定 source lock 和中央索引。
  2. 同一事实只在一个 canonical 页面定义,其它页面用 Asset ID 或链接引用。
  3. 未知内容保持 stub 并写清缺口,不从代码存在推断产品已经可用。
  4. 临时证据留在 MR、Pipeline、Plane 或运行系统,不沉淀成长期产品事实。
  5. 发现冲突时以 owner 和固定 revision 为依据,停止自动合并结论。