DDevArchive
Đăng nhập

Spec-Driven Development (SDD): Viết Spec cho AI sinh code chuẩn

Bẫy lớn nhất của "Vibe Coding" là gõ prompt mông quạnh khiến AI sinh code rác. SDD dạy bạn cách viết tài liệu Spec, Data Schema, API Contract chi tiết trước để AI triển khai 100% chính xác.

Quy trình SDD 4 bước

BướcCông việcĐầu raVai trò AI
1. SpecTả tính năng, User flow, Edge casesfeature-spec.mdAI hỗ trợ phát hiện thiếu sót
2. ContractĐịnh nghĩa Type, Interface, DB Schemaschema.ts / api.protoAI sinh Zod/TypeScript types
3. ImplementationSinh code logic theo Contractsrc/modules/…AI tự động sinh code theo spec
4. VerificationChạy Unit test & E2E testtest reportAI tự sửa lỗi khi test trượt

Mẫu Feature Spec chuẩn SDD

// File: docs/specs/user-auth.md
# Spec: Authentication with Passkeys & JWT
## 1. Requirement
- Cho phép user đăng nhập bằng Passkey (WebAuthn) hoặc Email/Password.
- Trả về httpOnly Refresh Token (7d) và Access Token (15m).
## 2. API Contract
- POST /api/auth/register (Input: RegisterSchema, Output: { user, token })
- POST /api/auth/login (Input: LoginSchema, Output: { user, token })
## 3. Security Requirements
- Mật khẩu hash bằng bcrypt (salt=10)
- Rate limit: max 5 requests / minute per IP