SuperAPI AI 工具集

c4-architect

通用与其它

查看项目

更新于 10-16 04:30

技能介绍

用途:c4-architect 是一个软件架构技能,专注 C4 模型的可视化沟通、自动化架构映射与 Mermaid.js 编排,把复杂系统需求翻译为清晰的多层级图(上下文、容器、组件),用于对齐工程与业务相关方。

主要能力:按受众选择抽象层级(L1 上下文、L2 容器、L3 组件);用 codebase_investigator 提取当前系统结构(应用、服务、数据库);按顺序激活技能:activate_skill(name="c4-architect") → activate_skill(name="mermaid-diagram-pro") → activate_skill(name="docs-pro");渲染 Mermaid 代码并核对关系是否反映当前技术状态。

使用方式:L1 始终从系统上下文开始,定义系统边界与外部参与者(用户、第三方 API);L2 把系统拆为可部署单元(如 Next.js 应用、NestJS 服务、PostgreSQL、NATS);L3 仅用于高复杂度容器(如核心认证或支付服务)。使用 Mermaid 官方 C4Context、C4Container、C4Component 类型,每张图包含标题与图例;采用 Diagram-as-Code,把图存为 .mermaid 文件或嵌入 markdown,不用静态图片,并用注释或元数据把图元素链接到源码目录。

适用场景:需要向不同受众展示系统架构、在代码评审中自动生成架构图、维护“活文档”的团队。

限制与反模式:不要手工创建 L4(代码)图;不要混用抽象层级;不要给关系箭头留空标签;不要忽略图例;单图元素超过 15 个应拆分。资料还提到脚本 scripts/extract-l2-containers.ts 与 scripts/lint-mermaid.sh,以及若干学习资源,但未提供具体安装命令、收费与平台信息。