Nm Conserve Code Quality Principles

🦀 经典原则速查,重构即查即用

软件工程经典原则速查指南,涵盖KISS/YAGNI/SOLID五大原则,提供多语言代码示例与冲突权衡策略,适合代码审查和重构参考。

收藏
2.4k
安装
991
版本
1.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

本Skill提供KISS、YAGNI、SOLID三大经典代码质量原则的系统性指导,包含:

  • KISS(保持简单):倡导显式代码优于 clever one-liners,通过Python/Rust对比示例展示过度抽象的代价
  • YAGNI(不要预构):强调"第三用例出现再抽象",反对为单一场景创建继承体系
  • SOLID五原则:每个原则配备代码正反面示例(SRP按职责拆分、OCP用抽象类扩展、LSP警惕正方形继承矩形、ISP接口拆分、DIP依赖注入)

显著优点

1. 多语言覆盖:Python/TypeScript/Rust示例,跨栈开发者友好
2. 实用对照表:Quick Reference将原则转化为可操作的审查清单(如"类>500行即God Class")

3. 冲突解决指南:明确KISS与SOLID的取舍场景、YAGNI与DIP的平衡时机

4. 即查即用:设计阶段触发(design/principles/clean-code/architecture),适合Code Review锚点

潜在局限

  • 语言局限:Java/C#/Go等主流语言示例缺失,OOP导向明显
  • 场景盲区:微服务拆分、函数式编程、并发模式等现代架构议题未涉及
  • 量化不足:原则冲突时缺乏决策框架(如复杂度阈值的具体指标)
  • 过度简化风险:新手可能教条化应用(如机械拆分导致"类爆炸")

适合人群

  • 中级开发者重构祖传代码
  • Tech Lead制定团队代码规范
  • 代码审查中需要"原则背书"的评审者

常规风险

  • 误用场景:在性能关键路径或一次性脚本中强行套用SOLID
  • YAGNI误判:删除代码时未识别真正的未来扩展点
  • 抽象泄漏:DIP注入的抽象层本身成为维护负担

Nm Conserve Code Quality Principles 内容

手动下载zip · 4.8 kB
skill-card.mdtext/markdown
请选择文件