Tóm tắt nhanh / Lệnh

Bộ Marketing

/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. 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. 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

  1. 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.
  2. 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

  1. 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ó.
  2. 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

  1. 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.
  2. 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 [branch|worktree|status]

Đối số

[branch|worktree|status]

Trọng tâm trạng thái

Trọng tâm bàn giao tùy chọn: branch hiện tại hoặc đã nêu, worktree đang dùng, hoặc trạng thái checkout tổng. Bỏ qua để quét local mặc định. Flag helper của scanner ở lại scanner, không lên slash command này.

/ak:watzup status

Subcommand

branch Trọng tâm branch
/ak:watzup branch

Tóm tắt branch hiện tại hoặc có tín hiệu cao nhất, không đổ mọi ref.

Kết quả: Trạng thái hiện tại theo branch, việc gần đây, plan chưa xong, bước tiếp theo đã xếp hạng và cảnh báo.

/ak:watzup branch
worktree Trọng tâm worktree
/ak:watzup worktree

Định hướng quanh worktree đang dùng, vệ sinh dirty hoặc detached, và plan nhìn thấy ở đó.

Kết quả: Path worktree đang dùng, branch hoặc detached HEAD, vệ sinh dirty-state, plan đang dở và hành động ưu tiên cao nhất.

/ak:watzup worktree
status Trọng tâm trạng thái
/ak:watzup status

Báo trạng thái checkout tổng: branch hoặc detached HEAD, dirty/clean, plan, roadmap và cảnh báo.

Kết quả: Bàn giao trạng thái chỉ local với tiến độ checkbox, bước tiếp theo đã xếp hạng và cảnh báo scanner hoặc fallback trung thực.

/ak:watzup status

Tí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 local, 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, không bịa slash flag.
Trọng tâm branch
/ak:watzup branch
Dùng khi:
Muốn câu chuyện branch có tín hiệu cao nhất thay vì mọi ref trong repo.
Kết quả:
Tập trung bàn giao vào branch hiện tại hoặc có tín hiệu cao nhất, đếm checkbox plan chưa xong, và xếp bước tiếp theo kèm lý do thay vì đổ mọi ref.
Định hướng worktree
/ak:watzup worktree
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.
Trạng thái checkout
/ak:watzup status
Dùng khi:
Cần trạng thái checkout tổng, tiến độ plan và cảnh báo trung thực mà không fetch remote.
Kết quả:
Báo trạng thái checkout chỉ local, tiến độ checkbox plan.md cùng phase, milestone roadmap nếu có, bước tiếp theo đã xếp hạng và cảnh báo scanner hoặc fallback.

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.

Tiếp theo