---

name: c4-context description: C4 上下文级别文档专家。创建高层系统上下文图，记录角色、用户旅程、系统功能和外部依赖。 risk: unknown source: community date_added: '2026-02-27'

C4 上下文级别：系统上下文

何时使用此技能

• 处理 C4 上下文级别：系统上下文任务或工作流
• 需要 C4 上下文级别：系统上下文的指导、最佳实践或检查清单

不要在以下情况使用此技能

• 任务与 C4 上下文级别：系统上下文无关
• 你需要此范围之外的不同领域或工具

说明

• 明确目标、约束和所需输入。
• 应用相关最佳实践并验证结果。
• 提供可操作的步骤和验证。
• 如果需要详细示例，打开 resources/implementation-playbook.md。

系统概述

简短描述

[一句话描述系统做什么]

详细描述

[系统目的、能力和解决的问题的详细描述]

角色

[角色名称]

• 类型：[人类用户 / 程序化用户 / 外部系统]
• 描述：[此角色是谁以及他们需要什么]
• 目标：[此角色想要实现什么]
• 使用的关键功能：[此角色使用的功能列表]

系统功能

[功能名称]

• 描述：[此功能做什么]
• 用户：[哪些角色使用此功能]
• 用户旅程：[用户旅程图链接]

用户旅程

[功能名称] - [角色名称] 旅程

1. [步骤 1]：[描述]
2. [步骤 2]：[描述]
3. [步骤 3]：[描述]

[外部系统] 集成旅程

1. [步骤 1]：[描述]
2. [步骤 2]：[描述]

外部系统和依赖

[外部系统名称]

• 类型：[数据库、API、服务、消息队列等]
• 描述：[此外部系统提供什么]
• 集成类型：[API、事件、文件传输等]
• 目的：[系统为什么依赖它]

系统上下文图

[显示系统、用户和外部系统的 Mermaid 图]

上下文图模板

根据 C4 模型，系统上下文图将系统显示为中心的方框，周围是其用户和与之交互的其他系统。重点是人（参与者、角色、角色画像）和软件系统，而非技术、协议和其他低级细节。

使用正确的 Mermaid C4 语法：

C4Context
    title 系统上下文图

    Person(user, "用户", "使用系统完成目标")
    System(system, "系统名称", "提供 X、Y 和 Z 功能")
    System_Ext(external1, "外部系统 1", "提供服务 A")
    System_Ext(external2, "外部系统 2", "提供服务 B")
    SystemDb(externalDb, "外部数据库", "存储数据")

    Rel(user, system, "使用")
    Rel(system, external1, "使用", "API")
    Rel(system, external2, "发送事件到")
    Rel(system, externalDb, "读取和写入")

关键原则（来自 c4model.com）：

• 关注人和软件系统，而非技术
• 清晰显示系统边界
• 包含所有用户（人类和程序化）
• 包含所有外部系统依赖
• 使用简单、非技术性的语言
• 保持图表简洁——如果太复杂，你可能在错误的抽象级别

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需的输入、权限、安全边界或成功标准，请停下来要求澄清。