Agent skill

principle-kiss

保持设计和实现的简单性，识别并消除不必要的复杂度。当需要架构设计评审、代码简化重构、接口设计优化时使用。覆盖代码、架构、接口、流程四大维度，提供简单性检查清单和过度复杂性的诊断修复方法。

View SKILL.md on GitHub Repository
Stars 5
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/common_normal/principle-kiss

SKILL.md

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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

tikazyq/agentic-spec-forge

code-review

执行代码审查流程（提交PR→自查→同行审查→反馈修改→合并），覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。

5 1
Explore
tikazyq/agentic-spec-forge

code-quality

执行代码质量门禁检查（测试通过→覆盖率→Lint→GOAL追溯→可提交），验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。

5 1
Explore
tikazyq/agentic-spec-forge

tdd-cycle

执行 TDD 红绿重构循环（RED→GREEN→REFACTOR→REPEAT），通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。

5 1
Explore
tikazyq/agentic-spec-forge

refactoring

执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

5 1
Explore
tikazyq/agentic-spec-forge

arch-options-compare

比较多个架构方案（单体/微服务等），从SOLID原则、成本、复杂度等维度评分，生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。

5 1
Explore
tikazyq/agentic-spec-forge

dev-tech-view-supplement

根据设计补充Dev视角的技术细节（数据库/API/通信协议），帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results