about-spec-kit

Original：🇺🇸 English

Translated

Giới thiệu Spec Kit là gì, các thành phần chính, và nên chạy skill nào khi nào (setup-context → c4-model → plan-backlog → backlog-status). Dùng skill này khi user hỏi "spec kit này là gì", "kit này dùng sao", "bắt đầu thế nào", "có những skill nào", hoặc ngay sau khi cài skill lần đầu và chưa biết bắt đầu từ đâu.

2installs

Sourceelsieej/spec-kit-template

Added on2026-08-30

NPX Install

npx skill4agent add elsieej/spec-kit-template about-spec-kit

SKILL.md Content

View Translation Comparison →

about-spec-kit

Spec Kit là gì

Spec Kit là một khung tài liệu tái sử dụng cho việc phân tích nghiệp vụ → thiết kế kiến trúc (C4) → backlog (Agile), có agent AI hỗ trợ ở mọi bước. Spec-kit dừng ở User Story — đây là đơn vị thực thi cuối cùng, không có tầng Task kỹ thuật, Sprint, hay Release riêng.

Quy tắc dùng xuyên suốt kit (naming/ID, vòng đời

status

, glossary-link, ma trận lan truyền thay đổi...) nằm ở

docs/spec-kit-conventions.md

— đọc khi cần chi tiết hơn phần tóm tắt dưới đây (xem "Điều kiện tiên quyết" bên dưới nếu file này chưa có trong dự án).

Có những skill nào, dùng khi nào

Skill	Dùng khi	Output
`setup-context`	Chưa có `docs/business-requirement` nào, muốn bắt đầu dự án mới	`BR-001` , `UR-001` , `FR-001`
`c4-model`	BR/UR/FR đã `status: approved` , cần kiến trúc hệ thống	`docs/system-overview` (C4 Context/Container/Component + Interface Contract)
`plan-backlog`	BR/UR/FR đã approved và `c4-container.md` đã có, cần chia việc	`docs/backlog` (Epic → Feature → User Story)
`backlog-status`	Muốn biết backlog hiện có gì, hoặc cây Epic→Feature→User Story	Không tạo file — chỉ đọc và tổng hợp
`about-spec-kit` (skill này)	Chưa rõ kit này là gì hoặc bắt đầu từ đâu	Chỉ giải thích, trừ scaffold `docs/spec-kit-conventions.md` nếu chưa có (xem dưới)

Điều kiện tiên quyết

templates/spec-kit-conventions.md

đi kèm sẵn cạnh

SKILL.md

này. Kiểm tra

docs/spec-kit-conventions.md

đã tồn tại chưa — nếu chưa có, copy nguyên trạng file trên vào đó (không hỏi user, không tạo subfolder) trước khi trả lời bất kỳ câu hỏi nào bên dưới; đây là hành động duy nhất skill này ghi vào dự án, mọi việc khác chỉ đọc/giải thích.

Để bắt đầu 1 dự án mới

Chạy skill
```
/setup-context
```
— hội thoại tự nhiên về dự án muốn làm (không phải 3 câu hỏi cố định WHY/WHO/WHAT đọc nguyên văn), ghi thẳng vào
```
BR-001
```
/
```
UR-001
```
/
```
FR-001
```
, không qua bước nháp trung gian.
Review từng tầng xong (set
```
status: approved
```
) mới sang tầng sau — không nhảy cấp (xem
```
docs/spec-kit-conventions.md
```
mục 2, nguyên tắc chung #2).
Chạy skill
```
/c4-model
```
để tạo
```
docs/system-overview
```
(Context + Container + Component Diagram, và Container/Entity Interface Contract khi cần).
Chạy skill
```
/plan-backlog
```
để phân rã thành Epic → Feature → User Story.
Chạy skill
```
/backlog-status
```
bất kỳ lúc nào để xem backlog hiện có gì hoặc cây phân cấp.
Mọi thay đổi tài liệu = 1 commit git riêng, định dạng xem
```
docs/spec-kit-conventions.md
```
mục "Commit".

Các thành phần chính

Glossary (
```
docs/glossary/glossary.md
```
) — từ điển thuật ngữ nghiệp vụ + kỹ thuật/văn phong, luôn đọc trước khi xử lý tài liệu (agent tự scaffold khi
```
setup-context
```
chạy lần đầu).
Tài liệu hệ thống & kỹ thuật —
```
docs/business-requirement
```
,
```
docs/user-requirement
```
,
```
docs/functional-requirement
```
,
```
docs/system-overview
```
: Business/User/Functional Requirement, rồi C4 Context + Container + Component. Trả lời WHY → WHO → WHAT → kiến trúc tổng quan.
Tracker quản lý issues —
```
docs/backlog
```
: Epic → Feature → User Story. Mỗi Epic ứng với 1 container (
```
source_container
```
, tra theo cột "Mã" ở
```
c4-container.md
```
).
Meetings & Open Questions —
```
docs/meetings
```
: biên bản họp và câu hỏi mở; một OQ đang mở có thể block bất kỳ Epic/Feature/Story nào phụ thuộc vào nó.
docs/spec-kit-conventions.md
— quy tắc xuyên suốt (naming/ID,
```
status
```
, glossary-link, ma trận lan truyền thay đổi, commit format...); mỗi skill mang theo 1 bản seed và tự scaffold file này nếu dự án chưa có, nên chỉ tồn tại đúng 1 bản trong dự án.

Spec-kit này không có tầng Task kỹ thuật, Sprint, hay Release — User Story là đơn vị nhỏ nhất và cuối cùng agent/dev cần để bắt đầu thực hiện (viết code).

about-spec-kit

NPX Install

Tags

SKILL.md Content

about-spec-kit

Spec Kit là gì

Có những skill nào, dùng khi nào

Điều kiện tiên quyết

Để bắt đầu 1 dự án mới

Các thành phần chính