Hội tụ

Trước khi bắt đầu

• Cần biết: chuỗi hiện vật spec.md, plan.md, tasks.md của tính năng
• Cần có: /speckit-implement đã chạy trên tasks.md hiện tại
• Cần đang ở: thư mục gốc của dự án, sau khi đã thực thi xong các task

1. Hội tụ là gì

/speckit-converge đối chiếu mã nguồn hiện có với đặc tả (specification), kế hoạch (plan) và danh sách task. Nó trả lời câu hỏi: đã cài đặt đủ chưa, hay còn phần nào bị bỏ sót.

Lệnh này chỉ thêm, không sửa và không xoá mã nguồn. Nó không bao giờ viết lại code của bạn. Nếu tìm thấy phần còn thiếu, nó chỉ bổ sung task mới vào tasks.md.

2. Chạy sau khi đã thực thi

Gõ trong khung chat của công cụ AI:

/speckit-converge

Kết quả mong đợi: công cụ in ra bản tóm tắt phát hiện theo mức độ nghiêm trọng, rồi kết luận bằng một trong hai kết quả: đã hội tụ, hoặc đã bổ sung task.

3. Hai kết quả có thể xảy ra

• Converged — không tìm thấy lỗ hổng. tasks.md được giữ nguyên từng byte. Bạn thấy dòng thông báo dạng ✅ Converged — the implementation satisfies the spec, plan, and tasks. Bạn đã xong và có thể chuyển sang rà soát hoặc mở pull request.
• Tasks appended — có lỗ hổng. Công cụ thêm task mới vào tasks.md dưới một mục Convergence và cho biết đã thêm bao nhiêu task.

4. Lặp cho tới khi hội tụ

Khi công cụ báo đã bổ sung task, vòng làm việc của bạn là:

/speckit-implement

Kết quả mong đợi: công cụ thực thi các task mới được thêm ở mục Convergence.

Sau đó chạy lại /speckit-converge. Lặp hai bước này cho tới khi lệnh báo đã hội tụ. Mỗi vòng sẽ tìm ra ít mục hơn vòng trước.

5. Điều kiện để chạy lệnh

Chỉ chạy /speckit-converge sau khi /speckit-implement đã chạy trên tasks.md hiện tại. Nếu bạn vừa sửa tasks.md mà chưa thực thi, kết quả đối chiếu sẽ không phản ánh đúng trạng thái mã nguồn.

6. Sau khi hội tụ

Khi lệnh báo đã hội tụ, vòng xây dựng của bạn khép lại: mã nguồn khớp với đặc tả, kế hoạch và danh sách task. Bạn có thể chuyển sang rà soát mã nguồn hoặc mở pull request.

Nếu muốn dùng lại bước kiểm tra nhất quán như một lượt rà thêm, xem Kiểm tra nhất quán.

Kết quả

Sau khi hoàn thành trang này, bạn đã:

• Biết mã nguồn của mình khớp hay chưa khớp với đặc tả, kế hoạch và danh sách task
• Bù được các task còn thiếu và lặp cho tới khi lệnh báo hội tụ

Cách tự xác nhận: /speckit-converge kết thúc bằng thông báo đã hội tụ, và tasks.md không còn task nào chưa thực thi.

Lỗi thường gặp

Lỗi	Nguyên nhân	Cách khắc phục
Lệnh chạy khi chưa thực thi task nào	Sai thứ tự	Chạy /speckit-implement trên tasks.md hiện tại trước
Mong đợi lệnh tự sửa mã nguồn	Hiểu sai tính chất chỉ thêm của lệnh	Đọc danh sách task mới rồi chạy /speckit-implement để làm chúng
Lặp mãi không tới trạng thái hội tụ	Task mới lại phát sinh lỗ hổng mới, hoặc đặc tả đang đổi	Đóng băng spec.md và plan.md trong lúc lặp, rồi rà lại ở bước phân tích
tasks.md thay đổi ngoài mong đợi	Bạn đang sửa tay tệp này song song	Để /speckit-converge là nguồn duy nhất thêm task trong lúc hội tụ

---

Nguồn tham chiếu: Spec-Driven Development QuickstartPhiên bản kiểm chứng: Spec Kit 1.1.3