Spaces:
Running
Running
|
Download progress-tracker/README.md from taskpilot952476/taskpilot: direct link, hf CLI and curl.
- Browser
- Download file 3.15 kB
-
https://huggingface.co/spaces/taskpilot952476/taskpilot/resolve/main/progress-tracker/README.md
- Command line
-
hf download hf://spaces/taskpilot952476/taskpilot/progress-tracker/README.md
-
curl -L -o README.md https://huggingface.co/spaces/taskpilot952476/taskpilot/resolve/main/progress-tracker/README.md
3.15 kB
| # TaskPilot Bi-Weekly Progress Tracker Package | |
| Gói công cụ và thư mục quản lý tiến độ thực hiện Đồ án 2 (SE121 - UIT). | |
| Tự động hóa theo dõi, ghi nhận mốc thời gian, phân tích ý nghĩa/tác dụng kỹ thuật và xuất báo cáo tiến độ 2 tuần một lần gửi Giảng viên hướng dẫn. | |
| --- | |
| ## 📁 Cấu trúc thư mục (Directory Structure) | |
| ``` | |
| progress-tracker/ | |
| ├── README.md # Tài liệu hướng dẫn sử dụng gói | |
| ├── PROGRESS_INDEX.md # Bảng mục lục tổng hợp tiến độ toàn bộ các đợt | |
| ├── templates/ | |
| │ └── biweekly-progress-template.md # Biểu mẫu báo cáo chuẩn theo mẫu Đồ án UIT | |
| ├── logs/ | |
| │ ├── period-2026-w35-w36.md # Báo cáo chi tiết đợt 1 (Tuần 35-36) | |
| │ └── template.md # Biểu mẫu trắng để nhân bản cho kỳ mới | |
| └── scripts/ | |
| ├── generate_biweekly_report.py# Tool tự động quét Git commit 3 repos & xuất báo cáo | |
| └── log_milestone.py # Tool CLI ghi nhanh công việc vừa hoàn thành | |
| ``` | |
| --- | |
| ## 🚀 Hướng Dẫn Sử Dụng | |
| ### 1. Ghi nhận nhanh một công việc vừa hoàn thành (Quick Milestone Logging) | |
| Khi bạn hoặc AI Agent vừa hoàn thành một đợt refactor, viết xong tính năng, hoặc sửa lỗi: | |
| ```bash | |
| python3 progress-tracker/scripts/log_milestone.py \ | |
| --period "2026-W35-W36" \ | |
| --task "Refactor Backend Controllers using ApiResponse helpers" \ | |
| --category "BE" \ | |
| --impact "Loại bỏ 397 dòng boilerplate, chuẩn hóa mã HTTP response, tăng tốc độ bảo trì" \ | |
| --metrics "-397 LOC, 100% test pass" | |
| ``` | |
| ### 2. Tự động quét Git commits và xuất dự thảo báo cáo 2 tuần (Auto-generate Bi-Weekly Report) | |
| Vào ngày cuối của chu kỳ 2 tuần, chạy lệnh: | |
| ```bash | |
| python3 progress-tracker/scripts/generate_biweekly_report.py \ | |
| --period "2026-W35-W36" \ | |
| --start-date "2026-08-25" \ | |
| --end-date "2026-09-08" | |
| ``` | |
| Script sẽ tự động: | |
| - Đọc git log từ cả 3 kho mã: `taskpilot` (Backend), `taskpilot-frontend` (Frontend), và `report` (Báo cáo). | |
| - Phân loại commit (`refactor`, `feat`, `fix`, `docs`, `test`, `chore`). | |
| - Thống kê tổng số dòng code thêm (+), bớt (-), tính toán LOC tối ưu. | |
| - Điền sẵn vào mẫu báo cáo tại `progress-tracker/logs/period-YYYY-Wxx-Wyy.md`. | |
| ### 3. Cập nhật Bảng tổng quan tiến độ (Master Index) | |
| Mỗi đợt báo cáo mới sẽ được ghi một dòng vào `PROGRESS_INDEX.md` để theo dõi xuyên suốt từ đầu kỳ (01/09/2026) đến cuối kỳ (01/01/2027). | |
| ### 4. Đồng bộ lên GitHub | |
| Gói công cụ này được thiết kế để nằm trực tiếp trong kho mã nguồn Git (`taskpilot` và `report`), bạn chỉ cần chạy: | |
| ```bash | |
| git add progress-tracker/ .agents/skills/biweekly-progress-tracker/ | |
| git commit -m "docs(progress): update bi-weekly progress logs" | |
| git push origin main | |
| ``` | |
| Toàn bộ lịch sử tiến độ sẽ được lưu trữ an toàn trên GitHub! | |