mcpField
M
macro-architecture

macro-architecture

github.com/robsonrung开发244 次安装2 天前更新
代码仓库

关于 macro-architecture

用于选择系统级架构风格,并结合需求、代码和运行时证据评估服务拆分取舍的技能。

主要功能

  1. 01选择架构风格
  2. 02分析服务拆分
  3. 03依据运行时证据权衡
  4. 04按需查阅架构资料

适用场景

  1. 01为新系统选择架构
  2. 02评估拆分或合并服务

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/robsonrung/rar-skills --skill macro-architecture

安装后在 Claude Code 中输入/macro-architecture确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
adrtemplate.md
catalog.md
decomposition.md
event-driven.md
layered.md
microkernel.md
microservices.md
other-styles.md
space-based.md
style-selection.md
traps.md
scripts/
newadr.py

详细介绍

宏观架构

两个互补的系统级工具,着眼于同一层面——这个系统应该采用什么形态?

  • 风格选择——给定一个系统/服务/功能及其核心需求,哪种宏观架构风格(或混合风格)最合适?如果选择这种风格,书中会提醒哪些注意事项?(摘自 Mark Richards 的 Software Architecture Patterns, 2nd ed.。)
  • 难点分解——在分解、合并或重塑系统时,结合当前代码和运行时情况,权衡因素实际指向哪个方向?(摘自 Ford 和 Richards 的 Software Architecture: The Hard Parts。)

选择新事物的整体形态(或检查现有形态是否合理)时,使用风格选择。决定是拆分系统还是将其重新组合时,使用难点分解。二者可以结合使用:先选择风格,再对分解方案进行压力测试。

不同于 architecture-lens(对你手头代码中的权衡/共现关系以及分层位置/内聚性进行评审)、domain-driven-design(限界上下文边界、通用语言、跨上下文集成模式)和 design-patterns(GoF 代码模式)。此技能选择宏观形态;其他技能则评审其中的代码和上下文。

选择决策方法

需求阅读
选择或评估整体架构风格references/style-selection.md
拆分、合并或重塑服务和数据所有权references/decomposition.md
两者都需要先选择风格,再评估尚未解决的分解权衡

使用当前代码、运行时证据和用户约束。满足实际需求的最小一致形态才是合适的。明确说明收益、代价和下一步具体行动。不要把常规代码变更升级成系统重设计。

权威性与输出

决策或评审请求应返回所选方法的建议。只有用户授权实施时才进行实施。在 design-gate 下,保持只读,并使用调用方的规范门禁结果。

三项条件必须全部满足,否则不要写 ADR:难以撤销、缺少背景时会令人意外,以及确实存在权衡。当三项条件全部满足时,在决策敲定时记录,并遵循现有 ADR 约定。分解方法包含备用路径和辅助命令。

在面试中,将决策、理由、约束和来源引用补充到现有决策记录中。此阶段不适用独立报告和实施相关流程。

聚焦知识

仅加载所选方法需要的材料:

评论

支持 Markdown