SuperAPI AI 工具集

c4-modeling

办公与效率

查看项目

更新于 10-15 16:45

技能介绍

用途:按 C4 模型在四个抽象层级上创建分层架构图,用于文档化软件架构、规划新系统以及向不同受众沟通设计。默认从 context 层开始,可按需放大到 container、component 或 code 层。

主要能力与变量:DEFAULT_LEVEL 默认 context,可设为 context、container、component 或 code;OUTPUT_FORMAT 默认 mermaid,可选 mermaid、structurizr、plantuml;INCLUDE_LEGEND 默认 true,用于在图中添加图例。

使用方式(强制工作流):先确定受众与目的;除非已有更高层图,否则从 Level 1(Context)开始;识别当前层级的参与者与系统;用带标签的箭头定义关系;Level 2 及以上标注技术选型;检查是否混用了抽象层级;为元素添加描述。

四个层级:Level 1 Context 展示系统、用户、外部系统,隐藏内部细节、数据库与技术;Level 2 Container 展示应用、API、数据库、队列,隐藏内部结构与类;Level 3 Component 展示模块、服务、仓库,隐藏单个类与函数;Level 4 Code 展示类、接口与关键抽象,仅用于复杂或关键区域。

限制与红线:不得先画 container 图而跳过 context 图;不得在同一张图中混用 container 与 component;不得在 context 层展示实现细节;不得为非关键代码创建 code 级图。出现上述情况应先停止,核对 reference/level-guidelines.md 中对应层级指南后再继续。Mermaid 语法与完整语法参考见 reference/mermaid-syntax.md。输出应包含标明层级与系统的标题、带描述的相关元素、带标签的关系、Level 2+ 的技术选型以及清晰的分组边界。

资料未提供该技能的费用、平台限制或更详细的安装说明。