about-spec-kit

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

about-spec-kit

Spec Kit là gì

Spec Kit是什么

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).

Spec Kit是一个可复用的文档框架，用于从业务分析→架构设计（C4）→待办事项（Agile），每个步骤都有AI Agent提供支持。Spec-kit止步于User Story——这是最终的执行单元，没有单独的技术Task、Sprint或Release层级。

贯穿整个kit的使用规则（命名/ID、

status

生命周期、术语表链接、变更传播矩阵等）位于

docs/spec-kit-conventions.md

中——需要详细了解以下概述内容时可阅读该文件（如果项目中还没有此文件，请查看下方“前置条件”）。

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

包含哪些skill，何时使用

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)

Skill	使用场景	输出结果
`setup-context`	还没有任何 `docs/business-requirement` ，想要启动新项目	`BR-001` , `UR-001` , `FR-001`
`c4-model`	BR/UR/FR的 `status: approved` 已设置，需要系统架构	`docs/system-overview` （C4 Context/Container/Component + Interface Contract）
`plan-backlog`	BR/UR/FR已获批且 `c4-container.md` 已存在，需要拆分任务	`docs/backlog` （Epic → Feature → User Story）
`backlog-status`	想要了解现有待办事项，或是查看Epic→Feature→User Story的层级结构	不生成文件——仅读取并汇总信息
`about-spec-kit` （本skill）	不清楚此kit是什么或不知道从何入手	仅提供解释，若项目中还没有 `docs/spec-kit-conventions.md` 则自动生成该文件（见下文）

Đ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.

templates/spec-kit-conventions.md

与本

SKILL.md

文件捆绑提供。检查

docs/spec-kit-conventions.md

是否已存在——如果不存在，直接将上述文件原样复制到该位置（无需询问用户，不创建子文件夹），再回答以下任何问题；这是本skill对项目进行的唯一写入操作，其他所有操作仅为读取/解释。

Để 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".

运行skill
```
/setup-context
```
——以自然对话方式讨论要开展的项目（并非生硬地按原文提问WHY/WHO/WHAT三个固定问题），直接写入
```
BR-001
```
/
```
UR-001
```
/
```
FR-001
```
，无需中间草稿步骤。
完成每一层级的审核后（设置
```
status: approved
```
）再进入下一层级——不得越级（见
```
docs/spec-kit-conventions.md
```
第2节，通用原则#2）。
运行skill
```
/c4-model
```
生成
```
docs/system-overview
```
（Context + Container + Component Diagram，必要时生成Container/Entity Interface Contract）。
运行skill
```
/plan-backlog
```
将任务拆解为Epic → Feature → User Story。
随时运行skill
```
/backlog-status
```
查看现有待办事项或层级结构。
所有文档变更需单独提交一次git，提交格式见
```
docs/spec-kit-conventions.md
```
的“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).

Glossary（
```
docs/glossary/glossary.md
```
）——业务+技术/术语词典，处理文档前务必先查阅（首次运行
```
setup-context
```
时，Agent会自动生成该文件）。
系统与技术文档——
```
docs/business-requirement
```
、
```
docs/user-requirement
```
、
```
docs/functional-requirement
```
、
```
docs/system-overview
```
：依次为Business/User/Functional Requirement，然后是C4 Context + Container + Component。解决WHY → WHO → WHAT → 总体架构的问题。
问题跟踪器——
```
docs/backlog
```
：Epic → Feature → User Story。每个Epic对应一个container（
```
source_container
```
，可在
```
c4-container.md
```
的“代码”列中查询）。
会议与未解决问题——
```
docs/meetings
```
：会议纪要和未解决问题；未解决的问题（OQ）可能会阻碍任何依赖它的Epic/Feature/Story。
docs/spec-kit-conventions.md
——通用规则（命名/ID、
```
status
```
、术语链接、变更传播矩阵、提交格式等）；每个skill都附带一个初始版本，若项目中还没有该文件则自动生成，因此项目中只会存在唯一一份。

本Spec-kit不包含技术Task、Sprint或Release层级——User Story是Agent/开发人员开始执行（编写代码）所需的最小且最终的单元。