--json Bằng chứng có cấu trúc
Xuất bằng chứng có cấu trúc cho bản bàn giao. Tùy chọn này không làm mới remote ref.
/ak:watzup --json Ctrl K
Tóm tắt nhanh / Lệnh
Bộ Engineer
/ak:watzup
Bàn giao trạng thái dự án
Tạo báo cáo bàn giao ngắn có bằng chứng từ Git ref, worktree, plan chưa xong và roadmap, kèm bước tiếp theo ưu tiên và lý do.
01
Chạy scanner
02
Đọc trạng thái
03
Tóm tắt việc
04
Đo tiến độ plan
Nguyên tắc 01
Chỉ trạng thái và bàn giao; không biến wrap-up thành triển khai.
Nguyên tắc 02
Tóm tắt có bằng chứng tốt hơn liệt kê tràn lan branch.
Nguyên tắc 03
Bước tiếp theo theo ưu tiên phải nói rõ vì sao nó đứng trước lựa chọn khác.
Nguyên tắc 04
Không giả vờ full scan thành công khi thực ra chỉ dùng cách dự phòng.
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.
01
Khởi động
Đầu vào, phạm vi, route
- 1 Chạy scanner Từ root dự án, chạy scripts/watzup-scan.cjs với JSON output trước khi viết báo cáo.
- 2 Đọc trạng thái Ghi nhận branch hoặc detached HEAD, trạng thái dirty/clean, worktree đang dùng và cảnh báo của scanner.
02
Xử lý
Agent / skill thực thi
- 3 Tóm tắt việc Chỉ chọn branch và worktree gần đây có tín hiệu cao nhất, không đổ toàn bộ ref vào báo cáo.
- 4 Đo tiến độ plan Liệt kê plan chưa xong với số checkbox X/Y và phần trăm hoàn thành từ plan.md và các phase file.
03
Kiểm chứng
Gate, review, xác thực
- 5 Quét roadmap Đưa các milestone đang active từ tài liệu roadmap hoặc milestone vào báo cáo khi có.
- 6 Xếp bước tiếp Dựa vào priority, rationale, worktree/branch hiện tại, trạng thái, nguồn dữ liệu và đà tiến độ từ nextSteps của scanner.
04
Đóng
Báo cáo, bàn giao, artifact
- 7 Cảnh báo thật Nêu rõ remote có thể cũ, detached HEAD, trạng thái dirty và lỗi scanner thay vì che giấu độ bất định.
- 8 Dự phòng chỉ đọc Nếu scanner lỗi, nói rõ rồi dùng các lệnh đọc tối thiểu để xem Git, worktree, plan và roadmap.
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:watzup [--json] [--fetch] [--since <date>] [--max-branches <n>] [--plan-limit <n>] [--max-plan-refs <n>] [--redact-paths]Option dùng chung
--fetch Làm mới remote
Chạy git fetch --all --prune trước khi quét. Tùy chọn này liên hệ remote đã cấu hình và cập nhật/prune remote-tracking ref local; bỏ qua để dùng báo cáo mặc định chỉ đọc local.
/ak:watzup --fetch--since <date> Khoảng lấy mẫu commit
Giới hạn commit được lấy mẫu trên mỗi branch. Tùy chọn này không giới hạn discovery plan hoặc roadmap.
/ak:watzup --since 2026-08-01--max-branches <n> Giới hạn tóm tắt branch
Giới hạn số branch được tóm tắt. Các branch bị bỏ qua vẫn tồn tại.
/ak:watzup --max-branches 20--plan-limit <n> Giới hạn plan trong output ngắn
Giới hạn số plan chưa xong đưa vào output ngắn. Điều này không chứng minh các plan bị loại đã hoàn tất.
/ak:watzup --plan-limit 8--max-plan-refs <n> Giới hạn ref plan tracked
Giới hạn số ref đã xếp hạng được kiểm tra để tìm plan file tracked. Warning sẽ ghi lại việc cắt bớt.
/ak:watzup --max-plan-refs 40--redact-paths Che đường dẫn tuyệt đối
Thay đường dẫn tuyệt đối bằng nhãn ổn định. Tùy chọn này không che tên branch, tiêu đề commit hoặc nội dung tài liệu.
/ak:watzup --redact-pathsTính năng đặc biệt
Vệ sinh repo ưu tiên trước
Worktree dirty và detached HEAD được xếp trước roadmap vì chúng dễ làm mất ngữ cảnh.
Mặc định không network
Remote refs chỉ dùng bản local trừ khi người dùng yêu cầu làm mới trạng thái remote.
Không phải nén hội thoại
Dùng ak-handoff khi agent mới cần quyết định, lý do và ngữ cảnh hội thoại.
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ế.
Bàn giao cuối phiên Khuyến nghị
/ak:watzup- Dùng khi:
- Cần snapshot local ngắn về việc đang dở và bước tiếp theo.
- Kết quả:
- Chạy JSON scanner, báo branch hoặc detached HEAD, dirty state, plan đang dở với tiến độ checkbox, bước tiếp theo theo ưu tiên và warning.
Làm mới remote ref trước
/ak:watzup--fetch
- Dùng khi:
- Bạn cho phép làm mới remote trước báo cáo vì remote-tracking ref local có thể đã cũ.
- Kết quả:
- Chạy scanner có fetch, rồi tách bằng chứng ref mới khỏi trạng thái checkout, plan, milestone roadmap, bước tiếp theo và warning.
Định hướng trong worktree mới
/ak:watzup- Dùng khi:
- Vừa vào worktree hoặc checkout tách và cần nắm tình hình local nhanh.
- Kết quả:
- Nêu worktree hiện tại, branch hoặc detached commit, việc vệ sinh dirty tree hoặc detached HEAD, plan chưa xong và hành động ưu tiên cao nhất.
Quét plan qua branch
/ak:watzup- Dùng khi:
- Muốn kiểm tra worktree hiển thị và tracked ref để tìm plan chưa xong cùng tiến độ checklist.
- Kết quả:
- Khử trùng lặp bằng chứng plan từ worktree và ref, đếm checkbox trong plan.md cùng phase file, rồi xếp bước tiếp theo theo trạng thái, độ khớp, nguồn và đà tiến độ.
Phạm vi xử lý
- Chạy scanner
- Đọc trạng thái
- Tóm tắt việc
- Đo tiến độ plan
- Quét roadmap
- Xếp bước tiếp
Artifact tạo ra
Báo cáo bàn giao ngắn
Mẫu đường dẫn
Trạng thái hiện tại → Việc gần đây → Plan → Roadmap → Bước tiếp → Cảnh báo Trạng thái ngắn có chú thích tiến độ và năm đến sáu hành động theo thứ tự ưu tiên.