agentleFS
almax000almax000/claude-skills/refactor/SKILL.md

refactor

Skill1 starsChanged 7 months agoMITView on GitHub

标准化多文件重构流程。重构代码、布局变更、架构调整时使用。

196 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use ascii-diagram, debug-fix and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • SethGammonSkill

    ascii-diagram

    Generate perfectly aligned ASCII diagrams — architecture, flow, sequence, box-and-arrow. Uses a programmatic character-grid approach so alignment is guaranteed by math, not token prediction. Includes post-render verification.

    Also in 4 projects that use this

  • zebbernSkill

    debug-fix

    Find and fix a bug or issue — from any source (GitHub issue, error message, user report, or observed behavior)

    Also in 4 projects that use this

  • parcadeiSkill

    agent-context-isolation

    Agent Context Isolation

    Also in 3 projects that use this

  • parcadeiSkill

    agentica-infrastructure

    Reference guide for Agentica multi-agent infrastructure APIs

    Also in 3 projects that use this

  • +8 more from parcadei

The file

Files
SKILL.md

重构 Skill

执行流程

按以下顺序严格执行,每步完成后验证:

1. 预检查

# 确保当前构建正常
pnpm build  # 或 npm run build
  • 如果构建失败,先修复现有问题再开始重构
  • 记录当前 git 状态:git status

2. 创建新文件

  • 先创建所有需要的新文件/组件
  • 新文件应该是独立可编译的
  • 完成后运行 pnpm build 验证

3. 修改现有组件

  • 更新现有代码以引用新文件
  • 逐个文件修改,每修改 2-3 个文件后验证构建
  • 保持向后兼容直到所有引用更新完成

4. 更新入口点

  • 修改 CLI/路由/入口文件
  • 更新导出(index.ts 等)
  • 运行 pnpm build 验证

5. 清理

  • 删除不再使用的旧文件
  • 移除废弃的导入和导出
  • 运行 pnpm build 确认无遗漏依赖

6. 最终验证

pnpm build && pnpm test  # 构建 + 测试
pnpm lint                 # 代码检查(如适用)

检查点原则

每个主要步骤后都运行 pnpm build

如果某个检查点失败,立即修复再继续,不要累积错误

回滚策略

如果重构过程中遇到无法解决的问题:

git stash        # 暂存当前更改
git status       # 确认工作区干净
# 分析问题后决定是否继续

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.