1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | evolutionary-modular-architecture-tech-leads-club-agent-skills |
| 作者/维护者 | Felipe Rodrigues（github.com/felipfr），发布于 Tech Leads Club 维护的技能注册库 |
| 来源链接 | https://github.com/tech-leads-club/agent-skills/tree/main/packages/skills-catalog/skills/(architecture)/evolutionary-modular-architecture |
| 许可证 | 仓库根 LICENSE 为 MIT；本技能 SKILL.md front matter 另行声明 CC-BY-4.0（数据来源：GitHub API + 直接读取 SKILL.md） |
| GitHub Stars | 所属技能注册库整体 5,018（数据来源：GitHub API；该数字属整个合集，不代表本技能自身热度） |
| Forks | 合集仓库整体 458 |
| 最新版本 | SKILL.md 内声明 1.0.0（数据来源：直接读取 SKILL.md） |
| 安装方式 | 官方 CLI 一条命令安装（npx @tech-leads-club/agent-skills） |
2. 功能介绍与亮点
evolutionary-modular-architecture 把“渐进式模块化单体”（evolutionary modular monolith）这套系统设计方法论转成一条可分阶段执行的工作流，核心主张是把逻辑边界（模块、契约、状态归属、反腐败层）与物理边界（是否独立部署、独立数据库）分开处理——前者从第一天起就要严格，后者留到指标真正需要时再演进，从而让系统可以先以单一部署起步、日后无需重写即可拆分。
七个阶段依次覆盖：
- 领域发现（DDD 战略设计）——识别核心/支撑/通用子域
- 边界与上下文映射——决定模块归属哪张表、划定上下文关系
- 模块内部组织——按业务概念（聚合）而非技术分层组织文件，即 flat-by-aggregate
- 通信与反腐败层——每个外部系统都套一层 Port + Adapter，跨模块用事务性 Outbox 发事件
- 弹性工程——超时、熔断器、指数退避加抖动、幂等键
- 技术栈与演进路径——给出 2026 年 TypeScript 技术栈建议与何时该真正拆分的判断标准
- 架构文档生成——产出一份自带 SVG 示意图的独立 HTML 架构文档
主要亮点：附带两个零依赖 Node.js 校验脚本（validate-structure.mjs、validate-boundaries.mjs），可在 CI 中把“禁止跨模块直接导入”“禁止技术分层文件夹”等原则变成自动化检查；7 份参考文档按阶段需要才加载，不会一次性塞满上下文；仓库自身声明所有技能发布前经第三方 Snyk Agent Scan 安全扫描。
3. 适用场景
所属分类：工程效率与代码质量
适合在设计一个全新后端平台或服务、决定“该用单体还是微服务”、划定限界上下文与模块归属、或需要把外部依赖（ERP、支付、存储、AI 服务）解耦时使用。目标用户是用编码 agent 设计新后端平台或审查系统模块边界的架构师，尤其是准备采用 2026 年 TypeScript 技术栈（Nx、NestJS、React）的团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持 ✅——官方 CLI 明确列入第一梯队支持列表，可通过交互式向导或
agent-skills install -s evolutionary-modular-architecture直接安装 - Codex：支持 ✅——官方 CLI 支持列表列出 OpenAI Codex（第二梯队）
- OpenClaw：未验证——官方支持列表未列出该 agent；SKILL.md 是标准 YAML front matter + Markdown 格式，理论上可手动复制使用，但未找到官方安装适配或第三方验证
- Hermes Agent：未验证——同上，官方支持列表未列出，也未检索到独立于该仓库之外的第三方收录证据
5. 推荐理由
把渐进式模块化单体的边界设计方法论转成分阶段工作流与自动化边界校验脚本，让架构决策不再只停留在文档里，而是有对应的 CI 检查可以真正拦住“跨模块直接导入表”这类结构性腐化。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 该技能所属注册库共 88 个 SKILL.md，仓库整体星数不代表本技能自身热度；本技能自身尚未见独立于母仓库之外的具名第三方评价或讨论 |
| 可用性 | 9 | 官方 CLI 一条命令安装；SKILL.md + 6 份参考文档 + HTML 模板 + 2 个自动化校验脚本共 11 个文件，覆盖设计到落地文档的完整链路；最近一次提交在近期，持续维护；纯文本 + 本地脚本内容，无付费依赖 |
| 安全性 | 8 | 见下方检查清单 |
综合评分：7.33
安全检查清单逐项结果：
① Shell 命令/权限范围——含两个本地 Node.js 校验脚本（validate-structure.mjs、validate-boundaries.mjs），逐行核查确认仅做本地文件系统读取与正则匹配，无子进程调用、无 eval；② 联网外发——未见任何网络请求代码；③ API key/凭据——不需要；④ 可疑指令——通读 SKILL.md 及全部参考文档未发现提示注入或隐蔽指令迹象；⑤ 作者信誉——独立开发者在 Tech Leads Club 维护的技能注册库中发布，该仓库声明全部技能发布前经第三方 Snyk Agent Scan 扫描；⑥ License——明确，仓库根 MIT + 技能自身声明 CC-BY-4.0；⑦ 最近维护——近期仍有提交，持续活跃。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| domain-driven-design（wondelai/skills 子技能） | 把战略与战术 DDD 方法论转化为可打分的诊断框架，内置 7 项快速诊断标准与聚合/值对象判定测试 | 聚焦“领域建模”本身；evolutionary-modular-architecture 只把 DDD 战略设计作为七阶段之一，额外覆盖模块内部组织（flat-by-aggregate）、反腐败层与事件驱动通信、弹性工程（熔断/退避/幂等）、技术栈选型与自动化边界校验脚本，是端到端的平台设计方法论而非单一领域建模工具 |
| nestjs-modular-monolith（同注册库 tech-leads-club/agent-skills 子技能） | 专精 NestJS 框架内模块化单体的落地细节，从领域分析直接给到生产级 NestJS 模块结构 | evolutionary-modular-architecture 定位在框架无关的架构决策层（先决定该不该拆、边界怎么划），NestJS 专精的代码级实现细节由该兄弟技能承接，二者是“决策”与“落地执行”的分工关系 |
8. 用户评价
该技能目前在第三方平台尚无独立的具名用户评价。
9. 安装使用方式
方式一：交互式向导
npx @tech-leads-club/agent-skills方式二：直接安装本技能
npx @tech-leads-club/agent-skills install -s evolutionary-modular-architecture（也可全局安装 CLI 后直接用 agent-skills install -s evolutionary-modular-architecture）
安装后无需重启。技能通过 SKILL.md 的 description 字段自动触发——当对话中出现“模块化单体”“限界上下文”“flat-by-aggregate”“反腐败层”“架构文档”等关键词，或要求设计新后端平台、选型技术栈时会自动激活；也可以直接要求 agent 按该方法论审视现有系统的模块边界。
10. 注意事项
- 技术栈建议聚焦 2026 年 TypeScript 生态（Nx、NestJS、React），非 TypeScript 项目需要自行把原则迁移到对应技术栈
- 该技能是所属注册库 88 个 SKILL.md 之一；仓库整体星数与活跃度不代表本技能自身热度
- OpenClaw 与 Hermes Agent 兼容性未获验证
- 内容是方法论指导框架，两个自动化校验脚本仅覆盖结构与边界检查，弹性工程、事件驱动通信等其他原则仍需人工审查落实