Tóm tắt và Thực hành
Những điểm chính cần ghi nhớ
- Bản đặc tả luôn đến trước và nó luôn ngắn gọn — một đoạn văn nêu tên các ràng buộc thực sự quan trọng, bao gồm cả các ràng buộc về quy trình làm việc không bao giờ hiện diện trong ứng dụng đang chạy.
- Các bí mật không bao giờ chạm vào kho mã; mọi dự án đều đọc khóa từ các biến môi trường hoặc cấu hình đã mã hóa được đặt trong một bảng điều khiển.
- Stack công nghệ được chọn sao cho có ít cơ hội sai sót nhất — xác thực được quản lý sẵn, cơ sở dữ liệu được quản lý sẵn, lưu trữ tĩnh, các hàm .
- Các trở ngại được giải quyết bằng cách đưa cho AI bằng chứng chính xác — lỗi nguyên văn, code thực tế, cấu hình triển khai — và giới hạn phạm vi sửa lỗi hẹp lại.
- Ra mắt có nghĩa là một bài kiểm chứng thật với thực tế, không phải "nó biên dịch được": một lần mua hàng thật, một tài khoản thứ hai, một liên kết sâu trên trang đã triển khai.
Hãy thử
Chọn một trong những ý tưởng của riêng bạn và viết bản đặc tả một đoạn văn cho nó theo cách bốn dự án trên đã làm: nêu tên hành động cốt lõi, dữ liệu mà mỗi người dùng có thể thấy, và ít nhất một ràng buộc về quy trình làm việc (nội dung được xuất bản như thế nào, ai có thể làm gì). Sau đó liệt kê những khối xây dựng được quản lý sẵn (managed building blocks) mà bạn sẽ dựa vào để có ít code tùy chỉnh hơn có thể gây lỗi. Giữ nó trong một đoạn văn duy nhất cộng với một danh sách gạch đầu dòng ngắn — nếu nó phình to hơn thế, bạn đang đặc tả quá chi tiết.
Prompt của chương
I want to build: [one-paragraph description of the app].
Before any code, help me tighten this into a buildable spec.
1. Restate the single core action a user performs.
2. List the data each user can see — and what they must NOT see.
3. Name the workflow constraints that won't show up in the UI
(e.g. "pushing a file should publish it", "only their own data").
4. Recommend a stack that MINIMIZES custom code: managed auth,
managed database, static or serverless hosting where possible.
5. Flag the one part most likely to go wrong, and how we'll test it
against reality (a real purchase, a second account, a deep link).
Keep the spec to a paragraph plus bullets. Push back if it's too big.