Skip to content
台灯与工作台

安全重构

重构的要点是安全：改前快照、先搜影响面、分批改分批验证、收尾独立审查。这套流程固定且每次重构都要走，值得打包成一个 skill——构建一次，以后重构一句话触发。

构建 refactor-code skill

Section titled “构建 refactor-code skill”
帮我构建一个安全重构的 skill，命名 refactor-code，
保存到 ~/.claude/skills/refactor-code/。


流程要求：
1. 动手前先提醒我 git commit 快照
2. 先搜索所有受影响的位置，列出影响文件清单和每个调用方的依赖点
3. 改动范围大时，按文件边界拆解并行实施；同一文件不能被两个实施者同时改
4. 每改完一批跑一次构建和测试
5. 完成后派 verification 子代理独立审查

生成的 SKILL.md 内容类似这样：

---
name: refactor-code
description: 重构代码时使用。用户要求提取模块、拆分函数、移动代码、批量改名时触发。
---


# 安全重构


1. **快照**：动手前先提醒用户 git commit——/rewind 只能回滚对话，
   不能保证文件与对话一致，git 才是文件层面的退路
2. **搜影响面**：先搜索所有受影响位置，列出影响文件清单，
   标出每个调用方依赖被重构代码的哪些行为
3. **分批改**：每批 2-3 个文件，批与批之间跑构建和测试；
   大规模跨模块迁移时按文件边界拆解并行实施，同一文件不能有两个实施者
4. **独立审查**：完成后派 verification 子代理审查公共 API 边界、
   残留代码和导出是否精当

流程在做什么

Section titled “流程在做什么”
  • 快照是退路：重构方向走偏时需要退路。/rewind 只能回滚对话，不能保证文件与对话内容一致——改文件前必须 commit
  • 先搜影响面：重构边界不清晰就动手，最容易改漏调用方。影响文件清单出来，风险一目了然
  • 并行按文件边界拆：两个实施者同时改一个文件，结果不可预测
  • 独立审查：重构最容易留下”看起来一样、语义其实变了”的坑，换个上下文审查一次

使用

Section titled “使用”
用 refactor-code 把 src/core/handler.rs 里的 validate_token 提取到 src/auth/validate.rs，保持现有调用签名不变

Peri 会按流程走：先提醒快照 → 搜影响面 → 分批改分批验证 → 独立审查。skill 的存放位置、自动加载机制和修改方式，见探索陌生代码库的说明。

进阶：worktree 隔离并行重构

Section titled “进阶：worktree 隔离并行重构”

大规模重构想同时推进多个方向（比如并行拆两个模块）时，可以用 superpowers 的 using-git-worktrees：为每个任务创建独立的 git worktree 隔离工作空间，互不干扰；完成后再用 finishing-a-development-branch 收尾合并。

获取方式：

Terminal window
npx skills add https://github.com/konghayao/peri --skill using-superpowers

用法示例：

/using-git-worktrees
用 ultracode 并行：worktree 1 做 auth 模块迁移，worktree 2 做 middleware 适配

两个 worktree 各改各的，改完合并回主分支。完整的模式说明见 Superpowers 工作流。

下一步

Section titled “下一步”