AI Của Bạn Không Biết Bạn Muốn Gì
(Và Bạn Cũng Vậy)
Spec-Driven Development với OpenSpec
Nội Dung
- Câu chuyện đau thương khi dùng AI thiếu cấu trúc
- AI coding sai ở đâu và tại sao context window giới hạn nó
- Spec-Driven Development (SDD) là gì
- Spec-Driven Development với OpenSpec
Câu Chuyện Đau Thương
- Thay đổi nằm rải rác khắp nhiều microservice repo + legacy monolith repo
- AI nhảy thẳng vào generate, không có sự khám phá kỹ lưỡng
- Phiên chat dài kiệt sức với việc phải lái đi lái lại liên tục
- Code sai. Thay đổi sai. Review từng dòng vô nghĩa.
- Hiệu suất giảm. Sự bực bội tăng.
- Tôi bắt đầu sợ cái công cụ đáng ra tôi phải yêu thích.
Mọi Thứ Sai Ở Đâu?
- Chúng ta đã vibe coding cho công việc nghiêm túc — chỉ là không gọi nó bằng cái tên đó
- Prompt của chúng ta là ngôn ngữ nghiệp vụ: nó nói cái gì, không phải làm thế nào
- AI khám phá codebase — nhưng đoán mò chi tiết kỹ thuật chúng ta bỏ sót
- Ý định mơ hồ → hallucination → sai class, sai file, sai giả định
Giới Hạn Context Window
Spec-Driven Development (SDD) Là Gì?
Tạo spec artifact trước — mọi thứ khác được suy ra từ nó
Spec là sự hiểu biết chung giữa bạn và AI
BDD, TDD, OpenAPI contract-first, ... đều chia sẻ cùng một khái niệm
Quy Trình SDD
| Giai đoạn | Mô tả |
|---|---|
| Spec | Định nghĩa các artifact .md như prd.md, research.md, design.md, tasks.md, ... |
| Implement | AI đọc Spec artifact và implement trong ngữ cảnh của Spec |
| Validation | Kiểm tra implementation với spec |
| Archive | Lưu trữ sau khi hoàn thành |
Vibe Coding vs Spec-Driven
| Vibe Coding | Spec-Driven |
|---|---|
| Prompt → hy vọng | Spec → code chất lượng cao |
| AI đoán phạm vi | AI làm việc trong phạm vi đã định |
| Session thoái hóa | Tiếp tục từ spec bất kỳ lúc nào |
| Review code | Review ý định |
| Một phiên dài hỗn loạn | Thay đổi nhỏ, có phạm vi, rõ ràng |
Trình Biên Dịch Ý Định
Trình biên dịch bắt lỗi trước khi code chạy. Spec bắt hiểu lầm trước khi AI code.
- Giai đoạn Spec → rẻ để điều chỉnh
- Giai đoạn Implement → đắt để điều chỉnh
- Production → không thể điều chỉnh
Review Spec
Luôn review spec để đảm bảo sự hiểu biết chung giữa bạn và AI
- Bắt lỗ hổng sớm: Chúng ta có thiếu edge case nào không?
- Kiểm tra thiết kế: Đây có phải pattern đúng không?
- Kiểm tra phạm vi: Quá nhiều hay quá ít?
- Kiểm tra Hallucination: Điều này đến từ đâu?
SDD với OpenSpec
- OpenSpec là công cụ meta prompt để hướng dẫn AI khám phá context dự án và tạo Spec artifact có phạm vi
- OpenSpec artifact có phạm vi rõ ràng, có thể review được, và hỗ trợ dự án brownfield như công dân hạng nhất
| spec-kit | GSD | OpenSpec | |
|---|---|---|---|
| Khối lượng artifact | Cao | Rất cao | Thấp |
| Checkpoint review | Trung bình | Thấp | Cao |
| Mức độ nhiễu | Cao | Rất cao | Thấp |
Kết Luận
AI biết bạn muốn gì (và bạn cũng vậy) nếu có đủ context
- Câu trả lời không phải là prompt tốt hơn. Mà là sự hiểu biết rõ ràng hơn và spec artifact tốt hơn.
- SDD là ahead-of-time compilation cho ý định của bạn.
- Áp dụng SDD để implement một feature rồi đánh giá.
