Cách viết SPEC hiệu quả cho AI agent - Addy Osmani

• Yếu tố tạo ra khác biệt lớn nhất về năng suất của AI agent → SPEC rõ ràng và có cấu trúc
• SPEC tệ = mơ hồ → AI bị trôi hướng, lặp lại thất bại, vượt quá ngữ cảnh
• SPEC tốt = tài liệu sống (SPEC.md) + cập nhật liên tục

Các thành phần cốt lõi của một SPEC tốt

• Mục tiêu / tầm nhìn (vì sao làm, dành cho ai)
• Danh sách tính năng + mức độ ưu tiên
• Tech stack (cụ thể như React 18 + TS, Node 20)
• Lệnh thực thi (npm test, lint, build v.v.)
• Tiêu chí kiểm thử (chạy những bài test nào thì được xem là thành công)
• Cấu trúc mã / hướng dẫn phong cách
• Quy trình Git (quy tắc branch, commit message)
• Thiết lập ranh giới (✅ luôn luôn / ⚠️ hỏi trước / 🚫 tuyệt đối không làm)

Mẫu prompt khởi đầu hiệu quả

• “Draft a detailed specification for … covering objectives, features, constraints, step-by-step plan”
• Dùng Plan Mode trước → để AI viết bản nháp SPEC
• Sau đó chia nhỏ thành các tác vụ đơn vị nhỏ để giao việc

Mẹo thực chiến (chỉ giữ ý chính)

• Duy trì file SPEC.md riêng → mỗi lần làm việc chỉ đưa vào các phần liên quan
• Mô-đun hóa + tách các tác vụ con
• Sau mỗi lần làm việc, chạy kiểm thử tự động + xác nhận có tuân thủ SPEC hay không
• Làm rõ 3 cấp độ quy tắc ranh giới (Always / Ask / Never)