Trình chỉ huy Refactor thông minh

Skill điều phối refactor theo quy trình 6 pha: xác nhận ý định, dựng bản đồ phụ thuộc, đánh giá test, lập kế hoạch và kiểm chứng sau từng bước.

Lập trìnhNâng cao★ 67,531⑂ 5,507Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026

Skill này làm gì

Khi bạn yêu cầu "refactor", "dọn dẹp", "tách hàm", skill buộc AI đi qua 6 pha thay vì sửa code ngay.

PHASE 0 – Cổng ý định: yêu cầu mơ hồ kiểu "cải thiện đi" bắt buộc phải hỏi lại; xác định mục tiêu, phạm vi, tiêu chí thành công.
PHASE 1~2 – Bản đồ code: chạy song song các agent explore cùng LSP (goto definition, find references), ast-grep và grep để dựng đồ thị phụ thuộc, vùng ảnh hưởng và bảng mức rủi ro.
PHASE 3 – Đánh giá test: phát hiện hạ tầng test và quyết định theo mức coverage (>80% / 50–80% / <50% / không có), có thể tạm dừng hoặc từ chối refactor mạnh tay.
PHASE 4~5 – Kế hoạch & thực thi: dùng agent plan tạo các bước nguyên tử kèm chiến lược rollback; mỗi bước phải qua diagnostics → test → typecheck mới được đi tiếp.
PHASE 6 – Kiểm chứng cuối: chạy toàn bộ test, typecheck, lint, build rồi xuất báo cáo thay đổi.
Phụ lục team mode: khi có các tool team_*, điều phối đội 4 worker song song và một verifier chạy bên ngoài team.

Phù hợp với ai

Dev làm việc trên codebase vừa/lớn đã có test và thường xuyên đổi cấu trúc
Nhóm từng bị lỗi hồi quy vì AI refactor mù
Môi trường dùng runtime oh-my-openagent (omo) hoặc có LSP/ast-grep

Ví dụ sử dụng

/refactor src/auth/handler.ts --scope=module → dựng bản đồ phụ thuộc rồi chia nhỏ, chạy test sau mỗi bước.
"Tách logic validate khỏi class AuthService" → khảo sát quy ước hiện có, xem trước bằng ast-grep rồi mới áp dụng.
"Hiện đại hoá mọi hàm dùng API deprecated" --strategy=safe → dùng agent librarian tra API thay thế, nếu coverage thấp thì đề nghị viết test trước.

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/HEAD/packages/shared-skills/skills/refactor/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

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.

↓ Tải ZIP

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 && mkdir -p ~/.claude/skills/refactor && cp oh-my-openagent/packages/shared-skills/skills/refactor/SKILL.md ~/.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 và clone repo: git clone https://github.com/code-yeongyu/oh-my-openagent.git
Tạo thư mục skill: mkdir -p ~/.claude/skills/refactor
Sao chép file: cp oh-my-openagent/packages/shared-skills/skills/refactor/SKILL.md ~/.claude/skills/refactor/
Mở file ra: nội dung nằm trong chuỗi template export const REFACTOR_TEMPLATE = .... Nên xoá dòng export const và các dấu backtick, chỉ giữ phần nội dung Markdown.
Chuẩn bị công cụ đi kèm: cài ast-grep (sg), xác định lệnh test/typecheck của dự án.
Các lời gọi riêng của omo (call_omo_agent, team_*) không chạy trên Claude Code thuần — hãy thay bằng Task subagent hoặc thực thi tuần tự.
Khởi động lại Claude Code và thử yêu cầu "refactor module này" để kiểm tra skill có kích hoạt.

Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION