使用 AI 构建 C4 模型系统上下文图（System Context）

解决架构设计初期的沟通痛点：通过 AI 快速梳理系统边界，定义用户角色（Personas）和外部依赖，并自动生成标准 C4 模型的系统上下文图。

为什么需要这个技能

在软件开发初期，技术团队与产品经理、利益相关者之间经常由于对“系统范围”的理解不一致而产生偏差。如果直接进入详细的代码设计或容器图，容易忽略关键的外部交互和用户路径。

C4 模型的 System Context 层级专注于“大局观”，它不关心具体技术栈（如 Java 或 Go），而是关注人和软件系统之间的关系。本技能让 AI 成为一名架构专家，帮你将零散的需求转化为结构化的上下文文档和可视化图表，确保所有利益相关者在同一认知维度上。

适用场景

• 项目启动阶段：需要快速定义系统边界，明确谁在使用系统，系统依赖哪些外部 API。
• 需求对齐：向非技术干系人展示系统如何与外部环境交互，而无需解释复杂的底层协议。
• 文档补全：将现有的功能列表转化为标准化的 Persona 描述和用户旅程图（User Journey）。
• 架构升级：在引入新系统前，分析该系统将如何影响现有的上下文生态。

核心工作流

1. 定义系统概览：提供系统的短描述和详细功能描述，确定核心业务目标。
2. 梳理角色与旅程：识别所有人类用户（Human User）和程序化用户（Programmatic User），并为核心功能绘制用户旅程图。
3. 映射外部依赖：列出所有外部系统（如第三方支付网关、数据库、外部 API），并说明集成方式。
4. 生成 Mermaid 图表：使用 C4Context 语法生成可视化图表。AI 会遵循“中心系统 用户 外部系统”的布局逻辑。

C4Context
    title System Context Diagram

    Person(user, "User", "Uses the system to accomplish their goals")
    System(system, "System Name", "Provides features X, Y, and Z")
    System_Ext(external1, "External System 1", "Provides service A")
    SystemDb(externalDb, "External Database", "Stores data")

    Rel(user, system, "Uses")
    Rel(system, external1, "Uses", "API")
    Rel(system, externalDb, "Reads from and writes to")

下载和安装

下载 c4-context 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐