Tóm tắt nhanh / Lệnh

Bộ Marketing

/ak:sumup

Tóm tắt phần đã triển khai

Tóm tắt phần kỹ thuật đã hoàn tất, bằng chứng, lỗi và cách xử lý, đánh đổi, hành vi, kiến trúc, cách dùng và việc tiếp theo mà không bắt người đọc xem lại cả phiên làm việc.

01

Gom bằng chứng

02

Tách trạng thái bằng chứng

03

Nêu phần quan trọng liên quan

04

Thêm visual làm rõ

Nguyên tắc 01

Bằng chứng trước, lời kể sau

Nguyên tắc 02

Đã kiểm khác với mới đề xuất

Nguyên tắc 03

Chỉ dùng visual khi nó làm rõ vấn đề

Nguyên tắc 04

Để phần còn mở ở cuối và phải hành động được

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 Gom bằng chứng Dùng hội thoại, quyết định đã chấp nhận, diff hiện tại, test và trạng thái issue/plan liên quan làm bằng chứng mạnh nhất.
  2. 2 Tách trạng thái bằng chứng Tách phần đã triển khai và đã kiểm khỏi phần mới đề xuất, suy luận, chưa test, chưa ship hoặc vẫn còn mở.
02

Xử lý

Agent / skill thực thi

  1. 3 Nêu phần quan trọng liên quan Tóm tắt outcome, thay đổi giá trị cao, lỗi và workaround, quyết định, cách kết quả hoạt động, cách dùng thực tế, follow-up và bước tiếp.
  2. 4 Thêm visual làm rõ Dùng bảng, chart, Mermaid hoặc ASCII flow ngắn khi nó làm rõ hành vi, user flow, kiến trúc, database hoặc UI/UX; nếu không hữu ích thì nói ngắn lý do.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Đặt phần còn mở ở cuối Giữ bản tóm tắt gọn, dùng ngôn ngữ của người dùng, bỏ mục rỗng và đặt các phần còn mở ở cuối.

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:sumup [task|PR|branch|recent]

Đối số

[task|PR|branch|recent]

Phạm vi tóm tắt

Ranh giới bằng chứng tùy chọn: một task, một pull request, một branch, hoặc phần việc gần đây. Bỏ qua để tóm tắt bằng chứng triển khai mạnh nhất ở gần. Không triển khai, không deploy và không thay live status check.

/ak:sumup recent

Subcommand

task Tóm tắt task
/ak:sumup task

Tóm tắt một task đã xong: outcome, thay đổi đã kiểm, lỗi, quyết định và việc còn mở.

Kết quả: Bản tóm tắt task gọn với ranh giới bằng chứng và phần còn mở ở cuối.

/ak:sumup task
PR Tóm tắt pull request
/ak:sumup PR

Tóm tắt phần đã triển khai trong ranh giới pull request mà không tuyên bố đã deploy.

Kết quả: Điểm nhấn trong ranh giới PR, trạng thái verification và follow-up, không tuyên bố deploy.

/ak:sumup PR
branch Tóm tắt branch
/ak:sumup branch

Tóm tắt phần đã làm trên branch đã nêu hoặc branch hiện tại bằng diff, test và quyết định đã chấp nhận.

Kết quả: Outcome theo branch, thay đổi chính, lỗi và blocker còn lại, kèm bằng chứng được nêu rõ.

/ak:sumup branch
recent Tóm tắt việc gần đây
/ak:sumup recent

Tóm tắt khoảng triển khai gần nhất mà không xem lại cả phiên làm việc.

Kết quả: Tóm tắt việc gần đây, tách kết quả đã kiểm khỏi phần chưa test hoặc còn mở.

/ak:sumup recent

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

Tóm tắt mặc định Khuyến nghị
/ak:sumup
Dùng khi:
Sau khi triển khai, khi người đọc cần hiểu kết quả mà không xem lại toàn bộ phiên làm việc.
Kết quả:
Tạo bản tóm tắt gọn gồm outcome, bằng chứng mạnh nhất ở gần, thay đổi đã triển khai, ranh giới verification, blocker còn mở và bước tiếp có thể hành động ở cuối.
Tóm tắt task
/ak:sumup task
Dùng khi:
Một task đã xong cần bản tóm tắt có ranh giới bằng chứng về phần đã đổi và phần còn lại.
Kết quả:
Tóm tắt outcome của task, thay đổi đã kiểm, lỗi và workaround, quyết định và blocker còn lại mà không triển khai thêm gì.
Tóm tắt pull request
/ak:sumup PR
Dùng khi:
Pull request là ranh giới bằng chứng và không được coi như đã deploy.
Kết quả:
Tóm tắt phần đã làm trong ranh giới PR, tách phần đã kiểm khỏi phần chưa test, và từ chối tuyên bố deploy khi chưa có bằng chứng runtime.
Tóm tắt branch
/ak:sumup branch
Dùng khi:
Cần câu chuyện phần đã làm trên branch hiện tại hoặc đã nêu, không phải live status check.
Kết quả:
Dùng diff branch, test và quyết định đã chấp nhận làm bằng chứng, giải thích cách kết quả hoạt động khi hữu ích, và để phần còn mở ở cuối.
Tóm tắt việc gần đây
/ak:sumup recent
Dùng khi:
Khoảng triển khai gần nhất cần được tóm tắt mà không xem lại cả phiên.
Kết quả:
Gom bằng chứng hội thoại, diff và test gần đây, bỏ mục rỗng, và chỉ thêm visual ngắn khi nó làm rõ hành vi hoặc kiến trúc.

Phạm vi xử lý

  • tóm tắt triển khai
  • tóm tắt verification
  • phục hồi sau lỗi
  • giải thích kiến trúc
  • ưu tiên follow-up

Tiếp theo