Refactor Zh
重构代码时使用。按中文工程规范做安全重构:命名规范化、注释优化、函数拆分、消除重复,保持行为不变、小步提交。特别适合把英文思维写的中文项目代码改造成规范可维护的状态。
Install
npx skills add RazorEdge-wyh/zh-skills --skill refactor-zhgit clone --depth 1 https://github.com/RazorEdge-wyh/zh-skills.git /tmp/zh-skills
mkdir -p ~/.claude/skills
cp -r /tmp/zh-skills/.claude/skills/refactor-zh ~/.claude/skills/refactor-zhPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 中文工程规范 · 安全重构(refactor-zh)
当用户要求重构、清理、优化代码结构时激活本技能。重构**不是重写**,铁律是:**行为不变、小步提交、可随时回滚**。
## 重构纪律
1. **先有测试再动手**:没有测试时,先补"行为快照"(关键路径的最小测试)或用 `git stash` 兜底。
2. **一次只做一个意图**:命名规范化、函数拆分、去重复,别混在一次改动里。
3. **每次小步提交**:一个重构动作一个 commit(见 commit-zh),commit message 写明"纯重构:无行为变化"。
4. **每步可验证**:重构后跑测试、能编译、能启动。不满足就回退。
5. **性能与可读性冲突时**,先可读性;量化到真实瓶颈时再优化。
## 重构动作清单(按优先级)
### 1. 命名规范化(最高性价比)
- 拼音 → 英文:`jine` → `amount`,`shijian` → `createdAt`,`mingcheng` → `name`。
- 语义不明 → 明确:`data` → `orderList`,`flag` → `isPaid`。
- 统一风格:方法动词开头、常量大写、类名 PascalCase。
- 全局搜索确认改动范围,防止漏改(改一半更危险)。
### 2. 注释优化
- 删除"是什么"注释(`// 遍历`)、废弃注释、调试残留。
- 补上缺失的"为什么"注释:业务取舍、特殊边界、性能考量的原因。
- 把过时注释**更新为真实行为**,不要留着和代码矛盾的注释。
### 3. 函数拆分
- 拆分条件:>50 行、参数 >4、嵌套 >3、一个函数做多件事。
- 提取时用"命名即文档":新函数名 = 旧代码块的意图。
- 早退(guard clause)替代深嵌套:`if (!user) return;` 而不是 `if (user) { ... }`。
### 4. 消除重复
- 相同逻辑 → 抽公共函数/工具;相似逻辑 → 抽象差异点参数化。
- 重复的常量、魔数 → 常量或枚举。
- 复制粘贴的 UI 片段 → 公共组件。
### 5. 死代码清理
- 未被引用的导出、`console.log` 残留、注释掉的代码块 → 删除。
- 删除前全局搜索确认无引用;拿不准的先问或保留标注。
### 6. 结构整理
- 相关代码聚合:同一模块的辅助函数就近放置。
- 依赖方向清晰:工具层不反向依赖业务层。
- 明显的层级错位(业务逻辑混进工具函数)移动到正确位置。
## 输出约定
- 重构前:列出**计划清单**,标注每项的影响范围,让用户确认再动手。
- 重构后:给出**变更摘要**,说明动了什么、行为如何保证不变、跑了哪些验证。
- 涉及公共 API / 外部依赖签名的改动,必须高亮提醒(可能影响调用方)。
## 完成标准
- [ ] 所有测试通过(或至少关键路径验证通过)
- [ ] 无拼音命名残留(`git grep` 复查)
- [ ] 注释与代码一致,无翻译腔
- [ ] 每个重构动作独立 commit
- [ ] 能构建、能启动Details
- Skill name
refactor-zh- Repository
- RazorEdge-wyh/zh-skills
- Path
.claude/skills/refactor-zh/SKILL.md- License
- MIT
- Repo updated
- 6 November 2026
FAQ
What does the Refactor Zh skill do?
重构代码时使用。按中文工程规范做安全重构:命名规范化、注释优化、函数拆分、消除重复,保持行为不变、小步提交。特别适合把英文思维写的中文项目代码改造成规范可维护的状态。
How do I install the Refactor Zh skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add RazorEdge-wyh/zh-skills --skill refactor-zh. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Refactor Zh popular?
It lives in RazorEdge-wyh/zh-skills, which has 6 GitHub stars and 3 forks.
Related skills
Code Review Zh
6RazorEdge-wyh/zh-skills
审查代码时使用。按中文工程规范对代码做 review:命名、注释、可读性、错误处理、边界、安全、性能。特别关注中文项目里的拼音命名、翻译腔注释、神秘缩写。
Commit Zh
6RazorEdge-wyh/zh-skills
写 git commit message 时使用。按 Conventional Commits 规范产出中文 commit message:类型 + 作用域 + 中文描述,动词开头,一行能看懂。特别适合中文团队统一提交风格。
Health Check Zh
6RazorEdge-wyh/zh-skills
对项目做"中文工程健康体检"时使用。检查项目的中文规范健康度:README 是否地道、CLAUDE.md 是否存在、命名是否含拼音、注释是否有翻译腔、文档是否缺失。输出评分和可执行的修复清单。
Appels Offres
10artguru-tech-team/claude-skills-public
Use when responding to French public procurement tenders (appels d'offres, marchés publics, MAPA, DCE). Triggers on AO analysis, mémoire technique drafting, DCE review, CRF pricing, security questionnaire, candidature preparation. Also use when evaluating Go/No-Go on a tender.
Windmill Expert
5CoderMageFox/claude-skills-market
Comprehensive Windmill workflow platform expert. Use when building scripts, flows, apps, or managing resources in Windmill. Covers TypeScript/Python/Go/Bash scripting, multi-step workflows, UI apps, schedules, webhooks, and API integration.
Prior Art Scout
5tlzmw001/naiyue-skills
项目开工前的技术方案调研引擎——给定项目想法,优先核验用户明确提供的项目、URL、工具或技术方向,再搜索最相关的整体方案并把任务拆成流程环节;从 GitHub、Web、X 等来源广泛保留轻量候选,覆盖开源、托管 API、SDK+闭源后端、MCP 等供应形态,对方向命中、完整方案和流程补位候选先核验是否真实可用、文档是否详细、接入是否不过度复杂,每个来源最多选择 5 个做代码或一手材料深验,最终聚焦回答别人解决什么问题、使用什么工具/流程/技术、能否直接使用或借鉴,并给出证据可追溯的评估与建议。当用户说“我想做一个 XX,先调研一下”“优先看看这个项目/方向”“看看有没有人做过类似的”“找现有方案/竞品/prior art”“开工前查一查”时使用。
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.