Code Standards

Jump to bottom

Augenter edited this page Apr 4, 2026 · 1 revision

💻 Tiêu chuẩn Code / Coding Standards

Pilo Masterkit áp đặt một bộ tiêu chuẩn code khắt khe thông qua các lệnh review chuyên sâu, biến AI Assistant thành một "AI Task Force" có kỷ luật.

1. Nguyên tắc chung

Sạch và Rõ ràng (Clean Code): Mã nguồn phải dễ đọc, dễ bảo trì và tuân thủ nguyên tắc SOLID.
Test-Driven Development (TDD): Khuyến khích viết test trước khi viết logic thông qua lệnh /tdd.
Tài liệu hóa: Mọi hàm và module phức tạp đều phải có comment giải thích rõ ràng.

2. Tiêu chuẩn theo ngôn ngữ (Language-Specific Standards)

AI Agent được trang bị các lệnh review đặc thù để đảm bảo code tuân thủ "idiomatic conventions" của từng ngôn ngữ:

Python (/python-review): Tuân thủ PEP 8, sử dụng type hints, kiểm tra bảo mật cơ bản.
Rust (/rust-review): Kiểm tra ownership, lifetimes, hạn chế tối đa khối lệnh unsafe.
Go (/go-review): Xử lý lỗi chuẩn mực, kiểm tra race conditions trong goroutines.
C++ (/cpp-review): Quản lý bộ nhớ an toàn, ưu tiên sử dụng Modern C++ (C++11/14/17/20).
TypeScript/JavaScript: Sử dụng strict mode, định nghĩa interface rõ ràng, tránh any.

3. Quy trình Review Code

Sử dụng lệnh /code-review để AI Agent thực hiện:

Phân tích độ phức tạp (Cyclomatic Complexity).
Tìm kiếm các lỗi logic tiềm ẩn.
Đề xuất refactor để tối ưu hiệu năng và khả năng đọc.

⬅️ Trước: Kiến trúc / Architecture | Tiếp theo: Bảo mật / Security ➡️

Created with ❤️ by Arter2507 and AI Collaborators