Agent Skills
返回列表
架构设计

架构设计

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @metago/metago-architecture-design 技能。

技能介绍

要解决的问题

进入架构设计前,「想清楚再动手」往往比画出第一张图更关键。但输入常常只是一句话、一个口头目标,或者一段还没收敛的上下文:该选同步还是异步,要不要拆服务,接口边界划在哪,哪些决策会限制后续演进,这些判断散落在团队共识与文档缺口里。等到写评审材料时才发现,模式与模块的取舍缺依据,时间被反复对齐吃掉,真正复杂的点被埋进冗长文档。本技能面向设计前的快速自查:在投入大量精力完成深度交付前,先拿到一份可读、可讨论、可标注不确定度的要点清单,用于对齐方向、识别风险,而不是直接替代方案评审。

它如何工作

技能以纯提示词方式运行,不依赖额外运行时,也不发起外部请求。进入上下文后,它会识别架构类需求与设计前自查场景,再把讨论收敛到四项核心能力上:

  • 架构模式建议:给出可选方向与适用前提,帮助团队从同步/异步、单体/服务化等常见模式里做取舍。
  • 模块划分:界定边界,避免一开始就拆得过细,或把多个职责糊在一起。
  • 接口契约要点:提示必写语义,例如幂等、重试、错误码与状态表达,而不是只列字段名。
  • 演进提示:标注哪些决策会限制后续扩展,哪些可以后置,减少早期过度设计。

输出采用快速版结构:先给核心结论,再展开要点建议,适合日常自查、评审前预演和方向对齐。

适用边界与注意点

快速版不产出完整可评审设计文档,也不生成实现代码。需要正式评审、可存档报告、逐项清单或整改方案时,请升级到专业版;涉及具体代码实现的细化设计,也应走完整设计流程。常见误区是脱离实际规模做防御式设计,以及只定义接口字段却漏掉幂等语义,这两类问题会在后期集中变成维护成本。边界处理上,需求模糊时先确认核心场景,规模未知时明说假设,信息不足时引导补充而不是臆测,不确定的结论标注置信度。安全方面,本技能为纯提示词,不执行外部网络请求,不收集用户数据,最小权限运行;关键结论仍建议人工复核,尤其是涉及数据一致性、事务边界与外部依赖时。

使用场景

  • 需求刚提出时,快速梳理架构模式、模块划分与演进提示,形成设计前要点。
  • 服务拆分前,用要点清单核对模块边界与接口契约,避免直接进入详细设计。
  • 评审准备阶段,先抽取核心结论与不确定点,作为正式文档前的对照材料。
  • 规模或目标不清时,先列出假设并标注置信度,再补全接口幂等与异常处理。

适合人员

  • 准备评审的系统架构师,需要先给出模式与边界要点,再决定是否进入正式设计。
  • 带新项目的后端工程师,要在编码前确认模块划分和接口契约,减少返工。
  • 服务化改造负责人,需要快速识别演进路径、幂等语义和规模假设。
  • 做技术选型的团队负责人,希望在决策早期看到核心结论与适用边界。