
关于
C4 上下文层级文档专家。创建高层系统上下文图,记录用户画像、用户旅程、系统功能和外部依赖。
name: c4-context description: C4 上下文级别文档专家。创建高层系统上下文图,记录角色、用户旅程、系统功能和外部依赖。 risk: unknown source: community date_added: '2026-02-27'
C4 上下文级别:系统上下文
何时使用此技能
- 处理 C4 上下文级别:系统上下文任务或工作流
- 需要 C4 上下文级别:系统上下文的指导、最佳实践或检查清单
不要在以下情况使用此技能
- 任务与 C4 上下文级别:系统上下文无关
- 你需要此范围之外的不同领域或工具
说明
- 明确目标、约束和所需输入。
- 应用相关最佳实践并验证结果。
- 提供可操作的步骤和验证。
- 如果需要详细示例,打开
resources/implementation-playbook.md。
系统概述
简短描述
[一句话描述系统做什么]
详细描述
[系统目的、能力和解决的问题的详细描述]
角色
[角色名称]
- 类型:[人类用户 / 程序化用户 / 外部系统]
- 描述:[此角色是谁以及他们需要什么]
- 目标:[此角色想要实现什么]
- 使用的关键功能:[此角色使用的功能列表]
系统功能
[功能名称]
- 描述:[此功能做什么]
- 用户:[哪些角色使用此功能]
- 用户旅程:[用户旅程图链接]
用户旅程
[功能名称] - [角色名称] 旅程
- [步骤 1]:[描述]
- [步骤 2]:[描述]
- [步骤 3]:[描述]
[外部系统] 集成旅程
- [步骤 1]:[描述]
- [步骤 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):
- 关注人和软件系统,而非技术
- 清晰显示系统边界
- 包含所有用户(人类和程序化)
- 包含所有外部系统依赖
- 使用简单、非技术性的语言
- 保持图表简洁——如果太复杂,你可能在错误的抽象级别
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少所需的输入、权限、安全边界或成功标准,请停下来要求澄清。
兼容工具
Claude CodeCursor
标签
前端开发