Giữ ngữ cảnh phiên với ak:handoff

Dùng ak:handoff khi một phiên agent mới cần tiếp tục cùng công việc mà không phải khám phá lại mục đích, quyết định, bằng chứng và blocker. Skill tạo handoff cuộc trò chuyện ngắn gọn, hiển thị nó trong phản hồi và lưu cùng nội dung đã biên tập dưới dạng report của project.

Chọn ak:handoff để duy trì phiên

Dùng ak:handoff khi

• Bạn kết thúc phiên làm việc trước khi mục tiêu hoàn tất.
• Bạn chuyển sang agent mới hoặc context window nhỏ hơn.
• Quyết định quan trọng, phương án bị loại, blocker hoặc trạng thái xác minh có thể bị mất.
• Bạn muốn phiên sau xác minh trạng thái hiện tại với source artifact.

Chọn workflow khác khi

• Bạn muốn status report rút từ Git trên branch, worktree, plan và lịch sử repo. Dùng ak:watzup.
• Bạn cần commit, push hoặc mở pull request. Dùng ak:git.
• Bạn muốn implementation plan thay vì ngữ cảnh phiên. Dùng ak:plan.

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

Dùng handoff hai chiều khi Marketing sở hữu launch outcome còn Engineer sở hữu một implementation có phạm vi. Handoff chuyển context, không chuyển thẩm quyền.

1. Marketing duyệt audience, user outcome, positioning, asset, acceptance criteria, target window, measurement và non-goal.
2. Marketing tạo handoff nêu chính xác engineering deliverable cùng quyết định chưa giải quyết. Handoff loại trừ credential, customer data và quyền publication hoặc production rộng.
3. Engineer chạy ak:plan, nhận scope approval, implement bằng ak:cook và verify bằng ak:test.
4. Engineer trả về behavior đã đổi, preview route hoặc artifact, bằng chứng test, giới hạn đã biết, nhu cầu rollout/rollback và quyết định Marketing cần thực hiện.
5. Marketing xác minh kết quả với launch contract trước khi tiếp tục campaign, publication, spend hoặc measurement.

Engineer nhận việc nên từ chối handoff thiếu acceptance criteria, nêu ngày mà không có dependency, gộp deliverable không liên quan hoặc giả định quyền deploy/merge. Hãy tách thành deliverable có phạm vi hoặc trả quyết định còn thiếu về Marketing.

Chuẩn bị project và runtime

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

• Hoàn tất Làm quen, và xác nhận Engineer Kit đã được cài cho runtime và scope bạn đang dùng.
• Mở project và cung cấp chỉ dẫn cùng plan liên quan.
• Xác định trọng tâm của phiên tiếp theo và mục tiêu hiện tại.
• Tìm handoff trước đó cho cùng trọng tâm nếu có.
• Review cuộc trò chuyện để tìm secret, URL riêng tư, dữ liệu khách hàng và dữ liệu cá nhân không được đưa vào report.

Chạy Skill

/ak:handoff "Continue the authentication migration after the failing integration test is diagnosed"

/ak:handoff "Continue the authentication migration after the failing integration test is diagnosed"

$ak:handoff "Continue the authentication migration after the failing integration test is diagnosed"

Đối số tùy chọn nêu trọng tâm của phiên tiếp theo. Skill không có mode flag đã công bố.

Hiểu những gì diễn ra trong một lần chạy

1. Skill đọc thẩm quyền project. Skill kiểm tra chỉ dẫn repo, plan liên quan và handoff trước đó cho cùng trọng tâm khi có.
2. Skill ghi lại mục tiêu và trạng thái hiện tại. Skill phân biệt công việc đã hoàn tất, đang làm, bị chặn và chưa xác minh.
3. Skill ghi quyết định. Skill giữ lại lý do, phương án bị loại, dependency và bẫy đã biết mà không tạo quyết định mới.
4. Skill trỏ tới bằng chứng. Skill tham chiếu plan, issue, quyết định, commit, diff, test và tệp thay vì sao chép chúng.
5. Skill biên tập nội dung nhạy cảm. Skill xóa secret, credential, URL riêng tư, dữ liệu khách hàng và dữ liệu cá nhân, chỉ giữ pointer vị trí an toàn khi cần.
6. Skill viết hai output giống nhau. Skill trả về một fenced Markdown block và lưu cùng nội dung dưới dạng report có timestamp.
7. Skill chuẩn bị quay lại. Skill kết thúc bằng prompt ngắn yêu cầu agent mới đọc các tệp được liệt kê và xác minh handoff trước khi hành động.

Giữ report an toàn

Handoff phải nằm trong project hoặc vị trí report đã thỏa thuận. Nội dung không được lặp lại chỉ dẫn gốc, chứa credential hay dữ liệu riêng tư, tạo quyết định mới hoặc biến công việc mở thành lệnh chưa xác minh cho agent tiếp theo.

Workflow trong source không yêu cầu thay đổi Git, truy cập network, xuất bản, provider bên ngoài hay dịch vụ trả phí.

Xác minh kết quả

Handoff đầy đủ chứa:

• Tiêu đề ngắn, thời gian tạo và trọng tâm phiên tiếp theo.
• Mục tiêu và lý do quan trọng.
• Trạng thái hiện tại theo sự thật.
• Quyết định chính và lý do.
• Phương án bị loại và bẫy đã biết.
• Trạng thái xác minh, gồm check chưa chạy hoặc chưa pass.
• Tệp và source pointer liên quan.
• Công việc mở được diễn đạt thành trạng thái và dependency.
• Prompt xác minh ngắn cho agent mới.

Xác nhận phản hồi fenced và report đã lưu giống nhau, đồng thời giá trị đã biên tập không thể được dựng lại từ nội dung.

Khắc phục sự cố hoặc tiếp tục

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

• Handoff phản ánh cuộc trò chuyện, plan đã đọc và bằng chứng khả dụng; phiên sau phải xác minh lại với repo.
• Redaction chỉ bảo vệ report khi nội dung nhạy cảm được nhận ra và xóa; hãy review artifact trước khi chia sẻ.
• Skill giữ ngữ cảnh phiên, không thực hiện audit repo đầy đủ.
• Cách gọi slash trên Cursor là bằng chứng do người dùng xác minh, không chứng minh tính tương đương đầy đủ của runtime.
• Stable và beta đóng gói cùng workflow và cấu trúc report của ak:handoff.