Kiểm toán Nợ Kỹ thuật (Tech Debt Audit)
Rà soát toàn bộ codebase theo 9 chiều và tạo báo cáo TECH_DEBT_AUDIT.md có dẫn chứng tới từng file:dòng.
Lập trìnhTrung cấp★ 67,531⑂ 5,507Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
Skill này quét repo và đánh giá nợ kỹ thuật theo 9 chiều, rồi ghi báo cáo TECH_DEBT_AUDIT.md ở thư mục gốc.
- 9 chiều: suy thoái kiến trúc, mất tính nhất quán, nợ kiểu/hợp đồng, nợ kiểm thử, phụ thuộc & cấu hình, hiệu năng & tài nguyên, xử lý lỗi & khả năng quan sát, an toàn bảo mật, tài liệu lệch thực tế.
- Công cụ:
grep,glob,ast-grep (sg), phân tích tần suất thay đổi quagit log, chẩn đoán LSP, và tuỳ chọn CodeGraph MCP (đồ thị lời gọi, phạm vi ảnh hưởng). - Báo cáo gồm: tóm tắt điều hành, mô hình kiến trúc, bảng phát hiện (ID/nhóm/file:dòng/mức nghiêm trọng/giờ công/khuyến nghị), Top 5 ưu tiên, danh sách việc nhanh dưới 30 phút, mục "trông tệ nhưng thật ra ổn", và các câu hỏi mở.
- Mọi phát hiện buộc phải có dẫn chứng
file:line:col, hạn chế nhận xét chung chung.
Phù hợp với ai
- Lập trình viên vừa nhận bàn giao một dự án cũ và cần hiểu nhanh tình trạng.
- Team lead cần danh sách ưu tiên cho sprint refactor hoặc kế hoạch quý.
- Nhóm nhỏ muốn đưa việc review kiến trúc/chất lượng code thành quy trình định kỳ.
- Người đóng góp open-source muốn nắm cấu trúc repo trước khi sửa.
Ví dụ sử dụng
- Sau khi nhận bàn giao: yêu cầu "tech debt audit repo này" — skill sẽ chỉ ra các file lớn và thay đổi nhiều nhất, tức là vùng rủi ro cao.
- Lập kế hoạch refactor: lấy Top 5 theo tỉ lệ tác động/công sức trong bảng và đưa vào backlog sprint tới.
- Dọn dẹp nhanh cuối tuần: chọn riêng các mục dưới 30 phút như catch rỗng,
as any,TODO/HACKcòn tồn để xử lý một lượt.
· · · 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 .agents/skills/tech-debt-audit từ repo GitHub code-yeongyu/oh-my-openagent vào ~/.claude/skills/tech-debt-audit/ 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 /tmp/omo && mkdir -p ~/.claude/skills && cp -r /tmp/omo/.agents/skills/tech-debt-audit ~/.claude/skills/⚠ Đâ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 chứa skill:
git clone https://github.com/code-yeongyu/oh-my-openagent /tmp/omo - Tạo thư mục skills nếu chưa có:
mkdir -p ~/.claude/skills - Copy đúng skill này:
cp -r /tmp/omo/.agents/skills/tech-debt-audit ~/.claude/skills/ - (Nên làm) Cài
ast-grep:brew install ast-grephoặcnpm i -g @ast-grep/cli - Khởi động lại Claude Code và mở đúng thư mục dự án cần phân tích.
- Nhập yêu cầu như "chạy tech debt audit cho dự án này", sau đó mở
TECH_DEBT_AUDIT.mdở gốc repo để xem kết quả. - (Tuỳ chọn) Nếu muốn phân tích đồ thị lời gọi, cấu hình MCP server
codegraphtrong.mcp.json; không có nó skill vẫn chạy đầy đủ phần cơ bản.
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION