技能 code-refactoring-refactor-clean
🔧

code-refactoring-refactor-clean

安全

使用SOLID原则重构和清理代码

使用经过验证的重构模式和SOLID设计原则,将混乱、难以维护的代码转换为干净、模块化的架构。本技能提供专业指导,帮助识别代码异味、应用设计模式,并实施渐进式改进以提升代码质量,同时不破坏现有功能。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“code-refactoring-refactor-clean”。 分析这个500行的OrderSystem类,找出代码异味并提出改进建议

预期结果:

分析摘要:发现SRP违规(验证、数据库、邮件、日志混合),圈复杂度45,测试覆盖率0%。重构计划:1)将验证提取到OrderValidator(2小时),2)为数据访问创建仓储模式(4小时),3)实施依赖注入(3小时)。预计工作量:9小时,风险:中等(存在一些测试)。

正在使用“code-refactoring-refactor-clean”。 重构此函数以遵循SOLID原则

预期结果:

重构后的代码:将UserManager拆分为5个类(UserValidator、UserRepository、EmailService、UserActivityLogger、UserService),每个类单一职责。应用依赖注入以实现松耦合。结果:每方法平均15行,复杂度从25降至4,测试覆盖率提高到92%。

正在使用“code-refactoring-refactor-clean”。 对此折扣计算逻辑应用设计模式

预期结果:

应用策略模式:创建DiscountStrategy接口,包含PercentageDiscount、FixedDiscount和TieredDiscount实现。DiscountCalculator现在接受策略对象,消除了条件逻辑。好处:新折扣类型无需更改现有代码(开闭原则),可测试性提高100%。

安全审计

安全
v1 • 2/25/2026

All 90 static analysis findings are false positives. The detected patterns appear in markdown documentation files as educational code examples demonstrating refactoring patterns. The skill contains no executable code - only AI prompts and documentation. All patterns (backtick execution, email operations, file access, weak crypto references, reconnaissance commands) are within code blocks in implementation-playbook.md as teaching examples for proper refactoring. No security risks exist.

2
已扫描文件
934
分析行数
1
发现项
1
审计总数
低风险问题 (1)
False Positive: Educational Code Examples in Documentation
Static analyzer detected 90 potential security patterns (backtick execution, network operations, file access, etc.) but these all appear in markdown code blocks as educational examples. The implementation-playbook.md file contains before/after code samples demonstrating refactoring patterns - these are not executable code. Examples include Ruby backtick patterns (lines showing shell command examples in documentation), email sending code (teaching patterns for separating concerns), and file operations (demonstrating proper logging abstraction). These are documentation strings, not runtime code.
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

遗留代码现代化

按照SOLID原则和现代设计模式,将遗留的单体应用程序转换为干净、模块化的架构

代码审查改进

在Pull Request审查期间识别并修复代码异味、降低复杂性并提高可维护性

最佳实践入门

通过实际示例和分步迁移指南学习重构模式和整洁代码原则

试试这些提示

简单重构请求
重构此代码以提高可读性并减少重复
全面代码分析
分析此代码中的代码异味、SOLID违规和技术债务。提供优先级重构计划。
设计模式应用
应用适当的设计模式按照SOLID原则重构此代码。展示之前/之后的对比。
带测试的完整重构
完全重构此代码,包括生成测试套件、迁移指南和显示改进的指标报告

最佳实践

  • 始终在重构前后运行现有测试以确保行为保持不变
  • 以小的、渐进式的步骤进行重构,而不是大规模重写
  • 使用implementation-playbook.md参考获取详细的模式和示例

避免

  • 不要在没有测试的情况下重构——始终先建立测试覆盖率
  • 避免对简单解决方案过度设计——YAGNI(你不会需要它)
  • 未经相关方明确批准,不要更改外部行为

常见问题

重构会破坏我现有的代码吗?
不会,前提是正确执行。本技能强调在改进内部结构的同时保持外部行为。始终在重构前后运行测试以验证行为保持不变。
我如何知道代码是否需要重构?
寻找代码异味:长方法(超过20行)、大类(超过200行)、高圈复杂度(超过10)、重复代码、命名不佳或测试困难。本技能可以自动分析您的代码并识别这些问题。
本技能可以自动重构我的代码吗?
本技能提供重构指导并生成重构后的代码示例,但您应该手动审查和应用更改。自动重构需要人工监督以验证业务逻辑和领域特定的约束。
什么是SOLID原则?
SOLID是五个设计原则的首字母缩写:单一职责、开闭、里氏替换、接口隔离和依赖倒置。这些原则有助于创建可维护、灵活和可扩展的软件架构。
我应该立即重构所有代码吗?
不要。使用童子军规则增量重构:离开时让代码比来时更干净。优先考虑高影响、低投入的更改。本技能提供ROI分析以帮助确定重构工作的优先级。
我如何说服团队进行重构?
专注于业务价值:减少缺陷、更快的功能开发、更容易的入职和更低的维护成本。使用本技能的指标报告展示之前/之后对比,展示代码质量和可测试性的具体改进。