nguyen-agn/uml-testcase-runner
skills/UML-TestCase-Runner/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add nguyen-agn/uml_comparator uml-testcase-runnerInstall 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 AM51.0s4 files scanned
SKILL.md
- name:
- uml-testcase-runner
- description:
- 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.
SKILL: uml-testcase-runner
Purpose (Mục đích)
Skill này nhận vào một file .drawio bị lỗi có chủ đích, chạy qua pipeline
Builder → ValidateGraph, sau đó so sánh kết quả thực tế với expected
errors. Mục tiêu: đảm bảo hệ thống phát hiện đúng lỗi UML, không bị
false-negative (lỗi có mà không phát hiện) hay false-positive (báo lỗi sai).
Skill này áp dụng tư duy Verification Layer từ Strategy: "Làm sao biết thứ vừa tạo ra là đúng, dùng được, và đáng tin?"
Use When
- Thêm file
.drawiomới vàoUMLs_testcase/incorrect/→ cần verify hệ thống bắt đúng lỗi. - Sửa
ValidateGraph()hoặc Builder → cần chạy lại toàn bộ test incorrect để đảm bảo không có regression. - Viết test case mới cho error code chưa được cover.
- Debug: file UML sinh viên nộp không bị báo lỗi nhưng nghi ngờ có vấn đề.
Required Inputs
- File path: đường dẫn tới file
.drawiocần test - Expected error codes: danh sách
IntegrityError.Codekỳ vọng (xemknowledge.md) - Expected severity:
ERROR(pipeline stop) hoặcWARN(có thể tiếp tục)
Expected Output
TestCase: <filename>
✔ Got error code: <EXPECTED_CODE> [<SEVERITY>]
✔ Pipeline behavior: <STOP|CONTINUE> (correct)
--- OR ---
✘ MISSING expected code: <EXPECTED_CODE>
✘ UNEXPECTED code found: <ACTUAL_CODE>
Execution Approach
- Đọc file
.drawiotừUMLs_testcase/incorrect/<filename> - Chạy
builder.NewStandardModelBuilder().Build(rawXML) - Chạy
domain.ValidateGraph(graph, label) - So sánh actual codes với expected codes từ
testcases.md - Assert: mỗi expected code phải xuất hiện trong actual results
- Log PASS/FAIL theo từng code
Quality Criteria
- Mỗi Error Code phải có ít nhất 1 test case trong
UMLs_testcase/incorrect/ - Test case phải chỉ trigger đúng error code mục tiêu, không trigger thêm ERROR không mong muốn
- WARN test cases có thể build thành công (pipeline không dừng)
- ERROR test cases phải khiến pipeline stop trước khi vào Matcher
Edge Cases
- File
.drawiohoàn toàn rỗng (0 bytes) → Parser trả error trước khi Builder chạy - File XML hợp lệ nhưng không có thẻ
<mxGraphModel>→ Builder trả error - Node có cả
EMPTY_NODE_NAMElẫnINVALID_NODE_TYPEcùng lúc → Cả hai phải được báo
References
knowledge.md: bảng tất cả error codes và cách triggertestcases.md: bảng test cases cụ thể + expected resultscheck.md: checklist tự verification../UMLs_testcase/incorrect/: thư mục chứa các file .drawio lỗi../../domain/validator.go: implementation của ValidateGraph()../../builder/incorrect_uml_test.go: Go test file tự động
Changelog
- v1.0 (2026-03-20): Khởi tạo skill, phủ 9 error/warn codes từ ValidateGraph
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/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
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