Tóm tắt nhanh:
ak-retrobiến lịch sử git của một khoảng thời gian thành một báo cáo retro có số liệu thật và 3 đến 5 khuyến nghị. Nó không chuyển cho skill tiếp theo mà dừng ở báo cáo; chỉ khi bạn chọn HTML thì nó nhờak-frontend-designvàak-diagramdựng trang. Nó chỉ đọc repo, không commit, không sửa code và không đoán số.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi hết sprint, hết tuần hay hết quý, bạn muốn nhìn lại nhóm đã làm được gì mà không phải đếm tay. Báo cáo có Velocity, Code Health, phân bố loại commit, file hay bị sửa nhất, tiến độ plan, Highlights và Recommendations. Mỗi chỉ số dẫn xuất đều kèm công thức để bạn tự kiểm lại.
flowchart LR
A["Lịch sử git của một kỳ"] --> B["ak-retro"]
P["plans/ và gh nếu có"] --> B
B --> C["Báo cáo retro .md"]
B --> D["Trang HTML với --format html"]
C --> E["Dừng, bạn đọc và quyết định"]
D --> EBốn ý cốt lõi của skill:
| Ý chính | Câu hỏi | Ví dụ |
|---|---|---|
| Khoảng thời gian | Báo cáo tính từ lúc nào tới lúc nào? | Mặc định 7 ngày; 2w, 1m, hoặc 2026-07-01:2026-09-30 |
| N/A thay cho số đoán | Thiếu dữ liệu thì báo cáo ghi gì? | Không có gh thì ghi N/A; git lỗi không thành 0 commit |
| Chỉ số mô tả, không chấm điểm | Số commit, số dòng code nói lên điều gì? | Churn trên 3 lần là điểm để bàn, không đo năng suất ai |
| Một lần chụp lịch sử | Số liệu lấy từ bản lịch sử nào? | Ghi revision HEAD, clone nông hay không, lọc theo ngày committer |
Lưu ý quan trọng nhất: số liệu chỉ là tín hiệu mô tả. Tỉ lệ test-to-code đếm theo tên file, không phải độ phủ test, và bảng --team không phải bảng xếp hạng.
Prompt mẫu cho nhìn lại tuần qua:
/ak-retro 7dĐối số đầu tiên là khoảng thời gian: 7d (mặc định), 2w, 1m, sprint hoặc YYYY-MM-DD:YYYY-MM-DD. Các cờ:
| Cờ | Để làm gì | Từ ak |
|---|---|---|
--compare | So với kỳ liền trước | 1.0.0 |
--team | Tách chỉ số theo từng tác giả | 1.0.0 |
--format html|md | Chọn định dạng báo cáo | 1.0.0 |
--no-antv, --no-diagram-design, --no-editorial-visuals | Tắt hình minh hoạ trong trang HTML | 2.13.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 4 tình huống kèm prompt, giải thích từng cờ (dùng khi, không cần khi, nhận lại gì), lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-retro: biến lịch sử git thành báo cáo retro" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-retro". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-retro
