nguyen-agn/SOLID & Unit Test Refactoring
skills/Refactoring-AI-Context/SKILL.md
Skill để tái cấu trúc (refactor) một module bất kỳ theo chuẩn SOLID, áp dụng Interface-first và bổ sung Unit Test hoàn chỉnh.
$ install --global
skillsauthnpx skillsauth add nguyen-agn/uml_comparator SOLID & Unit Test RefactoringInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 8, 2026, 2:07 AM37.4s5 files scanned
SKILL.md
- name:
- SOLID & Unit Test Refactoring
- description:
- Skill để tái cấu trúc (refactor) một module bất kỳ theo chuẩn SOLID, áp dụng Interface-first và bổ sung Unit Test hoàn chỉnh.
SKILL: Refactoring Module theo chuẩn SOLID & Unit Test
1. Mô Tả (Intent)
Skill này cung cấp định hướng và quy trình bắt buộc để Agent tái cấu trúc lại một module hoặc tính năng bất kỳ có sẵn trong dự án. Trọng tâm của việc refactoring là đảm bảo mã nguồn tuân thủ nguyên tắc SOLID, đặc biệt là Open/Closed Principle, sử dụng Interface-first design, và đảm bảo mọi logic đều được bao phủ bởi Unit Test. Mục tiêu là làm cho mã nguồn linh hoạt hơn, dễ mở rộng, dễ maintain và tránh sửa đổi chéo giữa các module không liên quan.
2. Đầu Vào (Inputs)
- Mã nguồn hiện tại của module cần refactor.
- Các yêu cầu mới (nếu có) đòi hỏi việc refactor.
- Mô tả các giới hạn, sự ràng buộc của hệ thống đối với module này.
3. Đầu Ra Kỳ Vọng (Expected Outputs)
- Mã nguồn mới đã được tách ghép theo các nguyên tắc SOLID.
- Interface rõ ràng thống nhất cho các thành phần, với comment giải thích rõ ràng chức năng.
- Các file
*_test.gođầy đủ, bao phủ (coverage) các ca kiểm thử chính (happy path, edge cases). - Mã nguồn sau khi refactor không làm phá vỡ logic cũ hoặc module khác.
4. Chiến Lược Thực Thi Tổng Quát
- Phân tích (Analyze): Nhận dạng module hiện tại, đánh giá vi phạm nguyên lý SOLID (ví dụ: file có quá nhiều trách nhiệm, chứa logic hard-code, dính chặt với concrete class).
- Thiết kế Interface (Interface-first): Định nghĩa Interface mô tả hành vi, với comment cụ thể cho từng method. Bắt buộc để cho các module giao tiếp thông qua Interface chứ không giao tiếp trực tiếp qua Implementation (Class).
- Phân rã (Decouple): Tách Implementations ra khỏi nhau để thỏa mãn Single Responsibility (SRP) và Open/Closed (OCP).
- Tích hợp Unit Test: Viết các Unit Test dễ dàng nhờ vào các Interface vừa được thiết kế; áp dụng Table-Driven Test.
- Kiểm chứng (Verify): Xác nhận code chạy đúng, Pass test và tự review qua
check.md.
Chuyển sang bước tiếp theo: Đọc knowledge.md để nắm bắt luật chơi và rule bắt buộc khi thực hiện.
Related Skills
nguyen-agn/skills/Visualizer-AI-Context
development
VerifiedTrustedCommunity
# SKILL: drawio-visualizer ## Purpose Render kết quả chấm UML ra 2 loại file HTML self-contained: 1. **Grader Report** (`report_*.html`): Full side-by-side Student vs Solution, summary, deduction feedbacks — dành cho người chấm. 2. **Student Feedback** (`feedback_*.html`): Chỉ hiển thị bài làm SV với color-coded status (đúng/sai/thừa). Không lộ đáp án, không hiện deduction details — gửi cho sinh viên xem lại. ## Execution 1. Pipeline: Parse → Build → Validate → PreMatch → Match → Compare → Grad
1SKILL.mdUpdated Apr 8, 2026
nguyen-agn/uml-testcase-runner
development
VerifiedTrustedCommunity
Chạy test case trên các file UML draw.io để kiểm tra xem Builder + ValidateGraph có phát hiện đúng lỗi. Dùng để verify rằng pipeline xử lý UML bắt được các loại lỗi sai trong file .drawio.
1SKILL.mdUpdated Apr 8, 2026
nguyen-agn/skills/Reporter-AI-Context
development
VerifiedTrustedCommunity
# SKILL: batch-grader-reporter ## Purpose Cung cấp chức năng chấm điểm đồng loạt (Batch Grading) cho nhiều file bài làm UML (`.drawio`) của sinh viên đối chiếu với 1 file đáp án mẫu. Kết quả của tất cả các bài nộp được tổng hợp lại thành `BatchGradeResult` và chuyển đền interface `IReporter` để sinh report. ## Execution 1. Cấu trúc: - Load file solution `solution.drawio`. - Quét thư mục `student_dir` tìm các file `.drawio`. - Với mỗi file: Parse → Build → PreMatch → Match → Compare →
1SKILL.mdUpdated Apr 8, 2026
nguyen-agn/skills/Prematcher-AI-Context
development
VerifiedTrustedCommunity
# SKILL: uml-pre-matcher ## Purpose Biến đổi mô hình `domain.UMLGraph` (dạng chuỗi thô) thành `domain.ProcessedUMLGraph` (dạng cấu trúc chi tiết). Đây là bước đệm quan trọng để module Matcher có thể so khớp chính xác dựa trên thuộc tính, phương thức và trọng số kiến trúc (ArchWeight). ## Use When - Khi Builder đã tạo xong `UMLGraph`. - Khi cần phân tích sâu cấu trúc của từng Class/Interface (tách biệt Name, Scope, Type của Attribute/Method). - Khi cần tính toán trọng số thiết kế (ArchWeight)
1SKILL.mdUpdated Apr 8, 2026