Một công cụ Python không phụ thuộc để phân tích chuyên sâu codebase, đo lường độ phức tạp, phân bổ ngôn ngữ và các chỉ số nợ kỹ thuật.
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 codebase-stats
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 codebase-stats 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.
Codebase Stats là gì?
Codebase Stats là một tiện ích phân tích hiệu suất cao được thiết kế để cung cấp cho các nhà phát triển và đại lý AI cái nhìn toàn diện về sức khỏe và quy mô của một dự án. Là một phần cốt lõi của thư viện Openclaw Skills, nó cung cấp giải pháp không phụ thuộc để kiểm tra chất lượng mã, đếm số dòng mã (LOC) và xác định nợ kỹ thuật trên hơn 40 ngôn ngữ lập trình.
Bằng cách tận dụng kỹ năng này, các nhóm có thể có được thông tin chi tiết ngay lập tức về kiến trúc phần mềm của họ, từ ước tính độ phức tạp cyclomatic đến tỷ lệ mã trên nhận xét. Cho dù bạn đang thực hiện kiểm tra quy mô dự án nhanh chóng hay tích hợp các chỉ số vào quy trình CI/CD, công cụ này đều cung cấp dữ liệu có thể thực thi ở cả định dạng Markdown dễ đọc và JSON có thể phân tích bằng máy.
Trường hợp sử dụng Codebase Stats
- Thực hiện kiểm tra toàn diện về chất lượng mã và các tín hiệu nợ kỹ thuật như TODO và FIXME.
- Tạo báo cáo phân bổ ngôn ngữ để hiểu ngăn xếp công nghệ của một kho lưu trữ mới.
- Đo lường độ phức tạp cyclomatic để xác định các hàm có rủi ro cao cần cấu trúc lại.
- Tính toán quy mô dự án và số dòng mã cho tài liệu hoặc lập kế hoạch sprint.
- Kiểm tra số lượng phụ thuộc trên các trình quản lý gói khác nhau như npm, pip và Cargo.
Cách thức hoạt động của Codebase Stats
- Người dùng hoặc đại lý AI kích hoạt kỹ năng bằng cách chỉ định đường dẫn thư mục đích và các bộ lọc tùy chọn.
- Tập lệnh thực hiện quét đệ quy hệ thống tệp, xác định hơn 40 phần mở rộng tệp được hỗ trợ.
- Nó phân tích từng tệp để phân biệt giữa mã thô, nhận xét và các dòng trống trong khi gắn cờ các dấu hiệu nợ kỹ thuật.
- Các phương pháp phỏng đoán độ phức tạp được áp dụng cho các hàm và phương thức để ước tính độ phức tạp cyclomatic.
- Công cụ tổng hợp các chỉ số thành một báo cáo có cấu trúc dựa trên định dạng được yêu cầu (Markdown, JSON hoặc console).
- Đầu ra cuối cùng được trả về hoặc lưu vào một tệp, cung cấp ảnh chụp nhanh về sức khỏe của codebase.
Cài đặt Codebase Stats
Để bắt đầu sử dụng thành phần Openclaw Skills này, hãy đảm bảo bạn đã cài đặt Python 3. Không yêu cầu phụ thuộc bên ngoài.
# Di chuyển đến thư mục tập lệnh của bạn
cd scripts/
# Phân tích thư mục hiện tại với cài đặt mặc định
python3 codebase_stats.py
# Phân tích một dự án cụ thể và xuất báo cáo Markdown
python3 codebase_stats.py /path/to/project --format markdown --output report.md
Lược đồ dữ liệu & Hệ thống phân loại của Codebase Stats
Kỹ năng tổ chức dữ liệu phân tích thành các danh mục cụ thể để báo cáo chi tiết:
| Danh mục | Chỉ số được theo dõi |
|---|---|
| Quy mô | Tổng số tệp, dòng mã, dòng nhận xét, dòng trống, số dòng trên mỗi tệp |
| Ngôn ngữ | Tỷ lệ phân bổ theo số dòng và số lượng tệp |
| Độ phức tạp | Ước tính độ phức tạp cyclomatic và xác định 10 hàm phức tạp hàng đầu |
| Nợ kỹ thuật | Số lượng cho các thẻ cụ thể: TODO, FIXME, HACK và XXX |
| Hệ sinh thái | Số lượng phụ thuộc từ các tệp gói (package.json, requirements.txt, v.v.) |
| Tệp lớn | Danh sách xếp hạng các tệp lớn nhất trong kho lưu trữ |
Tính năng Nâng cao của Codebase Stats
- Hỗ trợ đầu ra đa định dạng bao gồm JSON để tích hợp liền mạch với bảng điều khiển CI/CD.
- Lọc theo ngôn ngữ cụ thể để tách biệt các chỉ số cho một phần duy nhất của codebase đa ngôn ngữ.
- Quét sâu các tín hiệu nợ kỹ thuật để tự động hóa việc kiểm tra chất lượng mã.
- Khả năng tương thích đa nền tảng dưới dạng tập lệnh Python thuần túy không yêu cầu thư viện bên ngoài.
- Hỗ trợ các ngôn ngữ chuyên biệt và tệp cấu hình bao gồm Terraform, Protobuf và Solidity.
SKILL.md
Đang tải
Các kỹ năng Openclaw liên quan
Text to Video Hunyuan
Text to Video Hunyuan là một công cụ tạo AI mạnh mẽ giúp chuyển đổi các câu lệnh văn bản mô tả thành các đoạn video 1080p chất lượng cao chỉ trong vài phút.
API Contract Tester
Một bộ thử nghiệm toàn diện để xác thực hợp đồng API, đảm bảo khả năng tương thích ngược và phát hiện các thay đổi gây lỗi trong microservices.
Cache Strategy Advisor
Một hệ thống chuyên gia toàn diện để phân tích các mẫu truy cập dữ liệu và triển khai kiến trúc bộ nhớ đệm đa lớp.
Canary Deployment Analyzer
Một tiện ích DevOps thông minh để so sánh các chỉ số canary và baseline nhằm cung cấp các khuyến nghị thúc đẩy hoặc hoàn tác triển khai dựa trên dữ liệu.
CI Build Cache Advisor
Một công cụ tối ưu hóa thông minh được thiết kế để phân tích cấu hình CI/CD và triển khai các chiến lược bộ nhớ đệm hiệu suất cao nhằm cắt giảm đáng kể thời gian build.
Babel Config Validator
Một công cụ lint và xác thực toàn diện cho các tệp cấu hình Babel nhằm đảm bảo tính ổn định của bản dựng và các tiêu chuẩn chuyển đổi mã hiện đại.
Đặc sắc*
