Agent skill

principle-solid

应用面向对象设计五大原则（单一职责、开闭、里氏替换、接口隔离、依赖倒置），系统化评审类与模块设计质量。当需要评审架构设计、重构现有代码、审查类职责划分时使用。支持多层次检查清单和违反原则的诊断修复。

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_advanced/principle-solid

SKILL.md

SOLID Principles Skill

Scope: COMMON（全阶段通用）

版本: 0.1.0（占位）| 创建日期: 2025-11-27

概述

SOLID 是面向对象设计的五大基本原则：

┌─────────────────────────────────────────────────────┐
│              🏛️ SOLID Principles                    │
├──────────┬──────────────────────────────────────────┤
│    S     │ Single Responsibility Principle         │
│    O     │ Open-Closed Principle                   │
│    L     │ Liskov Substitution Principle           │
│    I     │ Interface Segregation Principle         │
│    D     │ Dependency Inversion Principle          │
└──────────┴──────────────────────────────────────────┘

五大原则

S - 单一职责原则 (SRP)

  • 每个类/模块只有一个改变的理由
  • 职责清晰，不混杂无关功能
  • 高内聚，低耦合

O - 开闭原则 (OCP)

  • 对扩展开放，对修改关闭
  • 通过抽象实现扩展
  • 新增功能不需修改现有代码

L - 里氏替换原则 (LSP)

  • 子类可以替换父类而不影响程序正确性
  • 子类不削弱父类的前置条件
  • 子类不加强父类的后置条件

I - 接口隔离原则 (ISP)

  • 接口小而专注
  • 客户端不依赖它不需要的接口
  • 多个专用接口优于一个通用接口

D - 依赖反转原则 (DIP)

  • 高层模块不依赖低层模块，都依赖抽象
  • 抽象不依赖细节，细节依赖抽象
  • 依赖注入

分级检查策略

L1-STREAMLINED

  • 每原则检查 1 个核心点（共 5 项）
  • 关注明显违反
  • 通过标准：5 项中 4 项通过（≥80%）

L2-BALANCED

  • 每原则检查 2-3 个关键点（共 10-15 项）
  • 结合代码示例分析
  • 通过标准：10 项中 8 项通过（≥80%）

L3-RIGOROUS

  • 全面检查所有子项（15+ 项）
  • 依赖图分析 + 耦合度量化
  • 记录违反点及重构建议
  • 通过标准：15 项中 14 项通过（≥93%）

>> 命令

>>solid_check_l1     # SOLID 快速检查（5项各1个关键点）
>>solid_check_l2     # SOLID 标准检查（含代码示例分析）
>>solid_violation    # 识别 SOLID 违反点

相关 Skills

  • 同类: principle-dry, principle-kiss, principle-yagni, principle-soc（设计原则家族）
  • 应用: vertical-slice, component-boundary, layer-design（设计阶段使用）
  • 验证: code-review, refactoring（代码阶段验证 SOLID 符合度）

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