nguyen-agn/skills/Matcher-AI-Context
skills/Matcher-AI-Context/SKILL.md
# SKILL: entity-matcher ## Purpose So khớp các Entity (Class/Interface/Enum) giữa `ProcessedUMLGraph` của Đáp án và của Sinh viên để tạo ra `MappingTable`. Nhờ có dữ liệu đã tiền xử lý, Matcher sử dụng cấu trúc `ArchWeight` kết hợp với Fuzzy Text Matching để đưa ra các quyết định nối (map) chính xác nhất, ngay cả khi tên bị sai chính tả hoặc gõ tắt. ## Use When - Sau khi `Prematcher` đã sinh ra 2 cây `ProcessedUMLGraph` với `ArchWeight` đầy đủ. - Cần dóng hàng các Node trước khi đưa qua `Compa
$ install --global
skillsauthnpx skillsauth add nguyen-agn/uml_comparator skills/Matcher-AI-ContextInstall 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:08 AM49.2s5 files scanned
SKILL.md
SKILL: entity-matcher
Purpose
So khớp các Entity (Class/Interface/Enum) giữa ProcessedUMLGraph của Đáp án và của Sinh viên để tạo ra MappingTable. Nhờ có dữ liệu đã tiền xử lý, Matcher sử dụng cấu trúc ArchWeight kết hợp với Fuzzy Text Matching để đưa ra các quyết định nối (map) chính xác nhất, ngay cả khi tên bị sai chính tả hoặc gõ tắt.
Use When
- Sau khi
Prematcherđã sinh ra 2 câyProcessedUMLGraphvớiArchWeightđầy đủ. - Cần dóng hàng các Node trước khi đưa qua
Comparatorchấm điểm chi tiết.
Required Inputs
solution *domain.ProcessedUMLGraph: Graph mẫu (read-only).student *domain.ProcessedUMLGraph: Graph sinh viên (read-only).
Expected Output
domain.MappingTable: Dictionary Map từSolution Node ID -> Student Node ID.
Execution Approach
Thuật toán dựa trên 2 trụ cột: Kiến trúc (ArchWeight) và Văn bản (FuzzyMatch).
- FuzzyMatch Submodule: Việc so sánh Text phải được decouple ra một Interface riêng (
IFuzzyMatcher). - Architecture First (Unpack & Tolerance): Thay vì trừ thẳng số nguyên,
ArchWeightđược bung ra thànhArchTraits. Các class được xem là "Kiến trúc tương tự" nếu giống hệt các đặc tính cấu trúc lõi (Loại class, Kế thừa, Intf, CustomType) và lệch không quá 15% số lượng (Method, Attribute, Rels, Static). - FuzzyScore làm Tie-breaker: Gom tất cả các node đạt chuẩn "Kiến trúc tương tự" lên top đầu, rồi xếp hạng bên trong bằng độ giống tên
FuzzyScore. Node có tên khớp nhất nhưng chung kiến trúc sẽ được chọn.
Quality Criteria
- Module
matchertuyệt đối không thay đổi data bên trong input pointers. - Kết quả trả về không bao giờ có chuyện 1 node Solution trỏ tới 2 node Student (phải map 1-1).
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/SOLID & Unit Test Refactoring
development
VerifiedTrustedCommunity
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.
1SKILL.mdUpdated Apr 8, 2026