Sửa nhanh

Sửa lỗi, refactor và thay đổi nhỏ có thể đi thẳng vào Build với ít hoặc không có planning upstream. Đây là cùng workflow triển khai dùng cho story đã lập kế hoạch đầy đủ.

Khi nào nên dùng

• Sửa lỗi khi nguyên nhân đã rõ ràng
• Refactor nhỏ (đổi tên, tách hàm, tái cấu trúc) nằm trong một vài tệp
• Điều chỉnh tính năng nhỏ hoặc thay đổi cấu hình
• Cập nhật dependency

:::note[Điều kiện tiên quyết]

• Đã cài BMad Method (npx bmad-method install)
• Một IDE tích hợp AI (Claude Code, Cursor, hoặc tương tự) :::

Các bước thực hiện

1. Bắt đầu một phiên chat mới

Mở một phiên chat mới trong AI IDE của bạn. Tái sử dụng một phiên từ workflow trước dễ gây xung đột context.

2. Mô tả ý định của bạn

Build nhận ý định dạng tự do - trước, cùng lúc, hoặc sau khi gọi workflow. Ví dụ:

run build — Sửa lỗi validate đăng nhập cho phép mật khẩu rỗng.

run build — fix https://github.com/org/repo/issues/42

run build — thực hiện ý định trong _bmad-output/implementation-artifacts/my-intent.md

Tôi nghĩ vấn đề nằm ở auth middleware, nó không kiểm tra hạn của token.
Để tôi xem... đúng rồi, src/auth/middleware.ts dòng 47 bỏ qua
hoàn toàn phần kiểm tra exp. run build

run build
> Bạn muốn làm gì?
Refactor UserService sang dùng async/await thay vì callbacks.

Văn bản thường, đường dẫn tệp, URL issue GitHub, liên kết bug tracker - bất kỳ thứ gì LLM có thể suy ra thành một ý định cụ thể.

3. Trả lời câu hỏi và phê duyệt

Build có thể đặt câu hỏi làm rõ hoặc đưa ra một bản spec ngắn để bạn phê duyệt trước khi triển khai. Hãy trả lời và phê duyệt khi bạn thấy kế hoạch đã ổn.

4. Review và push

Build sẽ triển khai thay đổi, tự review công việc của mình, sửa các vấn đề phát hiện được và commit vào local. Khi hoàn thành, nó sẽ mở các tệp bị ảnh hưởng trong editor.

• Xem nhanh diff để xác nhận thay đổi đúng với ý định của bạn
• Nếu có gì không ổn, nói cho agent biết cần sửa gì - nó có thể lặp lại ngay trong cùng phiên

Khi đã hài lòng, push commit. Build sẽ đề xuất push và tạo PR cho bạn.

:::caution[Nếu có thứ bị vỡ] Nếu thay đổi đã push gây sự cố ngoài ý muốn, dùng git revert HEAD để hoàn tác commit cuối một cách sạch sẽ. Sau đó bắt đầu một phiên chat mới và chạy lại Build để thử hướng khác. :::

Bạn nhận được gì

• Các tệp nguồn đã được sửa với bản fix hoặc refactor
• Test đã pass (nếu dự án có bộ test)
• Một commit sẵn sàng để push, dùng conventional commit message

Công việc trì hoãn

Build giữ mỗi lần chạy tập trung vào một mục tiêu duy nhất. Nếu yêu cầu của bạn có nhiều mục tiêu độc lập, hoặc review phát hiện các vấn đề tồn tại sẵn không liên quan đến thay đổi hiện tại, Build sẽ đưa chúng vào tệp deferred-work.md trong thư mục implementation artifacts thay vì cố gắng xử lý tất cả một lúc.

Hãy kiểm tra tệp này sau mỗi lần chạy - đó là backlog các việc bạn cần quay lại sau. Mỗi mục trì hoãn có thể được đưa vào một lần chạy Build mới.

Khi nào nên bổ sung lập kế hoạch đầy đủ

Trước khi chạy cùng Build loop, cân nhắc bổ sung PRD, UX, kiến trúc hoặc lập kế hoạch story khi:

• Thay đổi ảnh hưởng nhiều hệ thống hoặc cần cập nhật đồng bộ trên nhiều tệp
• Bạn chưa chắc phạm vi và cần làm rõ yêu cầu trước
• Bạn cần ghi lại tài liệu hoặc quyết định kiến trúc cho cả nhóm

Xem Build để hiểu cách ý định trực tiếp và công việc đã lập kế hoạch hội tụ vào cùng một vòng triển khai.