C4 容器层

要解决什么问题

在 C4 模型里，容器层是「逻辑组件」和「真实部署单元」之间的桥梁：同一个系统往往拆成 Web 应用、API、数据库、消息队列等多个进程或镜像，但架构文档里常见的问题是组件图有了，却说不清谁跑在哪、用什么协议互连、OpenAPI 在哪。

本技能面向 C4 容器层：系统部署 这类文档任务：把已定义的组件收敛成可部署的容器，并补齐接口、依赖与基础设施说明，而不是替你做无关领域的方案设计。

技能如何工作

操作路径在 SKILL 里是固定的：明确目标、约束与输入 → 套用容器层最佳实践 → 给出可执行步骤与验证方式；需要完整示例时可对照 resources/implementation-playbook.md。

核心产出模板包括：

• 容器卡片：名称、描述、类型（Web/API/DB/队列等）、技术栈、部署方式（Docker/K8s/云）
• 目的与组件：容器职责说明，并链接到各组件文档（如 c4-component-name.md）
• 接口：协议（REST/GraphQL/gRPC/Events 等）、端点列表，以及 OpenAPI/Swagger 规范引用
• 依赖项：容器间调用关系、外部系统集成、部署配置与扩展/资源需求
• 容器图：用 Mermaid C4Container 语法表达技术选型、职责划分、协议与外部系统（原则对齐 c4model.com）

典型交互包括：根据部署定义综合容器、把 API 组件映射进容器并写 OpenAPI、分析 K8s 清单反推容器文档等。

适用边界

• 适用：任务明确属于容器层部署文档；需要检查清单、一致格式或 Swagger 级别的接口记录。
• 不适用：与容器部署无关的工作；或需要 Context（系统全景）、Component（逻辑分组）、Code（单元素代码）层能力时——分别应对应 C4 的其他 Agent：Context 做高层系统图，Component 聚焦逻辑组件，Code 记录代码细节；本技能专注部署架构与容器边界。

综合输出时应保持：边界有部署理由、命名可读、API 文档完整、组件链接齐全、Mermaid 图与 Dockerfile/K8s 等配置可追溯。