Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:retro

Tổng kết từ lịch sử Git

Tạo retrospective kỹ thuật khách quan từ lịch sử git: velocity, churn, điểm nóng, hoạt động tác giả, hoàn thành plan, so sánh và HTML trực quan tùy chọn.

Phân tích khung thời gian

Thu thập chỉ số git thô

Tính chỉ số dẫn xuất

Kiểm tra thư mục plans

Nguyên tắc 01

Chỉ số khách quan tốt hơn kể chuyện phỏng đoán

Nguyên tắc 02

N/A là đúng khi thiếu dữ liệu hoặc công cụ

Nguyên tắc 03

Khuyến nghị phải dựa vào hotspot, churn, test ratio hoặc phân bố hoạt động thật

Nguyên tắc 04

HTML trực quan chỉ là lớp thêm; Markdown vẫn là mặc định

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

Khởi động

Đầu vào, phạm vi, route

1 Phân tích khung thời gian Chuyển 7d, 2w, 1m, sprint hoặc YYYY-MM-DD:YYYY-MM-DD thành SINCE/UNTIL, và tính giai đoạn trước có độ dài bằng nhau khi có `--compare`.
2 Thu thập chỉ số git thô Chạy lệnh git để lấy commit, LOC thêm/xóa/ròng, hotspot, loại conventional commit, tác giả, ngày hoạt động, file duy nhất, thay đổi test và số commit theo tác giả khi có `--team`.

Xử lý

Agent / skill thực thi

3 Tính chỉ số dẫn xuất Tính commit frequency, test-to-code ratio, churn rate, active-day ratio và tỷ lệ hoàn thành plan từ GitHub issue khi có dữ liệu gh, đồng thời nêu công thức trong báo cáo.
4 Kiểm tra thư mục plans Quét các file Markdown plan được cập nhật trong giai đoạn và đếm checkbox đã xong so với còn mở cho phần hoàn thành plan.

Kiểm chứng

Gate, review, xác thực

5 Tạo báo cáo Điền template báo cáo bằng giá trị thật trong bảng, N/A khi thiếu dữ liệu, điểm nổi bật, 3–5 khuyến nghị cụ thể và delta so sánh khi được yêu cầu.
6 Xuất HTML tùy chọn Mặc định lưu Markdown; khi có `--format html`, ghi báo cáo HTML tự chứa và áp dụng tùy chọn trực quan hoặc các flag tắt được truyền trong lệnh.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:retro [timeframe] [--compare] [--team] [--format html|md] [--no-antv|--no-diagram-design|--no-editorial-visuals]

Đối số

[timeframe]

Khung thời gian

Giai đoạn cần phân tích. Nhận 7d, 2w, 1m, sprint hoặc YYYY-MM-DD:YYYY-MM-DD; mặc định là 7d, và sprint sẽ hỏi ngày bắt đầu khi tag không xác định được.

/ak:retro 2026-07-15:2026-07-28

Option dùng chung

--compare

So sánh giai đoạn

Thêm giai đoạn liền trước có độ dài bằng nhau và cột delta. Không tạo delta khi cửa sổ trước không có dữ liệu.

/ak:retro 2w --compare

--team

Phân tích theo tác giả

Thêm số commit theo tác giả và tín hiệu velocity của đội từ lịch sử email Git; cần xem xét riêng tư trước khi chia sẻ.

/ak:retro sprint --team

--format html|md

Định dạng báo cáo

Chọn output Markdown hoặc HTML tự chứa. HTML dùng CSS inline và có thể thêm lớp trực quan biên tập bổ sung.

/ak:retro 1m --format html

--no-antv

Không dùng visual AntV

Tắt các panel AntV tùy chọn cho output HTML. Output Markdown không đổi.

/ak:retro 1m --format html --no-antv

--no-diagram-design

Không dùng diagram design

Tắt treatment diagram-design tùy chọn cho timeline, hotspot hoặc radar trong HTML.

/ak:retro 1m --format html --no-diagram-design

--no-editorial-visuals

Không dùng visual biên tập

Tắt toàn bộ lớp trực quan biên tập bổ sung cho lần chạy HTML này; bảng chỉ số và công thức vẫn hiển thị.

/ak:retro 1m --format html --no-editorial-visuals

Mode / route nên dùng

default

Retro giai đoạn hiện tại

Nghiên cứu:: Git history for one timeframe
Review:: None
Xác thực:: All cells real or N/A

--compare

So sánh delta

Nghiên cứu:: Adds preceding equal-length period
Review:: None
Xác thực:: Delta column for velocity and health

--team

Phân tích theo tác giả

Nghiên cứu:: Per-author commit counts
Review:: None
Xác thực:: Team velocity signals

--format html|md

Định dạng đầu ra

Nghiên cứu:: Same metrics
Review:: None
Xác thực:: Self-contained HTML or Markdown

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Retro git hằng tuần Khuyến nghị

/ak:retro 7d

Dùng khi:: Dùng để tóm tắt lịch sử kỹ thuật gần đây từ hoạt động git cho repo cá nhân hoặc repo đội.
Kết quả:: Tạo báo cáo Markdown mặc định trong plans/reports với velocity, churn, hotspot, hoạt động, tỷ lệ test, công thức, điểm nổi bật và khuyến nghị dựa trên git; dữ liệu thiếu giữ N/A.

So sánh sprint theo tác giả

/ak:retro sprint --compare --team

Dùng khi:: Dùng cho sprint review cần delta từ lịch sử git so với giai đoạn trước có độ dài bằng nhau và hoạt động theo từng tác giả.
Kết quả:: Xác định khung thời gian sprint, hỏi ngày bắt đầu nếu cần, so sánh với giai đoạn trước, thêm delta velocity và sức khỏe, đồng thời đưa số commit theo tác giả mà không bịa dữ liệu thiếu.

Báo cáo HTML hằng tháng

/ak:retro 1m --format html

Dùng khi:: Dùng khi cần chia sẻ lịch sử kỹ thuật dưới dạng retrospective HTML độc lập với lớp trực quan bổ sung của skill.
Kết quả:: Ghi plans/reports/retro-{YYMMDD}-1m.html dưới dạng báo cáo tự chứa với CSS inline, bảng chỉ số thật, công thức, khuyến nghị và trực quan biên tập theo cấu hình khi được bật.

Audit theo khoảng ngày

/ak:retro 2026-08-01:2026-08-15 --format md

Dùng khi:: Dùng để tóm tắt lịch sử kỹ thuật từ hoạt động git trong một khoảng release, sự cố hoặc mốc cụ thể.
Kết quả:: Dùng đúng ngày SINCE và UNTIL đã nêu, chỉ thu thập dữ kiện git và plan trong khoảng đó, tính chỉ số sức khỏe dẫn xuất và lưu báo cáo Markdown với N/A cho dữ liệu issue không có.

Phạm vi xử lý

Phân tích khung thời gian
Thu thập chỉ số git thô
Tính chỉ số dẫn xuất
Kiểm tra thư mục plans
Tạo báo cáo
Xuất HTML tùy chọn

Artifact tạo ra

Báo cáo retro

Mẫu đường dẫn

plans/reports/retro-{YYMMDD}-{slug}.md hoặc .html

Báo cáo retrospective dưới 200 dòng, có chỉ số, công thức, điểm nổi bật, khuyến nghị và phần trực quan tùy chọn.