single-responsibility

Installation
SKILL.md

单一职责

这个 skill-unit 处理的是“职责是否混在一起”问题。它不负责定义系统分层,而负责把文件、函数、类、模块收敛到一个稳定职责上。

核心原则

1. 职责可说清 —— 说不清,通常就是过重

  • 一个文件、函数、类或模块,应该能用一句话说明自己负责什么。
  • 如果解释一个单元时必须用“既负责 A,也负责 B,还顺便处理 C”,通常说明职责已经混杂。
  • 名称与实际行为长期不一致,也是职责失焦的信号。

2. 变化原因单一 —— 不同变化面不要绑在一起

  • 单一职责的本质不是“代码少”,而是“变化原因尽量单一”。
  • 如果一段代码会因为不同角色、不同业务意图、不同技术原因频繁一起被改,就应考虑拆分。
  • 验证、计算、格式化、IO、编排等不同变化面,不应长期绑定在同一职责里。

3. 边界先清 —— 先定职责,再定拆分方式

Related skills

More from qiao-925/qiao-skills

Installs
20
First Seen
Feb 9, 2026