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