Lưu trạng thái session với ak:handoff

Dùng ak:handoff khi kết thúc session, chuyển context hoặc giao công việc cho agent mới. Skill giữ goal, trạng thái hiện tại, quyết định, bằng chứng, blocker và dependency từ hội thoại làm việc, sau đó lưu cùng nội dung handoff ngắn gọn vào project.

Chọn ak:handoff để duy trì hội thoại

Dùng ak:handoff khi

• Session mới cần goal hiện tại và lý do đằng sau các quyết định.
• Công việc chưa hoàn tất và session tiếp theo nên tránh lặp lại discovery.
• Bạn cần giữ rejected approach, trap, blocker hoặc verification còn thiếu cùng trạng thái hiện tại.
• Handoff nên trỏ tới plan, issue, commit, diff, test và tệp thay vì sao chép chúng.

Chọn workflow khác khi

• Bạn cần báo cáo trạng thái lấy từ repository trên branch, worktree, plan, roadmap và history. Dùng ak:watzup.
• Bạn cần reflection theo thời gian sau công việc đáng kể. Dùng ak:journal.
• Bạn cần quyết định product bền vững hoặc policy hiện hành. Cập nhật ADR hay owner tài liệu; handoff không phải authority bền vững.
• Bạn cần implement, commit, publish hoặc deploy. Dùng workflow phù hợp và cấp quyền riêng cho các tác động đó.

Chạy handoff launch sản phẩm giữa các Kit

Chuẩn bị một engineering request có phạm vi từ launch contract đã duyệt. Handoff phải giúp Engineer Kit lập plan an toàn mà không cần dựng lại quyết định marketing hoặc nhận quyền publication.

Engineer trả behavior đã implement, preview hoặc artifact, bằng chứng test, giới hạn đã biết và yêu cầu rollout/rollback. Marketing sau đó đối chiếu kết quả với ak:launch-strategy, cập nhật campaign cùng measurement plan và xin phê duyệt riêng cho publication, spend hoặc production change.

Tạo lại handoff khi message, audience, acceptance criteria hoặc delivery boundary đã duyệt thay đổi. Không nối thêm công việc không liên quan vào handoff đang active.

Chuẩn bị context handoff an toàn

Trước khi bắt đầu:

• Hoàn thành Làm quen và cài Marketing Kit cho runtime cùng scope hiện tại.
• Mở project và đọc instruction, plan liên quan cùng handoff trước đó cho cùng focus nếu có.
• Xác định source artifact chứng minh trạng thái hiện tại và verification.
• Quyết định focus cho session tiếp theo; mục này không bắt buộc nhưng giúp giữ báo cáo đúng scope.
• Loại secret, token, password, private URL, customer data và personal data khỏi nội dung hội thoại cần giữ lại.

Project phải có thư mục plans để dùng output chuẩn. Nếu không có, Skill hỏi một vị trí output an toàn trong project trước khi ghi.

Gọi Skill

/ak:handoff "Tiếp tục review launch brief. Giữ quyết định audience đã duyệt, source pointer, legal review chưa giải quyết và trạng thái validation. Redact chi tiết customer"

/ak:handoff "Tiếp tục review launch brief. Giữ quyết định audience đã duyệt, source pointer, legal review chưa giải quyết và trạng thái validation. Redact chi tiết customer"

$ak:handoff "Tiếp tục review launch brief. Giữ quyết định audience đã duyệt, source pointer, legal review chưa giải quyết và trạng thái validation. Redact chi tiết customer"

Đọc Runtime adapter trước khi giả định mỗi runtime cung cấp cùng lượng hội thoại trước đó hoặc context project.

Hiểu các giai đoạn

1. Load context chi phối. Skill đọc instruction project, plan liên quan và handoff trước đó cho cùng focus khi có.
2. Trích xuất trạng thái session. Skill xác định goal, lý do quan trọng, trạng thái hiện tại, quyết định chính cùng rationale, rejected approach, blocker, verification và dependency còn mở.
3. Thay bản sao bằng pointer. Skill tham chiếu source file, plan, issue, ADR, commit, diff và test thay vì nhúng artifact lớn.
4. Redact nội dung nhạy cảm. Skill loại secret, credential, private URL, customer data và personal data. Khi credential quan trọng, Skill chỉ nêu vị trí an toàn đã được duyệt.
5. Render đúng cấu trúc bắt buộc. Handoff gồm chính xác các section bên dưới và kết thúc bằng prompt ngắn yêu cầu agent tiếp theo đọc, xác minh các nguồn đã liệt kê trước khi hành động.
6. Lưu một báo cáo. Skill output một fenced Markdown block và lưu cùng nội dung vào plans/reports/handoff-YYYYMMDD-HHmm-<slug>.md.

Giữ handoff riêng tư và không có thẩm quyền

• Chỉ ghi trong project hoặc vị trí reports đã thống nhất.
• Không sao chép root instruction, diff lớn, plan đầy đủ, customer record hay giá trị credential vào báo cáo.
• Ghi quyết định thực sự đã được đưa ra; không tạo quyết định mới trong handoff.
• Mô tả phần việc mở dưới dạng trạng thái và dependency. Prompt cho agent mới phải yêu cầu xác minh repository trước khi hành động.
• Thao tác ghi tệp không cấp quyền Git staging, commit, push, publication, deployment, outreach, account mutation, spend hoặc truy cập mạng bên ngoài.
• Handoff không chứng minh branch, provider, campaign hay repository state vẫn giữ nguyên sau thời điểm tạo.

Xác minh output

Một lần chạy hoàn tất nên cung cấp:

• Một fenced Markdown block ngắn gọn trong response.
• Cùng nội dung tại plans/reports/handoff-YYYYMMDD-HHmm-<slug>.md, hoặc ở vị trí an toàn được duyệt riêng khi project không có thư mục plans.
• Đủ mọi section bắt buộc, trạng thái verification cụ thể và source pointer.
• Blocker cùng dependency chưa giải quyết được nêu rõ.
• Secret, private URL, customer data và personal data đã được redact.
• Prompt cuối cho agent mới yêu cầu đọc tệp được liệt kê và đối chiếu handoff với trạng thái repository hiện tại.

Mở tệp đã lưu và so sánh với block trong response. Sau đó review diff repository trước khi quyết định báo cáo có nên vào version control không.

Xử lý sự cố an toàn

Tiếp tục với Tổng quan Marketing Kit hoặc Projects, artifact và checkpoint để hiểu khái niệm rộng hơn về persistence và ownership.

Biết các giới hạn hiện tại

• Skill chỉ có thể giữ hội thoại và context project nhìn thấy trong session hiện tại.
• Skill không tự quét mọi branch, worktree, remote ref, roadmap hay bề mặt lịch sử repository; ak:watzup sở hữu báo cáo đó.
• Redaction là yêu cầu workflow, không đảm bảo dữ liệu nhạy cảm chưa từng bị lộ trước đó trong session. Con người vẫn phải review.