Lối tắt dễ mắc
Dán transcript là an toàn nhất.
Cách làm đúng
Transcript thô bị cấm; chỉ ghi dữ kiện liên quan và có thể hành động.
Ctrl K
Tóm tắt nhanh / Lệnh
Bộ Marketing
/ak:handoff
Hợp đồng bàn giao
Tạo một file Markdown bàn giao đã redact để agent mới tiếp tục an toàn mà không cần đọc lại toàn bộ transcript.
01
Đọc mục tiêu
02
Kiểm tra focus an toàn
03
Đọc trạng thái workspace
04
Chọn đường dẫn
Nguyên tắc 01
Handoff là hợp đồng để tiếp tục, không phải transcript hoặc báo cáo trạng thái chung.
Nguyên tắc 02
Sự thật quan sát từ workspace phải tách khỏi lời khẳng định trong phiên.
Nguyên tắc 03
Các mục bắt buộc luôn phải có, kể cả khi một số dữ kiện chưa được giải quyết.
Nguyên tắc 04
Secret và URL riêng tư phải được redact trước khi ghi và không được in inline.
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 Đọc mục tiêu Nhận lệnh trống, trọng tâm công việc tùy chọn, đường dẫn output, yêu cầu kèm diff/status hoặc cờ force overwrite.
- 2 Kiểm tra focus an toàn Từ chối nếu chuỗi trọng tâm công việc có vẻ chứa credential hoặc giá trị giống secret.
02
Xử lý
Agent / skill thực thi
- 3 Đọc trạng thái workspace Chạy các probe git chỉ đọc và có giới hạn để lấy repo, gốc repo, branch, HEAD, status và diff nếu được yêu cầu.
- 4 Chọn đường dẫn Dùng plans/reports/handoff-YYYYMMDD-HHmm-<slug>.md, hoặc hỏi đường dẫn nội bộ dự án an toàn nếu chưa có thư mục plans.
03
Kiểm chứng
Gate, review, xác thực
- 5 Chặn ghi đè Nếu file đích đã tồn tại, từ chối trừ khi có --force rõ ràng.
- 6 Soạn đúng schema Ghi đúng các mục bắt buộc: Goal, Why This Matters, Current State, Key Decisions and Why, Rejected Approaches and Traps, Verification Status, Relevant Files and Pointers, và Open Work and Dependencies.
04
Đóng
Báo cáo, bàn giao, artifact
- 7 Redact secret Áp dụng pattern redact cho artifact và phần diff/status tùy chọn trước khi ghi.
- 8 Trả bàn giao Trả một khối Markdown fenced ngắn gọn, lưu cùng nội dung đó, và kèm prompt cho agent mới yêu cầu kiểm chứng nguồn.
Đừng bỏ qua bước bắt buộc
Mỗi mục đối chiếu một lối tắt dễ mắc với cách làm đúng mà skill yêu cầu.
Lối tắt dễ mắc
Có --output thì ghi đè được.
Cách làm đúng
Ghi đè cần --force; chỉ có --output không bao giờ đồng nghĩa được thay file.
Lối tắt dễ mắc
Mục chưa biết có thể bỏ.
Cách làm đúng
Mọi mục bắt buộc phải còn, đánh dấu bằng chứng thiếu là chưa giải quyết thay vì bịa dữ kiện.
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ế.
Handoff mặc định Khuyến nghị
/ak:handoff- Dùng khi:
- Phiên hiện tại cần hợp đồng bàn giao để agent sau tiếp tục.
- Kết quả:
- Ghi artifact tự đặt tên trong plans/reports và trả cùng nội dung Markdown fenced kèm hướng dẫn tiếp tục.
Handoff có trọng tâm
/ak:handoff "tiếp tục sửa OAuth callback"- Dùng khi:
- Cần đưa một trọng tâm công việc cụ thể vào goal và slug tên file.
- Kết quả:
- Tạo hợp đồng tiếp tục tập trung vào việc đó với trạng thái, ràng buộc và bước kế tiếp.
Kèm bằng chứng
/ak:handoff--include-diff--include-status
- Dùng khi:
- Agent sau cần bằng chứng có giới hạn về workspace đang dở.
- Kết quả:
- Thêm status và diff summary đã redact, kèm dấu cắt nếu quá dài.
Đường dẫn cụ thể
/ak:handoff--outputplans/reports/handoff-oauth-callback.md--force
- Dùng khi:
- Cần cố ý ghi đè một đường dẫn handoff đã biết.
- Kết quả:
- Ghi đúng đường dẫn đã yêu cầu vì --force cho phép ghi đè handoff hiện có.
Phạm vi xử lý
- Đọc mục tiêu
- Kiểm tra focus an toàn
- Đọc trạng thái workspace
- Chọn đường dẫn
- Chặn ghi đè
- Soạn đúng schema