c4-context

C4 Context - 系统上下文级架构文档专家

技能概述

C4 Context 是一个专业的系统上下文级文档生成助手，专注于创建高层次的系统架构视图，帮助您清晰地展示系统与用户、外部系统之间的交互关系。

适用场景

1. 系统架构设计初期

在项目启动阶段，需要快速定义系统边界、识别关键用户和外部依赖时，使用 C4 Context 可以快速生成完整的上下文级文档，为团队和利益相关者提供清晰的系统全景图。

2. 向非技术人员展示系统

当需要向产品经理、业务人员或客户解释系统架构时，C4 Context 生成的文档采用通俗易懂的语言和可视化图表，避免了技术细节的干扰，让非技术人员也能快速理解系统全貌。

3. 系统集成与依赖分析

在进行系统集成或迁移时，C4 Context 可以帮助梳理所有外部依赖关系，明确各系统之间的交互方式（API、事件、文件传输等），为集成方案提供清晰的参考。

核心功能

1. 自动生成系统上下文图

根据您提供的系统信息，自动生成符合 C4 模型规范的 Mermaid 上下文图，清晰展示系统作为中心节点，与用户（Human/Programmatic）和外部系统之间的关系，采用标准的 C4Context 语法。

2. 用户画像与旅程映射

帮助定义和文档化各类系统用户（人类用户、程序化用户、外部系统），记录用户目标、使用的关键功能，并绘制详细的用户旅程地图，追踪从用户触达到目标完成的全过程。

3. 外部依赖全景文档

系统化地梳理所有外部系统和依赖项，包括数据库、API 服务、消息队列等，记录每个依赖的提供内容、集成方式（REST API、消息队列、文件传输）和业务用途，形成完整的依赖关系图谱。

常见问题

什么是 C4 模型的系统上下文级？

系统上下文级是 C4 架构模型中的最高层次，它将整个系统视为一个黑盒，重点展示系统与外部世界的交互关系——包括用户（人类和程序matic）以及其他外部系统。这一层不涉及技术实现细节，而是从业务视角回答"系统是什么、谁在使用它、它依赖什么"这三个核心问题。

C4 上下文图与 UML 用例图有什么区别？

C4 上下文图专注于系统和外部实体的关系，采用简洁的盒子表示法，易于非技术人员理解；而 UML 用例图更侧重于功能需求和交互流程，符号体系复杂，学习曲线较陡。C4 模型强调"利益相关者友好"的原则，生成的文档可以直接用于与业务团队沟通。

什么时候应该使用上下文级，而不是容器级或组件级？

上下文级适合需要展示系统全貌的场景，如项目启动、与客户沟通、跨团队协作等；容器级适合讨论部署架构和选型决策；组件级适合团队内部的技术设计。简单来说：对外沟通用上下文级，对内设计深入到容器或组件级。C4 Context 技能专注于上下文级，如果您需要更细粒度的文档，建议配合 C4 Container 或 C4 Component 技能使用。