KISS Principle Skill
Scope: COMMON（全阶段通用）
版本: 0.1.0（占位）| 创建日期: 2025-11-27
概述
KISS（Keep It Simple, Stupid）强调简单性是设计的关键：
code
┌─────────────────────────────────────────────────────┐ │ 💎 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%）
>> 命令
code
>>kiss_check_l1 # KISS 快速检查 >>kiss_complexity # 复杂度分析 >>kiss_simplify # 简化建议
相关 Skills
- •同类: principle-dry, principle-yagni, principle-soc（设计原则家族）
- •冲突检测: principle-solid（平衡 SOLID 与 KISS）
- •应用: refactoring（简化重构）
- •验证: code-quality（复杂度检查）
TODO: 待细化复杂度指标和简化策略