1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | modular-design-principles-tech-leads-club-agent-skills |
| 作者/维护者 | Tech Leads Club |
| 来源链接 | https://github.com/tech-leads-club/agent-skills/tree/main/packages/skills-catalog/skills/(architecture)/modular-design-principles |
| 许可证 | MIT（仓库根 LICENSE 文件，GitHub API） |
| GitHub Stars | 5,022（GitHub API；为整个技能市场共享，非本技能独有） |
| Forks | 460（GitHub API） |
| 最新版本 | skills-catalog-v0.17.3（2026-08-05，GitHub Releases） |
| 安装方式 | npx @tech-leads-club/agent-skills 交互式安装，或直接复制 SKILL.md 与 references 目录 |
2. 功能介绍与亮点
modular-design-principles 是一套技术栈无关的模块化设计原则参考与合规检查工具，核心内容包括：
- 十项模块化原则——边界清晰、可组合、独立性、可独立伸缩、显式通信、可替换、部署独立、状态隔离、可观测、故障隔离，逐项给出定义、agent 执行规则与抽象示例；
- 典型违规清单——概念冲突、越界读写持久化数据、集中式数据所有权、边缘层夹带业务规则等 8 类常见反模式；
- 创建限界上下文工作流——从命名、职责范围、状态归属到可观测性的 8 步设计流程，适用于新建模块或从既有系统拆出新领域；
- 拆分/合并六项判据——语言差异、变更节奏、规模与 SLO、一致性边界、团队归属、集成痛点，用于判断“该拆还是该合”；
- 架构合规审查通道——按依赖方向、公共接口、持久化越界等信号给出 P0/P1/P2 严重度分级，可直接用于代码评审。
亮点：内容不假设具体框架、语言或仓库结构，可反复套用于任意技术栈；SKILL.md 之外附带约 6.8KB 的 references/principles.md，为每条原则补充“给 agent 的执行规则”，明确告诉 agent 提出重构建议时该做什么、不该做什么。
3. 适用场景
所属分类：工程效率与代码质量
- 代码评审或架构复盘中需要一套可复用的检查清单，判断模块边界是否合理、是否存在越界读写等反模式
- 设计新模块或从既有系统中拆分领域时，用八步工作流理清命名、职责、状态归属与集成方式
- 团队讨论“这个模块该拆还是该合”时，用六项判据代替纯粹的直觉判断
- 受益人群：负责架构评审的技术负责人、准备拆分或新建模块边界的工程师，以及需要一份技术栈无关设计准则做团队共识的架构师
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持，所属市场官方支持列表 Tier 1 明确列出。
- Codex：⚠️ 需适配。官方支持列表 Tier 2 列出 OpenAI Codex，但未见专项适配说明。
- OpenClaw：⚠️ 需适配，标准 YAML front matter + Markdown，理论上可手工迁移，但未在支持列表中。
- Hermes Agent：❓ 未验证，材料中未提及。
5. 推荐理由
它填补了“结构化分析流水线之外的日常设计参考”这个空白：不需要先对某个代码库跑一遍完整分析，就能在任意一次代码评审、任意一次新模块设计讨论中直接当检查清单用。十项原则、违规清单、拆分/合并判据、严重度分级合在一起，覆盖了从“怎么设计边界”到“怎么审查既有边界”的闭环，且不绑定技术栈，换语言换框架也不用换参考文档。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 该子技能自身未见独立第三方讨论或使用数据；所属仓库 5,022 星为整个技能市场共享的数字，不代表本技能独立热度 |
| 可用性 | 9 | SKILL.md 与 references/principles.md 合计约 19KB，复制即用；含原则表、违规清单、创建边界工作流、拆分合并判据、合规审查分级与检查清单，内容完整；最近一次维护为 2026-04-16（约 4 个月前）；无付费依赖 |
| 安全性 | 9 | 纯提示词与检查清单类内容，检查清单结果见下 |
安全检查清单逐项结果：①无 shell 命令 ②不发起网络请求 ③不涉及任何凭据 ④未见可疑指令或隐蔽外发迹象 ⑤作者 Tech Leads Club，独立研究机构 Ry Walker Research 曾撰文分析其技能市场（详见第 8 章），未见负面记录 ⑥License 明确为 MIT ⑦最近维护 2026-04-16，非弃置项目
综合评分：7.67（三项均值）
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| modular-decomposition（同市场） | 对具体代码库执行组件盘点→耦合分析→领域分组的五步分析流水线，产出该库的候选服务边界 | 需针对具体仓库跑一遍流水线才有输出；本技能是抽象原则层，不依赖代码库现状，可反复用于日常评审 |
| coupling-analysis（同市场） | 套用《Balancing Coupling in Software Design》三维模型，对既有代码做耦合强度/距离/波动性量化诊断 | 聚焦耦合这一单一维度的深度诊断；本技能覆盖边界、耦合、独立部署等十项原则，耦合只是其中一项 |
| legacy-migration-planner（同市场） | 面向遗留系统整体现代化迁移的策略规划（绞杀者模式、跨语言重写、框架升级） | 服务于“已决定迁移”之后的路线规划；本技能服务于更早一步的“边界该怎么划” |
8. 用户评价
该技能本身在第三方平台尚无具名用户评价。其所属的 Tech Leads Club Agent Skills 市场曾被独立研究机构 Ry Walker Research 撰文分析，归类为采用静态分析、Snyk 扫描与人工审核相结合的“治理型”技能注册市场，GitHub 星数曾在一季度内从约 1.7K 增至 4.6K；文中并援引 Tech Leads Club 自身发布的行业调研——公开技能市场中超 13% 的技能存在严重安全漏洞。以上信息描述的是所属市场的整体定位，不代表本技能自身的独立评价。
9. 安装使用方式
- 交互式安装：运行
npx @tech-leads-club/agent-skills，选择“Install skills”，搜索modular-design-principles，选择目标 agent 与安装方式（复制/软链接）、范围（全局/项目内） - 手动安装：从仓库路径
packages/skills-catalog/skills/(architecture)/modular-design-principles/复制SKILL.md与references/principles.md到本地 skills 目录 - 安装后注意事项：无需重启；用自然语言描述需求（如“帮我评审这个模块的边界设计”）即可触发
10. 注意事项
- 内容刻意不绑定具体框架或仓库结构，不含可直接运行的落地代码，需自行把十项原则映射到自己的技术栈
- P0/P1/P2 严重度分级是定性启发式判断，除非团队自行定义数值门槛，否则不能当自动化门禁硬指标
- 所属仓库为多技能合集，GitHub Stars 由市场内约 80 余个技能共享，不代表本技能独立热度