arrow_back Trở về Catalog
workflows Cơ bản

Workflow /backlog

Quản lý toàn bộ vòng đời backlog của dự án.

Workflow /backlog quản lý toàn bộ vòng đời backlog của dự án: xem tóm tắt, thêm tính năng/bug, đánh giá ưu tiên ICE, cập nhật trạng thái, và đồng bộ với kế hoạch triển khai. Phiên bản v1.5.3 bổ sung tính năng tự động Auto-Sync dựa trên mô hình Hybrid 3-file.

Bảng Lệnh (Commands)

/backlog [project-name] [action]
Hành độngMô tả
reviewXem tổng quan với thống kê và ngữ cảnh phase
addThêm tính năng, epic hoặc bug mới
evaluateChấm điểm ICE để xếp ưu tiên
updateCập nhật trạng thái + tự động Sync 3-File
syncĐồng bộ backlog với kế hoạch triển khai
cleanDọn dẹp task ✅ Done sang tệp done.md

Chi tiết Các Hành Động (Sub-commands)

0. Rules Pre-flight (v1.5.4)

Trước khi bất kỳ hành động nào thực thi, agent đọc lại .agent/rules.md từ đĩa để phục hồi ngữ cảnh rules. Đây là phần của cơ chế Defense-in-Depth Lớp 3 — đảm bảo rules tồn tại sau khi context bị cắt trong phiên dài.

1. review — Xem tổng quan

  • Đọc artifacts/tasks/backlog.md và tải nội dung.
  • Kiểm tra kế hoạch triển khai thông qua project.md.
  • Hiển thị bảng Summary từ backlog và trích xuất Top 3 Actionable Items (các tác vụ có độ ưu tiên cao).
  • Cảnh báo User/Agent nếu đang làm task ở phase tương lai khi phase hiện tại chưa hoàn thành 100%.

2. add — Thêm mới Tác vụ

  • Phân loại nhanh tác vụ thuộc dạng Epic, Feature hay Bug.
  • Hệ thống tự động thiết lập ID tiếp theo với prefix (ví dụ: FEAT-02, BUG-01).
  • Lưu trữ vào đúng section trong backlog.md. Nếu dự án đang kích hoạt một Phase cụ thể, Agent sẽ map task đó trực tiếp vào Phase.

3. evaluate — Đánh giá Ưu tiên (ICE Framework)

  • Duyệt các tính năng đang ở trạng thái ⏳ Pending.
  • Yêu cầu hoặc tự động chấm điểm dựa trên 3 tiêu chí: Impact (Tác động), Confidence (Tự tin), Ease (Độ dễ làm) với thang điểm 1-10.
  • Điểm tổng ICE = I × C × E.
  • Hệ số vượt mốc nhất định (thường >500) tự động biến task thành hàng 🚀 High Priority.

4. update — Cập nhật trạng thái & Auto-Sync (v1.5.3)

  • Chuyển đổi trạng thái qua lại: ⏳ Pending, 🚀 ToDo, 🔨 In Progress, ✅ Done.
  • Khi tất cả task trong Phase hoàn tất → thông báo Phase Complete.
  • Tự động rải dữ liệu (Hybrid Auto-Sync):
    • Đổ đè file sprint-current.md bằng duy nhất danh sách task 🚀 ToDo🔨 In Progress để lệnh /open ở phiên sau có thể nạp Context siêu tốc.
    • Quản lý metadata giúp cho tiến trình cập nhật không gây gián đoạn chuỗi token của Agent.

5. sync — Đồng bộ với Kế hoạch

  • Đối chiếu các items trong danh sách Backlog với sơ đồ Architecture/Plan hiện tại.
  • Phơi bày các tác vụ đang bị Missing hoặc không được map đúng Phase, đưa ra luồng gợi ý sửa chữa.

6. clean — Nén-Không-Xóa (v1.5.3)

  • Nén, không bao giờ xóa. Tasks hoàn thành được chuyển sang done.md, không bị xóa khỏi lịch sử.
  • Quét tất cả task ✅ Done hoặc ✅ Fixed trong backlog.md.
  • Chuyển chúng sang done.md với tags nguồn gốc (#backlog) và timestamp.
  • Bảo tồn chuỗi tra cứu: backlog.md (đang hoạt động) → done.md (lưu trữ) — toàn bộ lịch sử dự án luôn có thể phục hồi.
  • Điều chỉnh lại tỉ lệ Summary đảm bảo biểu đồ hoàn thành task chính xác.

→ Workflow /plan — Lập kế hoạch chiến lược → Học: Kiến trúc Hybrid 3-File