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:
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:
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:
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!