Refactor (quy trình tái cấu trúc thông minh)
Skill ép Claude tái cấu trúc mã theo 6 giai đoạn, bắt buộc dựng codemap và chạy test sau mỗi bước.
Lập trìnhNâng cao★ 67,531⑂ 5,507Điểm AI 7/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
Thay vì tìm-và-thay thế mù quáng, skill này buộc AI đi qua một quy trình 6 giai đoạn có kiểm soát.
- PHASE 0 – Cổng ý định: yêu cầu mơ hồ kiểu "dọn dẹp code đi" sẽ bị chặn lại và hỏi rõ mục tiêu, phạm vi, tiêu chí thành công.
- PHASE 1–2 – Phân tích & codemap: chạy song song các agent explore, dùng LSP (goto definition, find references) và ast-grep để lập bản đồ phụ thuộc, vùng ảnh hưởng và mức rủi ro.
- PHASE 3 – Đánh giá test: nếu độ phủ test thấp hoặc bằng 0, skill từ chối refactor mạnh tay và đề nghị viết test trước.
- PHASE 4–5 – Lập kế hoạch & thực thi: chia thành các bước nguyên tử, sau mỗi bước phải qua lsp_diagnostics → test → type check mới được đi tiếp; hỏng là revert ngay.
- PHASE 6 – Kiểm tra cuối: chạy full test, type check, lint, build và xuất báo cáo thay đổi.
- Chế độ team: khi có công cụ team_*, tạo đội 2 worker "quick" + 2 worker "unspecified-low", còn bộ phận verify chạy bên ngoài đội.
Phù hợp với ai
- Lập trình viên phải động vào code legacy và lo AI mở rộng phạm vi ngoài kiểm soát
- Team lead muốn có rào chắn cứng: không có test thì không refactor
- Dự án TypeScript/Python/Go đã có sẵn lệnh test và LSP
- Người dùng đã cài môi trường oh-my-openagent (một số tính năng chỉ chạy ở đó)
Ví dụ sử dụng
/refactor src/auth/handler.ts --scope=file --strategy=safe— tách logic validation thành hàm riêng trong một file, chạy test sau mỗi bước để chắc chắn không hồi quy./refactor "tách class AuthService theo interface" --scope=module— dùng find references để liệt kê mọi nơi sử dụng, di chuyển theo thứ tự phụ thuộc và commit tại từng checkpoint./refactor "hiện đại hóa mọi hàm dùng API deprecated" --scope=project— tra API thay thế bằng agent librarian, xem trước bằng ast-grep rồi mới áp dụng, cuối cùng chạy full test và build.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục packages/shared-skills/skills/refactor từ repo GitHub code-yeongyu/oh-my-openagent vào ~/.claude/skills/refactor/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/oh-my-openagent && cp -r /tmp/oh-my-openagent/packages/shared-skills/skills/refactor ~/.claude/skills/refactor⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Clone repo về thư mục tạm:
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/oh-my-openagent - Tạo thư mục skills nếu chưa có:
mkdir -p ~/.claude/skills - Sao chép skill refactor:
cp -r /tmp/oh-my-openagent/packages/shared-skills/skills/refactor ~/.claude/skills/refactor - Khởi động lại Claude Code và kiểm tra
refactorđã xuất hiện trong danh sách skill. - Tại thư mục dự án, gọi bằng từ khóa
refactorhoặc câu như "tái cấu trúc module này giúp tôi". - (Tùy chọn) Skill giả định có LSP, ast-grep (
sg) và các agent/công cụ team riêng của OMO. Nên cài ast-grep trước (brew install ast-grep) để bước biến đổi theo pattern hoạt động; phần team_* sẽ bị bỏ qua nếu bạn không dùng OMO.
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION