refactor-rename-for-clarity

[代码质量] 执行系统重命名以提高代码清晰度:变量、函数、类、文件。当名称不清晰、误导性或与其目的不一致时使用。

📖 中文导读:[代码质量] 执行系统重命名以提高代码清晰度:变量、函数、类、文件。当名称不清晰、误导性或与其目的不一致时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: refactor-rename-for-clarity description: "[Code Quality] Performs systematic renaming to improve code clarity: variables, functions, classes, files. Use when names are unclear, misleading, or inconsistent with their purpose."

Refactor: Rename for Clarity

Improve code readability through better naming.

Naming Principles

1. Names Should Reveal Intent

// BAD: let d: Int
// GOOD: let elapsedDays: Int

2. Names Should Be Searchable

// BAD: if status == 1 { }
// GOOD: if status == .active { }

3. Names Should Match Abstraction Level

// BAD: func getFromNetworkAndParseJSON()
// GOOD: func fetchUserProfile()

Common Patterns

Bad Name Better Name Why
data userResponse Specific type
temp previousValue Purpose clear
flag isEnabled Boolean pattern
doIt() submitForm() Action + target