design-principles

eser 的头像作者 eser

代码设计模式,包括纯函数、不可变性、组合、单一职责和异步模式。在设计代码结构、编写函数或讨论设计模式时使用。

📖 中文导读:代码设计模式,包括纯函数、不可变性、组合、单一职责和异步模式。在设计代码结构、编写函数或讨论设计模式时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: design-principles description: Code design patterns: pure functions, immutability, composition, and async. Use when designing code or functions.

Code Design Principles

Patterns for writing clean, maintainable, and testable code.

Quick Start

// Pure function with immutability
function updateUser(user: User, age: number): User {
  return { ...user, age }; // new object, no mutation
}

Key Principles

  • Pure functions: no side effects, same input = same output
  • Immutability: create new objects/arrays instead of mutating
  • Single responsibility: one function = one task
  • Early returns: reduce nesting, improve readability
  • Composition over inheritance: inject dependencies
  • Promises over callbacks for async code
  • Template strings over concatenation
  • Plain objects for data, classes only for stateful services
  • Avoid global variables and getters/setters
  • Lazy initialization: no module-level side effects, wrap in getter functions

References

See rules.md for complete guidelines with examples.