majiayu000 KISS Principle Skill
Scope: COMMON（全阶段通用）
版本: 0.1.0（占位）| 创建日期: 2025-11-27
概述
KISS（Keep It Simple, Stupid）强调简单性是设计的关键：
┌─────────────────────────────────────────────────────┐
│ 💎 KISS Principle │
├─────────────────────────────────────────────────────┤
│ "Simplicity is the ultimate sophistication." │
│ — Leonardo da Vinci │
│ │
│ "Everything should be made as simple as possible, │
│ but not simpler." │
│ — Albert Einstein │
└─────────────────────────────────────────────────────┘
检查维度
代码简单性
- 函数/方法是否短小（< 20 行）
- 逻辑是否直观易懂
- 是否避免了过度嵌套（< 3 层）
- 命名是否清晰表达意图
架构简单性
- 层次是否必要且清晰
- 组件数量是否最少化
- 依赖关系是否简单
- 是否避免了过度设计
流程简单性
- 用户操作步骤是否最少
- 配置是否有合理默认值
- 错误处理是否直接明了
复杂度信号
⚠️ 以下情况可能违反 KISS：
- 函数超过 50 行
- 类超过 300 行
- 嵌套超过 4 层
- 参数超过 5 个
- 过多的设计模式组合
分级检查策略
L1-STREAMLINED
- 每维度检查 1 个核心点（共 3 项）
- 关注明显复杂度问题
- 通过标准：3 项中 2 项通过（≥67%）
L2-BALANCED
- 每维度检查 2-3 个关键点（共 6-9 项）
- 使用圈复杂度工具分析
- 通过标准：6 项中 5 项通过（≥83%）
L3-RIGOROUS
- 全面检查所有子项（10+ 项）
- 量化复杂度指标（CC < 10）
- 记录简化建议和重构计划
- 通过标准：10 项中 9 项通过（≥90%）
>> 命令
>>kiss_check_l1 # KISS 快速检查
>>kiss_complexity # 复杂度分析
>>kiss_simplify # 简化建议
相关 Skills
- 同类: principle-dry, principle-yagni, principle-soc（设计原则家族）
- 冲突检测: principle-solid（平衡 SOLID 与 KISS）
- 应用: refactoring（简化重构）
- 验证: code-quality（复杂度检查）
TODO: 待细化复杂度指标和简化策略