Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
3.6 KiB
/tiep — recovery MỘT đường cho MỌI kiểu gián-đoạn (Harness-22 WAL session-continuity)
Đây là đường recovery DUY-NHẤT để nối lại mạch việc dở sau bất-kỳ kiểu gián-đoạn nào — hết giới-hạn, crash, tắt máy, đổi tài-khoản, hay chết giữa một workflow. Gõ
/tiep(kể cả khi user chỉ nói "làm tiếp" bằng text thường). Cặp với/pause. Đặt tên/tiepđể tránh đè lệnh dựng-sẵn (/resume,/continue).
Thực-hiện tuần-tự 4 bước:
1. Đọc .claude/WAL.md
- Đọc file
.claude/WAL.md. - Nếu KHÔNG tồn-tại, HOẶC chain rỗng / toàn
[x](không còn mục dở) → báo "không có mạch dở" và DỪNG SẠCH. KHÔNG bịa việc.
2. Đối-chứng ground-truth
- Chạy TOÀN BỘ lệnh trong
verify:. - VÀ đọc thêm
git status+ disk run-folder liên-quan — per-turn ≠ per-task (N9): các return của agent có thể mất khi phiên chết, NHƯNG file per-agent trên đĩa vẫn còn; nên đọc đĩa, đừng chỉ tin returns. - So kết-quả thực-tế với
chain:.
3. Ground-truth thắng WAL
- LỆCH (kết-quả
verify:/git statusmâu-thuẫnchain:) → TIN GROUND-TRUTH: sửa WAL cho khớp thực-tế, báo chỗ lệch cho user, RỒI MỚI chạy tiếp. KHÔNG mù-quáng chạy theo chain sai. - KHỚP → thực-thi từ
next:, nối chain theo thứ-tự các mục còn[!]/[ ].
4. Mục [!] dạng wf: → nhánh recovery-workflow
Nếu mục dở là một dòng wf: (chết giữa workflow) → relaunch ĐÃ-CẮT-GỌT, KHÔNG chạy lại từ đầu:
- Đọc run-folder +
## taskList snapshottrongrun.md(danh-sách-task + nội-dung spec đã snapshot lúc phóng). - Lấy bằng-chứng task-nào-đã-xong bằng cách grep run-id trong log-phiên (glob đường-dẫn — đây là grep ĐÍCH-DANH một chuỗi, KHÔNG nạp lại toàn-bộ transcript).
- Harvest-hồi-tố phần đã xong: lead verify rồi append trí-nhớ, đánh-dấu harvest partial-honest.
- RELAUNCH workflow chỉ với các task CÒN LẠI + memory-pack DẪN-XUẤT-LẠI TƯƠI (🔴 CẤM dùng snapshot memory-pack cũ — nó lỗi-thời sau khi đã harvest phần xong).
- Resume-theo-run-id (nếu engine có) = bonus CHỈ trong cùng phiên (SAME-SESSION-ONLY) — 🔴 CẤM claim nó chạy cross-session; mặc-định dùng relaunch-đã-cắt-gọt.
Xong nhánh workflow thì vận-hành bình-thường tiếp (lead cập-nhật WAL sau mỗi subtask đổi trạng-thái).
🔒 CẤM tuyệt-đối:
- CẤM giả-định một bước đã xong nếu
verify:KHÔNG chứng-minh. - CẤM nạp lại transcript cũ — WAL + ground-truth (
verify:+git status+ đĩa) là ĐỦ; nếu thiếu thông-tin thì HỎI anh, đừng đoán.
ℹ️ Field session:: khác phiên hiện-tại là BÌNH-THƯỜNG — đó chính là use-case của /tiep (nối qua phiên / đổi acc). CHỈ cảnh-báo khi updated: mới hơn cả lúc phiên hiện-tại bắt đầu (dấu-hiệu có một phiên khác đang chạy song-song trên cùng repo).