Agent Skills › mhattingpete/claude-skills-marketplace › code-refactor

code-refactor

GitHub

执行批量代码重构操作，包括跨文件重命名标识符、替换代码模式和更新 API 调用。支持小范围原生工具和大规模自动化执行，确保变更安全并验证结果。

code-operations-plugin/skills/code-refactor/SKILL.md mhattingpete/claude-skills-marketplace

Trigger Scenarios

请求重命名变量或函数要求替换废弃代码模式需要统一更新多处 API 调用进行跨文件的一致性代码修改

Install

npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -g -y

More Options

Non-standard path

npx skills add https://github.com/mhattingpete/claude-skills-marketplace/tree/main/code-operations-plugin/skills/code-refactor -g -y

Use without installing

npx skills use mhattingpete/claude-skills-marketplace@code-refactor

指定 Agent (Claude Code)

npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a claude-code -g -y

安装 repo 全部 skill

npx skills add mhattingpete/claude-skills-marketplace --all -g -y

预览 repo 内 skill

npx skills add mhattingpete/claude-skills-marketplace --list

SKILL.md

Frontmatter

{
    "name": "code-refactor",
    "description": "Perform bulk code refactoring operations like renaming variables\/functions across files, replacing patterns, and updating API calls. Use when users request renaming identifiers, replacing deprecated code patterns, updating method calls, or making consistent changes across multiple locations."
}

Code Refactor

Systematic code refactoring across files. Auto-switches to execution mode for 10+ files (90% token savings).

Mode Selection

1-9 files: Use native tools (Grep + Edit with replace_all)
10+ files: Automatically use code-execution skill

Execution example (50 files):

from api.code_transform import rename_identifier
result = rename_identifier('.', 'oldName', 'newName', '**/*.py')
# Returns: {'files_modified': 50, 'total_replacements': 247}
# ~500 tokens vs ~25,000 tokens traditional

When to Use

"rename [identifier] to [new_name]"
"replace all [pattern] with [replacement]"
"refactor to use [new_pattern]"
"update all calls to [function/API]"
"convert [old_pattern] to [new_pattern]"

Core Workflow (Native Mode)

1. Find All Occurrences

Grep(pattern="getUserData", output_mode="files_with_matches")     # Find files
Grep(pattern="getUserData", output_mode="content", -n=true, -B=2, -A=2)  # Verify with context

2. Replace All Instances

Edit(
  file_path="src/api.js",
  old_string="getUserData",
  new_string="fetchUserData",
  replace_all=true
)

3. Verify Changes

Grep(pattern="getUserData", output_mode="files_with_matches")  # Should return none

Workflow Examples

Rename Function

Find: Grep(pattern="getUserData", output_mode="files_with_matches")
Count: "Found 15 occurrences in 5 files"
Replace in each file with replace_all=true
Verify: Re-run Grep
Suggest: Run tests

Replace Deprecated Pattern

Find: Grep(pattern="\\bvar\\s+\\w+", output_mode="content", -n=true)
Analyze: Check if reassigned (let) or constant (const)
Replace: Edit(old_string="var count = 0", new_string="let count = 0")
Verify: npm run lint

Update API Calls

Find: Grep(pattern="/api/auth/login", output_mode="content", -n=true)
Replace: Edit(old_string="'/api/auth/login'", new_string="'/api/v2/authentication/login'", replace_all=true)
Test: Recommend integration tests