C4 上下文层

要解决什么问题

架构讨论里常见两种失焦：要么一上来画容器、组件和协议细节，干系人听不懂；要么只有口头「我们有个平台」，边界、用户和外部依赖从未写清。C4 模型的上下文层专门描述「这个软件系统是谁、为谁存在、与哪些外部系统交互」，是后续容器图、组件图的前提，也最适合给产品、业务和非工程同事对齐。

技能如何协助你

本技能按 C4 上下文层模板组织输出，而不是随意堆 Markdown。典型流程是：先明确目标、约束与已有输入；再补齐文档块——简短描述与详细描述、角色画像（人类用户、程序化用户、外部系统）、系统特性及对应用户、用户旅程（含外部系统集成路径）、外部系统与依赖（类型、集成方式、目的）；最后用符合规范的 Mermaid C4 语法绘制系统上下文图，并指向容器/组件文档的后续层级。

核心原则来自 c4model.com：聚焦人与软件系统、画清系统边界、列出全部用户与外部系统，避免把数据库协议、消息格式等底层细节塞进上下文图。需要逐步落地时，可参照 resources/implementation-playbook.md 中的可执行步骤与验证方式。

适用边界

• 适合：新建或补全 C4 上下文文档、梳理角色与用户旅程、盘点外部依赖并出上下文图、从现有材料反推干系人可读的系统概览。
• 不适合：部署拓扑与运行时容器划分（应使用 C4 容器层技能）、模块/组件内部结构（组件层）、或代码级细节（代码层）。任务与系统上下文无关时不必启用本技能。