Spec Kit là gì? Đi trọn 9 lệnh của GitHub để agent code theo spec thay vì theo cảm hứng
Ở bài quy trình 7 bước trong series này, Spec Kit của GitHub được nhắc đúng một dòng. Nó đáng hơn một dòng. Phần lớn bài giới thiệu Spec Kit trên mạng viết từ năm 2025 và mô tả nó là "ba lệnh specify, plan, tasks". Mình đọc lại repo ở bản mới nhất (1.4.2, ra ngày 17/11/2026) thì thấy nó đã khác khá xa: có 9 lệnh, có lệnh mới để kiểm code đã làm đủ spec chưa, có quy trình riêng cho sửa bug và đánh giá ý tưởng, và cả một hệ thống để team tự chế quy trình của mình.
Bài này đi qua Spec Kit theo thứ tự bạn sẽ gặp nó: ý tưởng gốc, cài đặt với Claude Code, 9 lệnh trên một ví dụ, cách viết "hiến pháp" cho project, đưa vào project đang chạy, và cuối cùng là những lời chê đáng nghe. Phần cài đặt mình chạy thật bằng Specify CLI 1.4.2. Các đoạn output của lệnh trong agent là minh hoạ theo đúng template của Spec Kit, viết cho ví dụ app chia tiền ở bài trước, không phải bản chụp từ một lần chạy thật.
Spec Kit năm 2026 gồm những gì
Repo ra đời ngày 21/8/2025, lên 1.0.0 đúng ngày tròn một năm (21/8/2026). README bây giờ chia nó thành hai phần:
| Phần | Gồm | Dùng khi |
|---|---|---|
| Quy trình có sẵn | Spec-Driven Development (lõi); sửa bug và đánh giá ý tưởng (extension cài thêm) | Muốn dùng ngay một quy trình đã được nghĩ kỹ |
| Integration | Nối Spec Kit với agent: Claude Code, Copilot, Codex, Gemini, Cursor và vài chục agent khác | Luôn cần, chọn lúc specify init |
| Extension | Thêm lệnh, cổng chất lượng, hoặc cả một quy trình mới | Team có bước riêng muốn agent làm theo |
| Preset | Đổi template, lệnh, thuật ngữ của quy trình có sẵn | Muốn quy trình lõi nhưng theo chuẩn của công ty |
| Workflow | Tự động chạy chuỗi lệnh có cổng duyệt | Muốn chạy specify → plan → tasks → implement liền mạch |
| Bundle | Gói sẵn extension, preset, workflow cho một vai trò | Phát cho cả team một bộ cài giống nhau |
Phần lõi vẫn là Spec-Driven Development (SDD). Phần còn lại tồn tại để bạn đổi quy trình mà không phải fork cả Spec Kit. Một cảnh báo ghi ngay trong README: catalog cộng đồng không phải là kiểm định, đọc code của extension trước khi cài.
Ý tưởng gốc: code phục vụ spec, không phải ngược lại
File spec-driven.md trong repo gọi đây là "power inversion". Lâu nay code là sự thật, còn spec chỉ là giàn giáo dựng lên rồi bỏ. Ai đã từng mở một file tài liệu thiết kế cũ hai năm đều biết cảm giác đó: tài liệu nói một đằng, code làm một nẻo. SDD đảo lại: spec là thứ chính, code là cách thể hiện spec bằng một ngôn ngữ cụ thể. Muốn đổi hành vi thì sửa spec trước, rồi sinh lại plan và code.
Nghe giống một lời hứa lớn. Phần đáng học hơn nằm ở cách Spec Kit giữ lời hứa đó: template là một loại prompt có ràng buộc. Bảy cơ chế được mô tả trong spec-driven.md, và bạn dùng được chúng kể cả khi không cài Spec Kit:
| Cơ chế | Trong template | Chặn được thói quen gì của LLM |
|---|---|---|
| Tách WHAT khỏi HOW | Spec chỉ nói người dùng cần gì và vì sao; không tech stack, không API | Nhảy ngay vào "dùng React với Redux" khi chưa rõ cần gì |
| Bắt đánh dấu chỗ chưa rõ | [NEEDS CLARIFICATION: phương thức đăng nhập chưa rõ: email, SSO hay OAuth?] |
Tự đoán một giả định nghe hợp lý nhưng sai |
| Checklist như unit test cho yêu cầu | "Không còn [NEEDS CLARIFICATION]", "Tiêu chí thành công đo được" |
Viết spec trông đầy đủ mà thiếu |
| Cổng hiến pháp | Plan phải qua phần "Constitution Check" trước khi thiết kế | Thêm tầng trừu tượng, thêm project "cho tương lai" |
| Giữ tài liệu ở đúng tầng | Plan ở mức cao, chi tiết đẩy sang file riêng | Plan biến thành một đống code |
| Nghĩ tới test trước | Hợp đồng và test có trước code (khi hiến pháp yêu cầu) | Viết code trước, test cho có sau |
| Cấm tính năng "có thể cần" | Mỗi tính năng phải truy về một user story | Tự thêm "nice to have" |
Riêng cơ chế thứ hai đã đáng tiền: nhiều lỗi AI slop không nằm ở code sai, mà ở một giả định không ai nói ra. Bắt model ghi [NEEDS CLARIFICATION] thay vì đoán là đổi một lỗi ngầm thành một câu hỏi công khai.
Cài đặt và khởi tạo với Claude Code
Cần Python 3.11+ và uv. Specify CLI đã có trên PyPI:
uv tool install specify-cli
specify init chia-tien --integration claude
Muốn thử mà không cài vĩnh viễn thì uvx --from specify-cli specify init chia-tien --integration claude. Mình chạy đúng lệnh này trên Windows với CLI 1.4.2, và đây là những gì được tạo ra:
chia-tien/
├── .claude/skills/
│ ├── speckit-constitution/SKILL.md
│ ├── speckit-specify/SKILL.md
│ ├── speckit-clarify/SKILL.md
│ ├── speckit-plan/SKILL.md
│ ├── speckit-checklist/SKILL.md
│ ├── speckit-tasks/SKILL.md
│ ├── speckit-analyze/SKILL.md
│ ├── speckit-implement/SKILL.md
│ └── speckit-converge/SKILL.md
└── .specify/
├── memory/constitution.md ← hiến pháp, ban đầu là khung trống
├── templates/ ← spec, plan, tasks, checklist, constitution
├── scripts/powershell/ ← trên Linux, macOS sẽ là scripts/bash
└── workflows/speckit/workflow.yml
Mỗi lệnh là một skill của Claude Code, gọi trong khung chat bằng /speckit-specify, /speckit-plan... Với Copilot cũng là /speckit-*; Codex dùng $speckit-*. Tài liệu viết lệnh dạng /speckit.specify, đó là cùng một lệnh.
Một tuỳ chọn đáng biết nếu project bạn đã có nhiều skill: mặc định mô tả của cả 9 skill Spec Kit luôn nằm trong context của Claude để nó tự gọi khi thấy hợp, và chúng chiếm chỗ trong danh sách skill. Thêm --integration-options="--no-model-invocation" lúc init thì chúng chỉ chạy khi bạn tự gõ lệnh.
Mỗi tính năng sau đó có một thư mục riêng specs/001-ten-tinh-nang/ chứa spec.md, plan.md, research.md, data-model.md, contracts/, quickstart.md, tasks.md. Spec Kit nhớ đang làm tính năng nào qua file .specify/feature.json, không phải qua nhánh git, nên không có git vẫn chạy được. Muốn mỗi tính năng tự có một nhánh đánh số kiểu 001-ten-tinh-nang thì bật extension git (specify init ... --extension git); khi đó nhớ rằng chỉ git checkout sang nhánh khác chưa đủ để đổi tính năng đang làm.
Đi trọn 9 lệnh
constitution → specify → clarify → plan → checklist → tasks → analyze → implement → converge
(1 lần) (tuỳ) (tuỳ) (tuỳ) (lặp tới khi Converged)
Chỉ specify là bắt buộc trước plan. Ba lệnh có chữ "tuỳ" là cổng chất lượng, dùng khi có chỗ mơ hồ thật. Tài liệu dặn chạy từng lệnh một và đọc kết quả trước khi chạy lệnh tiếp theo. Ví dụ xuyên suốt là app chia tiền cho nhóm bạn đi du lịch.
1. constitution: luật chơi của cả project
/speckit-constitution Tiền luôn là số nguyên đơn vị đồng. Logic tính toán không phụ thuộc
giao diện hay database. Logic tính tiền bắt buộc có test trước khi code.
Mỗi migration database phải có cách quay lại.
Lệnh này điền vào .specify/memory/constitution.md (khung có sẵn các nguyên tắc, mục ràng buộc, mục quy trình, mục quản trị, và dòng phiên bản kèm ngày phê chuẩn) và đồng bộ các template phụ thuộc. Chạy một lần cho project, cập nhật khi nguyên tắc đổi. Viết thế nào cho có ích là chuyện của một mục riêng phía dưới.
2. specify: cái gì và vì sao, chưa nói làm thế nào
/speckit-specify App chia tiền cho nhóm 2–20 người đi chơi chung. Ghi các khoản chi,
chia đều hoặc theo số tiền, xem ai nợ ai và tối giản số lần chuyển khoản.
Template spec ép kết quả vào một khung rất cụ thể. Đoạn trích minh hoạ:
### User Story 1 - Ghi một khoản chi chung (Priority: P1)
**Why this priority**: Không ghi được khoản chi thì không có gì để chia.
**Independent Test**: Thêm một khoản 300.000đ do An trả, chia ba; thấy được phần của từng người.
**Acceptance Scenarios**:
1. **Given** nhóm có An, Bình, Chi, **When** An thêm khoản 100.000đ chia đều,
**Then** phần chia là 33.334đ, 33.333đ, 33.333đ và tổng đúng 100.000đ.
### Functional Requirements
- **FR-001**: Hệ thống MUST cho phép ghi khoản chi với người trả, số tiền, danh sách người được chia.
- **FR-004**: Thành viên rời nhóm MUST [NEEDS CLARIFICATION: còn nợ thì xử lý thế nào?]
### Success Criteria
- **SC-001**: Thêm một khoản chi mất dưới 15 giây trên điện thoại.
- **SC-002**: Tổng các phần chia luôn bằng đúng số tiền gốc.
Ba thứ đáng để ý trong khung này. Mỗi user story test độc lập được: chỉ làm riêng story P1 vẫn ra một sản phẩm dùng được. Yêu cầu được đánh số FR-xxx để các bước sau trỏ về được. Và FR-004 mang dấu [NEEDS CLARIFICATION], vì mô tả ban đầu không nói gì về người rời nhóm.
3. clarify: tối đa 5 câu, mỗi lần một câu
Prompt của lệnh này là một trong những prompt hỏi đáp kỹ nhất mình từng đọc. Nó quét spec theo danh mục (phạm vi, dữ liệu, luồng, phi chức năng, trường hợp biên...), chấm từng mục là Rõ, Một phần hay Thiếu, rồi xếp hàng câu hỏi theo Tác động × Độ không chắc. Luật cứng:
- Tối đa 5 câu cho cả phiên. Còn nhiều chỗ mơ hồ hơn thì chọn 5 chỗ đáng hỏi nhất.
- Mỗi lần một câu, không bao giờ dồn.
- Mỗi câu có một câu "vì sao quan trọng" và một phương án được đề xuất kèm lý do; bạn trả lời "yes" là chấp nhận đề xuất.
- Câu trả lời được ghi ngay vào
spec.md.
Một câu hỏi theo đúng định dạng đó:
Thành viên còn nợ có được rời nhóm không?
Vì sao quan trọng: quyết định này đổi cách tính "ai nợ ai" và dữ liệu phải giữ lại.
**Recommended:** Option B - giữ lịch sử nợ để bảng tất toán luôn đúng.
| Option | Description |
| A | Cấm rời nhóm khi số dư khác 0 |
| B | Cho rời, đánh dấu "đã rời", vẫn tính trong tất toán |
| C | Cho rời, xoá khỏi nhóm và mọi khoản chi |
Giới hạn 5 câu và luật "đề xuất sẵn một phương án" là hai thứ mình mang về dùng ngay cả khi không dùng Spec Kit: chúng biến một cuộc phỏng vấn dài lê thê thành năm quyết định có lý do.
4. plan: đến lúc này mới nói tới công nghệ
/speckit-plan Next.js App Router, TypeScript, PostgreSQL qua Drizzle. Logic tính tiền là hàm thuần
trong src/domain. Không thư viện state management.
Plan sinh ra nhiều file: plan.md (bối cảnh kỹ thuật, cấu trúc thư mục), research.md (so sánh lựa chọn), data-model.md, contracts/, và quickstart.md (các kịch bản kiểm tra chính). Phần quan trọng nhất là Constitution Check, một cổng phải qua trước khi nghiên cứu và kiểm lại sau khi thiết kế:
## Constitution Check
| Nguyên tắc | Plan có tuân thủ? | Ghi chú |
| Tiền là số nguyên | ✅ | cột amount_vnd kiểu bigint |
| Logic tách khỏi UI và DB | ✅ | src/domain không import React, Drizzle |
| Test trước cho logic tính tiền | ✅ | tasks sẽ đặt test trước code ở phase US1 |
Chỗ nào không qua cổng thì plan phải ghi lý do vào phần "Complexity Tracking". Muốn thêm một tầng trừu tượng thì phải viết ra vì sao, và người review thấy ngay.
5. checklist: unit test cho yêu cầu, không phải cho code
/speckit-checklist Tập trung vào việc sửa và xoá khoản chi.
Lệnh này không kiểm code, nó kiểm spec: yêu cầu đã đủ, rõ, nhất quán chưa. Các mục có dạng câu hỏi:
- [ ] CHK001 Có yêu cầu cho việc sửa số tiền của khoản chi đã được tất toán một phần không? (Completeness)
- [ ] CHK002 "Chia theo số tiền" có quy định khi tổng các phần khác số tiền gốc không? (Clarity)
- [ ] CHK003 Có định nghĩa ai được sửa khoản chi của người khác không? (Coverage)
Một luật quan trọng: dấu [x] nghĩa là người review đã xác nhận yêu cầu đạt, agent không được tự tích. Và implement sau này đọc checklist như một cổng: còn mục chưa tích thì dừng lại hỏi bạn có muốn làm tiếp không.
6. tasks: chia theo user story, không theo tầng kỹ thuật
/speckit-tasks
tasks.md được chia phase: Setup, Foundational (thứ mọi story đều cần), rồi mỗi user story một phase theo độ ưu tiên, cuối cùng là Polish. Định dạng từng dòng:
## Phase 3: User Story 1 - Ghi một khoản chi chung (Priority: P1)
- [ ] T010 [P] [US1] Test chia đều và tổng bằng số gốc trong tests/unit/split.test.ts
- [ ] T011 [US1] Hàm splitEqually trong src/domain/split.ts
- [ ] T012 [US1] Server action thêm khoản chi trong src/app/groups/[id]/actions.ts
[P] là chạy song song được (khác file, không phụ thuộc nhau), [US1] là thuộc story nào, và mỗi việc ghi rõ đường dẫn file. Chia theo story thay vì theo tầng (kiểu "làm hết database rồi tới API rồi tới UI") nghĩa là xong phase US1 là có thứ dùng được, demo được.
Có một chi tiết mình thấy nhiều người bỏ qua: template ghi rõ test là tuỳ chọn, chỉ sinh khi spec hoặc hiến pháp yêu cầu. Muốn có test thì phải nói ra, như ở bước constitution.
7. analyze: kiểm chéo, chỉ đọc
/speckit-analyze
Lệnh này đọc spec.md, plan.md, tasks.md (và data-model.md nếu có) rồi báo trùng lặp, mơ hồ, thiếu, lệch hiến pháp, và yêu cầu không có task nào phủ. Báo cáo có dạng:
| ID | Category | Severity | Location(s) | Summary | Recommendation |
| C1 | Constitution Alignment | CRITICAL | tasks.md:T011 | Hàm tính tiền không có task test đứng trước | Thêm task test trước T011 |
| G1 | Coverage Gaps | HIGH | spec.md:FR-004 | Yêu cầu người rời nhóm không có task nào | Thêm task ở phase US2 |
Ba luật trong prompt đáng học: không bao giờ sửa file, chỉ báo cáo và đề xuất, sửa gì phải được bạn đồng ý; vi phạm hiến pháp tự động là CRITICAL, và cách sửa là chỉnh spec, plan, tasks chứ không "diễn giải lại" nguyên tắc; tối đa 50 phát hiện, còn lại gom thành tóm tắt. Và một lời dặn: lỗi nằm ở bước nào thì quay về bước đó sửa, đừng vá ở cuối.
8. implement: làm theo task, từng phase
/speckit-implement Chỉ làm phase Setup và Foundational. Dừng trước các user story.
Với tính năng nhỏ, chạy một lần là xong. Với tính năng lớn, tài liệu khuyên chạy từng phase, kiểm phase đó chạy được rồi mới làm phase tiếp, để context của agent không bị nhồi quá tải. Trước khi bắt đầu, lệnh kiểm trạng thái các checklist như đã nói ở bước 5.
9. converge: so code với spec, chỉ được thêm việc
/speckit-converge
Đây là lệnh mới mà phần lớn bài viết năm 2025 không có. Sau khi implement, nó đối chiếu code thật với spec, plan, tasks, và kết thúc bằng một trong hai kết quả:
✅ Converged — the implementation satisfies the spec, plan, and tasks., vàtasks.mdkhông bị đụng tới một byte nào. Xong, mở PR.- Còn thiếu: nó chỉ thêm một mục
## Phase N: Convergencevào cuốitasks.mdvới các task còn lại, mỗi task trỏ về yêu cầu gốc.
## Phase 6: Convergence
- [ ] T042 Xử lý thành viên rời nhóm khi còn nợ per spec.md FR-004 (missing behavior)
Luật quan trọng nhất: converge không bao giờ sửa hay xoá code, và "agent nói là xong" không được tính là bằng chứng, phải kiểm hành vi thật. Rồi bạn chạy implement tiếp, rồi converge lại, mỗi vòng ít việc hơn, cho tới khi nó báo Converged. Đây chính là cách Spec Kit trả lời câu chuyện quen thuộc "agent báo xong khi app còn chưa chạy nổi".
Hiến pháp: viết thế nào để nó có ích
spec-driven.md đưa ra một hiến pháp mẫu 9 điều: mọi tính năng bắt đầu là một thư viện độc lập, mọi thư viện có giao diện dòng lệnh, test trước là bắt buộc, tối đa 3 project ban đầu, dùng thẳng framework thay vì bọc thêm lớp, test với database thật thay vì mock... Đó là ví dụ, không phải luật mặc định. Template thật trong project là một khung trống.
Hướng dẫn chính thức cho project có sẵn có một câu mình thấy nên in ra dán lên màn hình: dùng README, quyết định kiến trúc, hướng dẫn đóng góp và cấu hình CI làm bằng chứng, đừng bịa chuẩn chỉ để điền cho đủ template. Hiến pháp chi phối mọi bước sau, nên một nguyên tắc không thật sẽ tạo ra cả đống cảnh báo vô nghĩa ở analyze và converge.
Ba điều mình rút ra khi đọc các prompt:
- Chỉ ghi điều kiểm được. "Code phải sạch" không giúp gì. "Tiền là số nguyên đơn vị đồng" thì
analyzekiểm được trêndata-model.md. - Điều gì quan trọng thì phải nói ra. Template tasks coi test là tuỳ chọn. Bạn muốn test trước thì hiến pháp phải ghi, và khi đã ghi thì
analyzecoi task thiếu test là CRITICAL. - Có phiên bản và ngày sửa. Hiến pháp có dòng phiên bản, ngày phê chuẩn, ngày sửa gần nhất. Đổi nguyên tắc là một thay đổi có chủ đích, không phải lặng lẽ sửa một dòng.
Đưa vào project đang chạy
Hướng dẫn chính thức chia làm 5 bước, mình tóm lại:
- Bắt đầu từ trạng thái review được: commit hoặc stash việc đang dở, tạo một nhánh riêng, rồi chạy
specify init --here --force --integration claudeở gốc repo.--forcecó thể ghi đè những file trùng đường dẫn Spec Kit quản lý (không xoá phần còn lại của app), nên đọc diff trước khi đi tiếp. - Viết hiến pháp từ những gì đã đúng, ví dụ "Giữ tương thích API công khai. Theo đúng ranh giới service hiện có. Migration nào cũng có cách quay lại."
- Chọn một thay đổi nhỏ có ranh giới rõ. Đừng lấy "mô tả toàn bộ hệ thống" làm tính năng đầu tiên, trừ khi đó đúng là thứ bạn cần giao.
- Plan bám vào repo: kiểm plan có dùng lại thứ đang có không; chạy
analyzetrước khi code; review code và tài liệu cùng nhau. - Quyết định spec sẽ sống bao lâu sau khi giao.
Spec sống bao lâu sau khi giao
Đây là câu hỏi ít ai đặt ra cho tới khi thư mục specs/ có 40 tính năng và không ai biết cái nào còn đúng. Spec Kit đưa ra 4 mô hình:
| Mô hình | Cách làm | Hợp khi |
|---|---|---|
| Flow-back | Spec, plan, tasks được sửa cùng code khi có phát hiện mới | Team nhỏ, plan hay đổi giữa chừng, tốc độ quan trọng hơn lưu vết |
| Flow-forward | Thư mục tính năng đã xong là bất biến; thay đổi sau tạo thư mục mới | Cần truy vết, kiểm toán, thấy rõ yêu cầu đổi theo thời gian |
| Living spec | spec.md là hợp đồng duy nhất được giữ và sửa trước; các file khác sinh lại |
Hợp đồng sản phẩm ổn định, team quen sinh lại tài liệu |
| Constitution-only | Chỉ hiến pháp sống lâu; tài liệu tính năng dùng xong thì lưu trữ ngoài hoặc bỏ | Yêu cầu đã có chỗ khác giữ (ticket, wiki), muốn repo gọn |
Nếu không chắc, constitution-only là điểm bắt đầu ít rủi ro nhất: bạn vẫn được lợi từ quy trình mà không phải nuôi hàng chục file markdown sau mỗi tính năng.
Ngoài SDD: sửa bug và đánh giá ý tưởng
Hai quy trình này là extension, cài khi cần, không bắt buộc phải qua SDD trước:
- Sửa bug (
specify extension add bug):/speckit-bug-assesstìm nguyên nhân,/speckit-bug-fixsửa đúng phạm vi,/speckit-bug-testkiểm triệu chứng gốc đã hết. Kết luận làverified,partialhoặcfailed, và chỉverifiedmới tính là đã sửa. - Đánh giá ý tưởng (
specify extension add assess): năm bước từ tiếp nhận tới quyết định, kết luậngo,needs-clarificationhoặckill. Dừng lại với một lý do được ghi rõ cũng được coi là một kết quả tốt.
Và nếu thấy template đầy đủ quá nặng, preset lean (specify preset add lean) giữ nguyên luồng specify → plan → tasks → implement nhưng mỗi lệnh chỉ sinh một file gọn, không có các mục mẫu phải điền.
Những lời chê đáng nghe
Birgitta Böckeler (Thoughtworks) đã thử Spec Kit cùng Kiro và Tessl, và viết một bài đánh giá trên martinfowler.com (15/10/2025). Ba ý chính:
- Quá nhiều markdown phải review. Các file sinh ra dài, lặp lại nhau và lặp lại cả code đã có. Câu của bà: "I'd rather review code than all these markdown files."
- Không rõ dùng cho bài toán cỡ nào. Với một bug nhỏ, quy trình kiểu này như dùng búa tạ đập hạt dẻ.
- Cảm giác kiểm soát giả. Dù có đủ template, checklist, agent vẫn nhiều lần không làm theo hết chỉ dẫn.
Công bằng mà nói, bài đó đánh giá Spec Kit bản đầu, trước 1.0. Một số điểm đã có câu trả lời: preset lean cho phần nặng nề, extension sửa bug riêng cho bài toán nhỏ, converge kiểm code thật thay vì tin agent. Nhưng điểm cốt lõi vẫn đúng: chi phí review spec là thật, và nó chỉ đáng khi tính năng đủ lớn hoặc đủ rủi ro.
Cách mình dùng Spec Kit để không rơi vào bẫy đó:
| Tình huống | Làm gì |
|---|---|
| Sửa lỗi nhỏ, đổi một hàm | Không dùng SDD; dùng extension bug nếu cần lưu vết |
| Tính năng vừa, đã rõ | Preset lean, bỏ clarify, checklist |
| Tính năng lớn, nhiều người, có chỗ mơ hồ | Đủ 9 lệnh, chạy implement theo phase |
| Spec dài hơn cả code sẽ viết | Dừng lại, viết code luôn |
Ngoài Spec Kit còn các hướng nhẹ hơn như OpenSpec, sinh ít tài liệu hơn. Ý tưởng chung giống nhau; khác nhau ở mức nghi thức bạn chịu được.
Checklist áp dụng cho team
[ ] Thử trên một tính năng vừa phải trước, không phải bug nhỏ hay cả hệ thống
[ ] Hiến pháp chỉ chứa nguyên tắc đã đúng hoặc đã thống nhất, kiểm được
[ ] Muốn test trước thì ghi vào hiến pháp (template tasks coi test là tuỳ chọn)
[ ] Đọc kết quả từng lệnh trước khi chạy lệnh tiếp
[ ] Mọi [NEEDS CLARIFICATION] được trả lời trước khi plan
[ ] Checklist do người tích, không để agent tự tích
[ ] analyze sạch trước khi implement; lỗi ở bước nào sửa ở bước đó
[ ] Tính năng lớn: implement từng phase
[ ] Lặp implement + converge tới khi Converged
[ ] Đã chọn mô hình giữ spec sau khi giao
[ ] Đọc code extension cộng đồng trước khi cài
Thử ngay: kể cả không cài Spec Kit, mở prompt bạn hay dùng để nhờ agent viết spec và thêm hai dòng: "Chỗ nào chưa rõ thì ghi [NEEDS CLARIFICATION: câu hỏi], không được đoán" và "Hỏi mình tối đa 5 câu, mỗi lần một câu, kèm phương án bạn đề xuất". Hai dòng đó là phần giá trị nhất của Spec Kit, và chúng miễn phí. Team bạn đã thử Spec Kit hay một công cụ spec-driven nào chưa, và dừng ở tính năng cỡ nào thì thấy nó bắt đầu thành gánh nặng? Comment cho mình biết với.
P.S. Mục Edge Cases trong template spec của Spec Kit chỉ có hai dòng gợi ý, và đó là mục mình thấy agent điền sơ sài nhất. Mình bù chỗ đó bằng skill edge-case-scenario-gen trong PrimeKit, bộ skill mình tự làm: nó soát tính năng qua 12 chiều (đầu vào cực trị, thời điểm và tranh chấp, phân quyền, toàn vẹn dữ liệu...), chiều nào bỏ thì phải ghi giả định. Chạy nó trên spec.md trước bước clarify, những tình huống đáng lo sẽ thành câu hỏi cho clarify thay vì thành bug. Cài bằng npx @lovehlmmm/primekit init, rồi gõ /pk:edge-case-scenario-gen specs/001-ten-tinh-nang/spec.md. Chọn tình huống nào đáng thành yêu cầu vẫn là quyết định của bạn.
Tài liệu để đọc thêm
- Repo Spec Kit và tài liệu chính thức
- Spec-Driven Development, phương pháp đầy đủ
- Tham chiếu 9 lệnh SDD
- Dùng Spec Kit với Claude Code
- Đưa Spec Kit vào project có sẵn và giữ spec sau khi giao
- Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl, Birgitta Böckeler
Series khác của mình
- Dùng AI hiệu quả trong công việc: kinh nghiệm thực chiến của dev: viết prompt đủ ngữ cảnh, bắt AI bịa API, giao việc cho agent, review code AI viết, debug, đọc codebase lạ, đóng gói quy trình thành skill.
- Front End thực chiến: những cú lừa của production mà tutorial không kể 🐧: ngày giờ và giờ mùa hè, tầng dữ liệu theo hợp đồng API, chart, in ấn và accessibility, Outlook Add-in, E2E, Remix trên Cloudflare Workers, Supabase và Prisma.
- DevOps thực chiến: Docker, Portainer và Azure Pipelines từ máy dev lên server: Dockerfile, Compose, secret trong container, Portainer, pipeline Azure, deploy có rollback, dựng server Ubuntu.
- SQL thực chiến: Những bài học mình ước đã biết sớm hơn: viết query dễ đọc, đọc execution plan, lỗi NULL và N+1 không báo lỗi, schema và transaction, phân trang bằng con trỏ.
- Backend .NET thực chiến: những case hay gặp trên production: async/await làm treo API, HttpClient hết socket, EF Core kéo cả bảng, idempotency, outbox, caching, bảo mật API.
All rights reserved