前言¶

做架构设计最常见的两个坑：一是还没想清楚体量、团队和演进速度，就直接在单体和微服务之间做选择；二是只画一张模块图，可用性、扩展性、安全、可观测性这些非功能性目标没人认领。下面介绍的这个 Skill，就是把这两件事系统化：先从需求出发定约束，再对比候选架构的权衡，最后用 C4 和时序图把结论表达清楚。

这是什么¶

软件架构设计是一个社区发布的通用 SKILL.md 格式 Skill，坐标 @user_af163eaa/z-dev-architecture，发布者 user_af163eaa，当前版本 1.0.1，分类 dev-programming。它不生成代码，而是提供一套设计方法论：在动手写框架代码之前，帮你把需求驱动的约束、候选架构的权衡、质量属性的目标和验证方式理清楚。

核心功能¶

1、需求驱动定约束。把体量、团队规模、演进速度作为输入，而不是先选技术栈。体量决定部署单元的数量级，团队决定沟通成本和边界划分，演进速度决定重构窗口和耦合容忍度。

2、候选架构对比。围绕单体、微服务、事件驱动、Serverless 四类形态展开权衡，关注各自的适用前提、运维复杂度、故障域和一致性成本，而不是简单罗列优缺点。

3、质量属性清单。把可用、扩展、安全、可观测这几项明确到可验证的程度：可用性对应故障域和降级路径，扩展性对应瓶颈点与水平扩展能力，安全对应信任边界和数据暴露面，可观测性对应指标、日志、链路三件套。

4、用图表达结论。建议用 C4 模型分层表达静态结构，用时序图表达关键链路的调用和失败路径，避免一张大图说不清边界和时序。

安装与启用¶

官方页面未公开统一的 CLI 安装命令，Skill 以通用 SKILL.md 格式提供，需要按宿主环境的规则加载。

Cursor / Codex CLI / Claude Code 三者的加载方式不同，官方资料未分别给出命令，这里不做推测。核实不到的部分请以官方页面为准：

https://api.skillhub.cn/user_af163eaa/z-dev-architecture

https://www.skillhub.cn/skills/user_af163eaa/z-dev-architecture

使用前建议确认两点：一是 Skill 的 requires_api_key=false，不依赖外部付费模型接口；二是宿主工具能否正确读取 SKILL.md 的元数据和正文。

典型用法¶

下面是从官方简介可以推导出的复现路径，按顺序执行即可。

1、先给出体量、团队人数、迭代节奏三句话。例如：服务数在 3 到 5 个，团队 6 人，每两周一次发布。这三句决定后面选型的天花板。

2、再列出候选架构形态。单体、微服务、事件驱动、Serverless 各写一行适用前提和一条主要代价，不要只写名字。

3、然后按质量属性逐项打勾。可用性写清故障域和降级路径，可观测性写清指标、日志、链路分别覆盖哪些链路，安全写清信任边界。

4、最后补两张图。一张 C4 上下文图说明系统边界和外部依赖，一张时序图说明关键链路的调用顺序与失败分支。

适用场景与注意¶

适合的场景：新项目立项阶段需要一份能评审的架构说明；现有系统要拆分或重构，需要先把约束和质量目标写清楚；跨团队讨论时需要统一语言和图表表达。

需要注意的地方：这是方法论类 Skill，输出的是决策和文档，不替代代码验证。选型结论仍然要拿真实负载和故障演练去检验。另外，微服务、事件驱动、Serverless 的代价往往在运维和排障上，别只看开发期效率。团队规模小、服务边界不稳定时，单体加模块化往往比微服务更合适。

结语¶

这个 Skill 的价值在于把架构设计从经验判断变成可评审的流程：先定约束，再比权衡，然后落到质量属性和图。它不替你做决定，但能让你把决定的原因写清楚。

官方地址：https://api.skillhub.cn/user_af163eaa/z-dev-architecture