用途:回答关于 Keboola 平台的影响分析、服务依赖和拓扑结构问题,无需逐一扫描各服务源码。模型分为三层 C4:L1 为 Keboola 交互的软件系统(平台、卫星系统、云厂商);L2 为 Keboola 平台内独立部署的容器(服务);L3 为容器内组件及其服务间与云厂商的边。
主要能力与查阅方式:按问题类型读取对应文件。查询服务 X 的出站依赖,看 references/c4/l3/<X>.dsl(服务间)与 references/c4/l3/<X>-external.dsl(云);查询谁调用服务 X(入站),在 c4/l3/*.dsl 中 grep X 的组件 ID,入站边位于调用者文件中;服务人类可读结论看 references/c4/l3/<X>.md;完整容器清单看 references/c4/l2/containers.dsl 与 references/c4/list of services.md;顶层系统与角色看 references/c4/model/model.dsl;无法从代码推断的领域规则看 references/c4/service-knowledge.md;建模方法、层级规则、设计决策看 references/c4-docs/c4-approach.md;细粒度云服务及 ID 看 references/c4/l3/cloud-resources.dsl;视图与样式看 references/c4/views/views.dsl。如果问题关于模型结构而非内容,先从 c4-approach.md 入手。
权威来源与更新:权威内容仅位于 keboola/platform-architecture-and-concepts 仓库的 c4/ 与 c4-docs/ 文件夹,其他文件夹(apis/、clients/、concepts/、services/)及根 README.md 已过时,必须忽略。该技能在 references/ 下提供时间点快照。需验证边界情况或答案不确定时,用 ./scripts/sync.sh 拉取最新版本,该命令通过 gh 从上游私有仓库拉取并覆盖 references/,需要具备访问权限的 gh 认证。快照会随时间偏离上游,若问题涉及近期变更的服务边,应先重跑 sync.sh。
注意事项:模型为理想化模型,每个服务展示其对所有支持云变体的关系,而实际栈一次只用一种云,因此影响分析也偏理想化,真实影响可能更小。扫描是单向的:模型通过扫描各服务的出站依赖构建,入站边在调用方服务被扫描后才可靠,需查看 c4-approach.md 的 Current Status 表了解覆盖缺口。不包含部署时机制,如 Helm 钩子、迁移 Job、schema 种子器。共享基础设施不等于共享资源:图中共享节点(Service Bus、KMS、数据库)不意味着共享队列/密钥/schema,以边标签为准。L2 不显示云厂商,云依赖出现在 L1(聚合)和 L3(细粒度),L2 中“运行于 Kubernetes”是隐含的。
工作目录约定:技能内脚本会自动检测自身位置,用户从项目根目录调用技能,不要 cd 到技能目录;读取 references/ 时使用绝对路径或相对 $SKILL_DIR 的路径。
限制:具体安装与使用步骤除 sync.sh 外暂未提供;未提供具体服务清单内容、模型文件内容及模型版本信息。