principle-kiss

name	principle-kiss
description	保持设计和实现的简单性，识别并消除不必要的复杂度。当需要架构设计评审、代码简化重构、接口设计优化时使用。覆盖代码、架构、接口、流程四大维度，提供简单性检查清单和过度复杂性的诊断修复方法。
stage	COMMON
level_supported	["L1-STREAMLINED","L2-BALANCED","L3-RIGOROUS"]

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: 待细化复杂度指标和简化策略