Một công cụ phân tích tĩnh đa ngôn ngữ giúp đo lường các chỉ số cyclomatic, nhận thức và cấu trúc để xác định mã có rủi ro cao.
Cài đặt & Tải xuống
1. ClawHub CLI
Cách nhanh nhất để cài đặt kỹ năng trực tiếp từ thư viện.
npx clawhub@latest install code-complexity-analyzer
2. Cài đặt Thủ công
Sao chép thư mục kỹ năng vào một trong những vị trí sau
~/.openclaw/skills/ <project>/skills/ Ưu tiên: Không gian làm việc > Cục bộ > Gói sẵn
3. Cài đặt Prompt
Sao chép prompt này vào OpenClaw để tự động cài đặt.
Giúp tôi cài đặt code-complexity-analyzer bằng Clawhub. Nếu Clawhub chưa
Bạn muốn tải xuống?
Nhận các tệp kỹ năng gốc dưới dạng lưu trữ ZIP.
Trình phân tích độ phức tạp mã nguồn là gì?
Trình phân tích độ phức tạp mã nguồn là một tiện ích mạnh mẽ được thiết kế để duy trì các tiêu chuẩn kỹ thuật cao bằng cách định lượng mức độ khó khăn khi kiểm thử và bảo trì mã. Bằng cách tích hợp công cụ này vào thư viện Openclaw Skills của bạn, các nhà phát triển có thể tự động quét mã nguồn để tìm các cấu trúc lồng nhau sâu, các hàm quá dài và các đường dẫn logic phức tạp dẫn đến nợ kỹ thuật.
Được xây dựng như một công cụ Python thuần túy không có phụ thuộc bên ngoài, nó cung cấp một cách hiệu quả để đánh giá các tệp Python, JavaScript, TypeScript và Go. Nó giúp các nhóm tiến xa hơn việc linting đơn giản bằng cách tập trung vào độ khó nhận thức khi hiểu mã (Độ phức tạp nhận thức) và số lượng các đường dẫn thực thi độc lập (Độ phức tạp Cyclomatic).
Trường hợp sử dụng Trình phân tích độ phức tạp mã nguồn
- Xác định các đối tượng cần cấu trúc lại trong các cơ sở mã cũ bằng cách chỉ ra các hàm có rủi ro cao.
- Thiết lập các rào cản chất lượng CI/CD để ngăn chặn mã quá phức tạp được hợp nhất.
- Tạo các báo cáo độ phức tạp tự động ở định dạng Markdown để xem xét pull request.
- Kiểm tra các phụ thuộc mới hoặc các mô-đun nội bộ về khả năng bảo trì và tính toàn vẹn cấu trúc.
Cách thức hoạt động của Trình phân tích độ phức tạp mã nguồn
- Công cụ phân tích các tệp nguồn đích thành Cây cú pháp trừu tượng (AST) cho ngôn ngữ tương ứng.
- Nó duyệt cây để xác định các định nghĩa hàm và các cấu trúc điều khiển logic như vòng lặp và câu lệnh điều kiện.
- Nó tính toán các chỉ số bao gồm Độ phức tạp Cyclomatic (CC), Độ phức tạp nhận thức (COG) và độ sâu lồng nhau dựa trên cấu trúc.
- Nó so sánh các giá trị này với các ngưỡng có thể cấu hình để xác định mức độ rủi ro (Đơn giản, Thấp, Trung bình hoặc Cao).
- Cuối cùng, nó xuất kết quả ở định dạng văn bản, JSON hoặc Markdown và trả về mã thoát dựa trên trạng thái vi phạm.
Cài đặt Trình phân tích độ phức tạp mã nguồn
Để bắt đầu sử dụng công cụ này với Openclaw Skills của bạn, hãy đảm bảo bạn đã cài đặt Python 3. Không yêu cầu cài đặt pip bổ sung.
# Sao chép hoặc định vị tập lệnh
# Phân tích thư mục nguồn của bạn
python3 scripts/analyze_complexity.py src/
# Chạy với các ngưỡng tùy chỉnh để có rào cản CI nghiêm ngặt hơn
python3 scripts/analyze_complexity.py src/ --cc 8 --cog 12
Lược đồ dữ liệu & Hệ thống phân loại của Trình phân tích độ phức tạp mã nguồn
Trình phân tích tổ chức các phát hiện của nó dựa trên mức độ chi tiết của hàm. Nó theo dõi phân loại sau cho mỗi tệp được phân tích:
| Chỉ số | Mô tả | Chỉ số phụ |
|---|---|---|
| CC | Độ phức tạp Cyclomatic | Đường dẫn logic |
| COG | Độ phức tạp nhận thức | Điểm khả năng đọc |
| Lines | Độ dài hàm | Quy mô dọc |
| Params | Số lượng tham số | Bề mặt giao diện |
| Nesting | Độ sâu tối đa | Thụt lề logic |
Kết quả đầu ra có thể được xuất dưới dạng đối tượng JSON có cấu trúc để tích hợp vào các quy trình làm việc Openclaw Skills khác.
Tính năng Nâng cao của Trình phân tích độ phức tạp mã nguồn
- Hỗ trợ đầu ra đa định dạng (JSON, Markdown, Text) để tích hợp công cụ liền mạch.
- Ánh xạ mức độ rủi ro có thể cấu hình để phân biệt giữa nợ kỹ thuật nhỏ và các mối nguy hiểm nghiêm trọng.
- Tự động loại trừ các thư mục phổ biến như node_modules và pycache.
- Chế độ Verbose để minh bạch hoàn toàn về tất cả các hàm, không chỉ những hàm vi phạm ngưỡng.
- Mã thoát tiêu chuẩn hóa (0, 1, 2) để dễ dàng tích hợp vào các tập lệnh shell và quy trình tự động hóa.
SKILL.md
Đang tải
Các kỹ năng Openclaw liên quan
Mockup Video Generator Free
Một AI agent skill chuyên dụng tự động chuyển đổi ảnh chụp màn hình ứng dụng tĩnh và hình ảnh thành video mockup điện thoại chân thực, chất lượng cao.
Bun Workspace Optimizer
Một công cụ kiểm tra hiệu suất chuyên dụng cho các monorepo dựa trên Bun nhằm loại bỏ sự phình to của phụ thuộc và tăng tốc đường ống xây dựng.
GitCode API SDK
Một Python SDK mạnh mẽ và bộ công cụ tự động hóa để tương tác với các tài nguyên GitCode REST bằng cách sử dụng các máy khách đồng bộ và không đồng bộ.
Capacity Planner
Capacity Planner cung cấp dự báo hạ tầng dựa trên dữ liệu để ngăn ngừa sự cố và tối ưu hóa chi phí đám mây thông qua phân tích các chỉ số lịch sử.
Accessibility Scanner
Một công cụ kiểm tra tự động và thủ công nhằm đảm bảo các ứng dụng web đáp ứng các tiêu chuẩn tiếp cận WCAG 2.2 và các nguyên tắc thiết kế bao trùm.
Dagster Pipeline Analyzer
Một công cụ chẩn đoán toàn diện để kiểm tra các tài sản được định nghĩa bằng phần mềm Dagster, chiến lược phân vùng và độ tin cậy của pipeline.
Đặc sắc*
