github/spec-kit
💫 Bộ công cụ giúp bạn bắt đầu với Spec-Driven Development
README
🌱 Bộ thông số kỹ thuật
Xác định nội dung cần xây dựng trước khi xây dựng nó — với bất kỳ tác nhân mã hóa AI nào.
Bộ công cụ nguồn mở để xây dựng phần mềm chất lượng cao với bất kỳ tác nhân mã hóa AI nào — một quy trình dựa trên thông số kỹ thuật sẵn sàng sử dụng (hoặc mang theo quy trình của riêng bạn), có khả năng mở rộng vô tận, hướng đến cộng đồng và được xây dựng cho toàn bộ tổ chức của bạn.
Tiếng Anh · 简体中文
[!LƯU Ý] Một năm sử dụng Spec Kit — và 1.0.0
Một năm sau lần cam kết đầu tiên, Spec Kit đã đạt được 1.0.0 — không phải vì công việc đã hoàn thành hay hình dạng của nó bị đóng băng, mà bởi vì dự án đã phát triển thành một thứ gì đó mạch lạc, hữu ích và được định hình bởi nhiều người hơn những người bắt đầu nó.
Bài đăng kỷ niệm cá nhân của người bảo trì chính, Spec Kit biến thành một - và xuất xưởng 1.0.0, xác định ý nghĩa thực sự của 1.0.0 đối với dự án: bây giờ nó chỉ là một con số. Khi các tác nhân làm cho việc thích ứng với thay đổi trở nên rẻ hơn đáng kể, giá trị sẽ chuyển từ tính ổn định sang khả năng thích ứng.
Gửi tới tất cả những người đã sử dụng Spec Kit, thách thức các giả định của nó, báo cáo sự cố, đóng góp mã hoặc tài liệu, tạo tiện ích mở rộng hoặc cài đặt trước, chia sẻ ý tưởng hoặc giúp người khác bắt đầu: cảm ơn bạn. Cột mốc quan trọng này thuộc về cộng đồng đã thực hiện dự án trong suốt năm đầu tiên và tiếp tục định hình hướng đi tiếp theo của dự án.
Mục lục
- 🤔 Spec-Driven Development là gì?
- 🐞 Sửa lỗi bằng Spec Kit
- 💡 Đánh giá ý tưởng bằng Spec Kit
- ⚡ Bắt đầu
- 📽️ Video tổng quan
- 🌍 Cộng đồng
- 🤖 Hỗ trợ tích hợp tác nhân mã hóa AI
- 🔧 Chỉ định tham chiếu CLI
- 🧩 Tự tạo bộ thông số kỹ thuật: Tiện ích mở rộng & cài đặt trước
- 📦 Gói: Thiết lập dựa trên vai trò
- 📚 Triết lý cốt lõi
- 🌟 Các giai đoạn phát triển
- 🎯 Mục tiêu thử nghiệm
- 🔧 Điều kiện tiên quyết
- 📖 Tìm hiểu thêm
- 💬 Hỗ trợ
- 🙏 Lời cảm ơn
- 📄 Giấy phép
🤔 Spec-Driven Development là gì?
Spec-Driven Development lật kịch bản về phát triển phần mềm truyền thống. Trong nhiều thập kỷ, mã luôn là vua - các thông số kỹ thuật chỉ là giàn giáo mà chúng ta xây dựng và loại bỏ sau khi "công việc thực sự" về mã hóa bắt đầu. Spec-Driven Development thay đổi điều này: thông số kỹ thuật có thể thực thi được, trực tiếp tạo ra các triển khai hoạt động thay vì chỉ hướng dẫn chúng.
Khởi động nhanh SDD
Thay thế vX.Y.Z với thẻ phát hành mới nhất, giữ vị trí dẫn đầu v.
uv tool install specify-cli --from git+https://github.com/github/[email protected]
specify init my-project --integration copilot
cd my-project
Khởi chạy tác nhân mã hóa của bạn trong thư mục dự án, sau đó:
- Thành lập nguyên tắc dự án của bạn một lần (
/speckit-constitution). Đây là bước một lần cho mỗi dự án. - Chỉ định những gì bạn muốn xây dựng (
/speckit-specify). - kế hoạch bạn sẽ xây dựng nó như thế nào (
/speckit-plan). - phá vỡ kế hoạch thành các nhiệm vụ có thể thực hiện được (
/speckit-tasks). - Thực hiện các nhiệm vụ (
/speckit-implement). - hội tụ việc thực hiện theo thông số kỹ thuật, kế hoạch và nhiệm vụ (
/speckit-converge).
[!LƯU Ý] Lặp lại bước 4 và 5 cho đến khi
/speckit-convergebáo cáo hội tụ.
🐞 Sửa lỗi bằng Spec Kit
Sửa lỗi có rủi ro khi tác nhân chuyển thẳng từ báo cáo sang bản vá mà không xác thực chẩn đoán hoặc xác nhận rằng bản sửa lỗi giải quyết được triệu chứng ban đầu. Tiện ích mở rộng lỗi chọn tham gia đi kèm cung cấp khả năng lặp lại đánh giá → sửa chữa → kiểm tra quy trình làm việc giúp mỗi bản sửa lỗi luôn có phạm vi, dựa trên bằng chứng và được ghi lại từ nguyên nhân gốc rễ thông qua quá trình xác minh.
Sửa lỗi Khởi động nhanh
Thay thế vX.Y.Z với thẻ phát hành mới nhất, giữ vị trí dẫn đầu v.
uv tool install specify-cli --from git+https://github.com/github/[email protected]
specify init my-project --integration copilot
cd my-project
specify extension add bug
Khởi chạy tác nhân mã hóa của bạn trong thư mục dự án, sau đó:
- Đánh giá lỗi (
/speckit-bug-assess "<bug report>" slug=login-crash). - sửa chữa nguyên nhân được đánh giá (
/speckit-bug-fix slug=login-crash). - kiểm tra cách khắc phục (
/speckit-bug-test slug=login-crash).
💡 Đánh giá ý tưởng bằng Spec Kit
Những ý tưởng hay xứng đáng được chứng minh trước khi cam kết, cho dù chúng có trở thành phần mềm hay không. Tiện ích mở rộng đánh giá chọn tham gia được đóng gói sẽ biến ý tưởng thô thành tài liệu đi/làm rõ nhu cầu/giết quyết định thông qua độc lập tiếp thu → nghiên cứu → xác định → hình dạng → quyết định quy trình làm việc.
Bắt đầu nhanh đánh giá ý tưởng
Thay thế vX.Y.Z với thẻ phát hành mới nhất, giữ vị trí dẫn đầu v.
uv tool install specify-cli --from git+https://github.com/github/[email protected]
specify init my-project --integration copilot
cd my-project
specify extension add assess
Khởi chạy tác nhân mã hóa của bạn trong thư mục dự án, sau đó:
- Lượng tiêu thụ ý tưởng (
/speckit-assess-intake "<idea>" slug=offline-mode). - Nghiên cứu bằng chứng ủng hộ và phản đối (
/speckit-assess-research slug=offline-mode). - Xác định vấn đề, mục tiêu và thước đo thành công (
/speckit-assess-define slug=offline-mode). - hình dạng các giải pháp khả thi và sự đánh đổi của chúng (
/speckit-assess-shape slug=offline-mode). - Quyết định nên tiếp tục, làm rõ hay dừng lại (
/speckit-assess-decide slug=offline-mode).
[!LƯU Ý] Đánh giá ý tưởng là độc lập. Nếu bạn chọn xây dựng một ý tưởng bằng một đi quyết định, bạn có thể giao nó cho
/speckit-specify.
⚡ Bắt đầu
1. Cài đặt Chỉ định CLI
Yêu cầu tia cực tím (cài đặt tia cực tím). Thay thế vX.Y.Z với thẻ phát hành mới nhất từ phát hành - giữ vị trí dẫn đầu v (ví dụ: v0.12.11, không 0.12.11):
uv tool install specify-cli --from git+https://github.com/github/[email protected]
Thích cài đặt từ PyPI hơn? các specify-cli gói cũng được xuất bản ở đó:
uv tool install specify-cli
Xem Hướng dẫn cài đặt để biết các phương pháp thay thế, xác minh, nâng cấp và khắc phục sự cố.
2. Khởi tạo một dự án
specify init my-project --integration copilot
cd my-project
Đối với khai thác tác nhân CI hoặc AI (không có bàn phím hoặc PTY không thể gửi phím mũi tên), hãy chuyển --non-interactive vì vậy init không bao giờ bị treo trên bộ chọn. Kết hợp với --force khi khởi tạo vào một thư mục không trống:
specify init my-project --non-interactive --ignore-agent-tools
specify init --here --force --non-interactive --integration claude
Để kiểm tra các bản cập nhật hoặc nâng cấp CLI đã cài đặt, hãy sử dụng các lệnh tự quản lý. Xem Hướng dẫn nâng cấp để biết các kịch bản chi tiết và các tùy chọn tùy chỉnh.
# Check whether a newer release is available (read-only — does not modify anything)
specify self check
# Preview what would run, without actually upgrading
specify self upgrade --dry-run
# Upgrade in place to the latest stable release (auto-detects uv tool vs pipx install)
specify self upgrade
# Or pin a specific release tag (replace vX.Y.Z[suffix] with your desired release tag)
specify self upgrade --tag vX.Y.Z[suffix]
trần specify self upgrade thực thi ngay lập tức, khớp với hành vi không có dấu nhắc của các lệnh như pip install -U và npm update. cho uv tool cài xong nó chạy uv tool install specify-cli --force --from <git ref> dưới mui xe để các thẻ phát hành được ghim hoạt động, bao gồm các hậu tố siêu dữ liệu dev, alpha/beta/rc hoặc build. uvx (tạm thời) các lần chạy và kiểm tra nguồn được phát hiện và đưa ra hướng dẫn theo đường dẫn cụ thể thay vì chạy trình cài đặt. Đặt SPECIFY_UPGRADE_TIMEOUT_SECS để giới hạn thời gian quy trình con của trình cài đặt có thể chạy (mặc định: không hết thời gian chờ - ngắt với Ctrl+C nếu cần).
3. Thiết lập nguyên tắc dự án
Khởi chạy tác nhân mã hóa của bạn trong thư mục dự án. Hầu hết các đại lý đều phơi bày spec-kit dưới dạng /speckit.* lệnh gạch chéo; Codex CLI và Command Code khi sử dụng chế độ kỹ năng $speckit-* thay vào đó; Công dụng của GitHub Copilot CLI /agents để chọn đại lý hoặc giải quyết trực tiếp trong lời nhắc.
Sử dụng /speckit.constitution lệnh để tạo ra các nguyên tắc quản lý và hướng dẫn phát triển cho dự án của bạn nhằm hướng dẫn tất cả các bước phát triển tiếp theo.
/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements
4. Tạo thông số kỹ thuật
Sử dụng /speckit.specify lệnh để mô tả những gì bạn muốn xây dựng. Tập trung vào cái gì và tại sao, không phải ngăn xếp công nghệ.
/speckit.specify Build an application that can help me organize my photos in separate photo albums. Albums are grouped by date and can be re-organized by dragging and dropping on the main page. Albums are never in other nested albums. Within each album, photos are previewed in a tile-like interface.
5. Lập kế hoạch thực hiện kỹ thuật
Sử dụng /speckit.plan lệnh để cung cấp các lựa chọn về kiến trúc và ngăn xếp công nghệ của bạn.
/speckit.plan The application uses Vite with minimal number of libraries. Use vanilla HTML, CSS, and JavaScript as much as possible. Images are not uploaded anywhere and metadata is stored in a local SQLite database.
6. Chia nhỏ nhiệm vụ
sử dụng /speckit.tasks để tạo danh sách nhiệm vụ có thể thực hiện được từ kế hoạch triển khai của bạn.
/speckit.tasks
7. Thực hiện triển khai
sử dụng /speckit.implement để thực hiện tất cả các nhiệm vụ và xây dựng tính năng của bạn theo kế hoạch.
/speckit.implement
Để biết hướng dẫn chi tiết từng bước, hãy xem hướng dẫn toàn diện.
📽️ Video tổng quan
Bạn muốn xem Spec Kit hoạt động? Xem của chúng tôi tổng quan về video!
🌍 Cộng đồng
Khám phá các tài nguyên do cộng đồng đóng góp trên Trang web tài liệu Spec Kit:
- Tiện ích mở rộng — lệnh, hook và khả năng
- cài đặt trước - ghi đè mẫu và thuật ngữ
- Gói — ngăn xếp vai trò và nhóm được tạo từ các thành phần hiện có
- hướng dẫn - kịch bản SDD đầu cuối
- Bạn bè — các dự án mở rộng hoặc xây dựng trên Spec Kit
[!LƯU Ý] Đóng góp của cộng đồng được các tác giả tương ứng của họ tạo ra và duy trì một cách độc lập. Xem lại mã nguồn trước khi cài đặt và sử dụng theo ý mình.
Bạn muốn đóng góp? Xem Hướng dẫn xuất bản tiện ích mở rộng, cái Hướng dẫn xuất bản cài đặt trước, hoặc Hướng dẫn về gói cộng đồng.
🤖 Hỗ trợ tích hợp tác nhân mã hóa AI
Spec Kit hoạt động với hơn 30 tác nhân mã hóa AI — cả công cụ CLI và trợ lý dựa trên IDE. Xem danh sách đầy đủ kèm theo ghi chú và chi tiết sử dụng trong Tích hợp tác nhân mã hóa AI được hỗ trợ hướng dẫn.
Chạy specify integration list để xem tất cả các tích hợp có sẵn trong phiên bản đã cài đặt của bạn.
Các lệnh gạch chéo có sẵn
Sau khi chạy specify init, tác nhân mã hóa AI của bạn sẽ có quyền truy cập vào các lệnh gạch chéo này để phát triển có cấu trúc. Đối với các tích hợp hỗ trợ chế độ kỹ năng, vượt qua --integration <agent> --integration-options="--skills" cài đặt các kỹ năng tác nhân thay vì các tệp nhắc lệnh gạch chéo.
Lệnh cốt lõi
Các lệnh cần thiết cho quy trình làm việc Spec-Driven Development:
| Lệnh | Kỹ năng đặc vụ | Mô tả |
|---|---|---|
/speckit.constitution |
speckit-constitution |
Tạo hoặc cập nhật các nguyên tắc quản lý dự án và hướng dẫn phát triển |
/speckit.specify |
speckit-specify |
Xác định những gì bạn muốn xây dựng (yêu cầu và câu chuyện của người dùng) |
/speckit.plan |
speckit-plan |
Tạo kế hoạch triển khai kỹ thuật với nhóm công nghệ bạn đã chọn |
/speckit.tasks |
speckit-tasks |
Tạo danh sách nhiệm vụ có thể thực hiện được để thực hiện |
/speckit.taskstoissues |
speckit-taskstoissues |
Chuyển đổi danh sách nhiệm vụ đã tạo thành vấn đề GitHub để theo dõi và thực thi |
/speckit.implement |
speckit-implement |
Thực hiện tất cả các nhiệm vụ để xây dựng tính năng theo kế hoạch |
/speckit.converge |
speckit-converge |
Đánh giá cơ sở mã dựa trên thông số kỹ thuật/kế hoạch/nhiệm vụ và bổ sung công việc còn lại dưới dạng nhiệm vụ mới |
Lệnh tùy chọn
Các lệnh bổ sung để nâng cao chất lượng và xác thực:
| Lệnh | Kỹ năng đặc vụ | Mô tả |
|---|---|---|
/speckit.clarify |
speckit-clarify |
Làm rõ các lĩnh vực chưa được xác định (được khuyến nghị trước khi /speckit.plan; trước đây /quizme) |
/speckit.analyze |
speckit-analyze |
Phân tích mức độ bao phủ và tính nhất quán của nhiều tạo phẩm (chạy sau /speckit.tasks, trước /speckit.implement) |
/speckit.checklist |
speckit-checklist |
Tạo danh sách kiểm tra chất lượng tùy chỉnh để xác thực tính đầy đủ, rõ ràng và nhất quán của các yêu cầu (như "bài kiểm tra đơn vị cho tiếng Anh") |
🔧 Chỉ định tham chiếu CLI
Để biết chi tiết lệnh, tùy chọn và ví dụ đầy đủ, hãy xem CLI Tham khảo.
🧩 Tự tạo bộ thông số kỹ thuật: Tiện ích mở rộng & cài đặt trước
Spec Kit có thể được điều chỉnh theo nhu cầu của bạn thông qua hai hệ thống bổ sung — tiện ích mở rộng và cài đặt trước — cộng với các phần ghi đè cục bộ của dự án để điều chỉnh một lần:
| Ưu tiên | Loại thành phần | Vị trí |
|---|---|---|
| ⬆ 1 | Ghi đè dự án-cục bộ | .specify/templates/overrides/ |
| 2 | Cài đặt trước - Tùy chỉnh lõi và tiện ích mở rộng | .specify/presets/templates/ |
| 3 | Tiện ích mở rộng - Thêm khả năng mới | .specify/extensions/templates/ |
| ⬇ 4 | Spec Kit Core — Lệnh và mẫu SDD tích hợp | .specify/templates/ |
- Mẫu được giải quyết tại thời gian chạy — Spec Kit đi theo ngăn xếp từ trên xuống và sử dụng kết quả phù hợp đầu tiên.
- Ghi đè dự án cục bộ (
.specify/templates/overrides/) cho phép bạn thực hiện điều chỉnh một lần cho một dự án mà không cần tạo cài đặt trước đầy đủ. - Lệnh mở rộng/đặt trước được áp dụng tại thời gian cài đặt - khi bạn chạy
specify extension addhoặcspecify preset add, các tệp lệnh được ghi vào các thư mục tác nhân (ví dụ:.claude/commands/). - Nếu nhiều cài đặt trước hoặc tiện ích mở rộng cung cấp cùng một lệnh thì phiên bản có mức ưu tiên cao nhất sẽ thắng. Khi xóa, phiên bản có mức ưu tiên cao nhất tiếp theo sẽ tự động được khôi phục.
- Nếu không có phần ghi đè hoặc tùy chỉnh nào tồn tại, Spec Kit sẽ sử dụng các giá trị mặc định cốt lõi của nó.
Tiện ích mở rộng - Thêm khả năng mới
sử dụng tiện ích mở rộng khi bạn cần chức năng vượt xa cốt lõi của Spec Kit. Tiện ích mở rộng giới thiệu các lệnh và mẫu mới — ví dụ: thêm quy trình công việc theo miền cụ thể không có trong các lệnh SDD tích hợp, tích hợp với các công cụ bên ngoài hoặc thêm các giai đoạn phát triển hoàn toàn mới. Họ mở rộng Spec Kit có thể làm gì.
# Search available extensions
specify extension search
# Install an extension
specify extension add <extension-name>
Ví dụ: các tiện ích mở rộng có thể thêm tích hợp Jira, đánh giá mã sau triển khai, truy xuất nguồn gốc thử nghiệm V-Model hoặc chẩn đoán tình trạng dự án.
Xem Tham chiếu tiện ích mở rộng để có hướng dẫn lệnh đầy đủ. Duyệt qua tiện ích mở rộng cộng đồng cho những gì có sẵn.
Cài đặt trước - Tùy chỉnh quy trình công việc hiện có
sử dụng cài đặt trước khi bạn muốn thay đổi làm thế nào Spec Kit hoạt động mà không cần thêm các khả năng mới. Các cài đặt trước ghi đè các mẫu và lệnh đi kèm với lõi và với các tiện ích mở rộng đã cài đặt — ví dụ: thực thi định dạng thông số hướng tới tuân thủ, sử dụng thuật ngữ dành riêng cho miền hoặc áp dụng các tiêu chuẩn tổ chức cho các kế hoạch và nhiệm vụ. Họ tùy chỉnh các tạo phẩm và hướng dẫn mà Spec Kit và các tiện ích mở rộng của nó tạo ra.
# Search available presets
specify preset search
# Install a preset
specify preset add <preset-name>
Ví dụ: các giá trị đặt trước có thể cơ cấu lại các mẫu thông số kỹ thuật để yêu cầu truy xuất nguồn gốc theo quy định, điều chỉnh quy trình làm việc để phù hợp với phương pháp bạn sử dụng (ví dụ: Agile, Kanban, Waterfall, công việc cần làm hoặc thiết kế theo hướng miền), thêm cổng đánh giá bảo mật bắt buộc vào kế hoạch, thực thi thứ tự nhiệm vụ thử nghiệm đầu tiên hoặc bản địa hóa toàn bộ quy trình làm việc sang một ngôn ngữ khác. các bản demo nói chuyện cướp biển cho thấy khả năng tùy chỉnh có thể sâu đến mức nào. Nhiều cài đặt trước có thể được xếp chồng lên nhau theo thứ tự ưu tiên.
Xem Tham khảo cài đặt trước để có hướng dẫn lệnh đầy đủ, bao gồm thứ tự giải quyết và xếp chồng ưu tiên.
📦 Gói: Thiết lập dựa trên vai trò
Tiện ích mở rộng và cài đặt trước là các khối xây dựng riêng lẻ. A bó đóng gói một tập hợp đã được tuyển chọn — tiện ích mở rộng, cài đặt trước, các bước và quy trình làm việc — vào một thiết lập duy nhất, có phiên bản, hướng đến vai trò để toàn bộ nhân vật trong nhóm (người quản lý sản phẩm, nhà phân tích kinh doanh, nhà nghiên cứu bảo mật, nhà phát triển,…) có thể được cung cấp bằng một lệnh.
Một bó được mô tả bằng một chữ viết tay bundle.yml biểu hiện. Nó ghim từng thành phần vào một phiên bản và, tùy chọn, nhắm mục tiêu tích hợp cụ thể; một bó không có integration là bất khả tri và kế thừa mọi tích hợp mà dự án đã sử dụng.
# Discover bundles in the active catalog stack
specify bundle search [<query>]
# Inspect the exact component set a bundle will add (equals what install does)
specify bundle info <bundle-id>
# Install a bundle's full component set in one operation
specify bundle install <bundle-id>
# See what's installed, then update or remove non-destructively
specify bundle list
specify bundle update <bundle-id> # or --all
specify bundle remove <bundle-id> # removes only this bundle's components
Các gói giải quyết từ một ngăn xếp danh mục theo thứ tự ưu tiên (dự án> người dùng> tích hợp sẵn). Mỗi nguồn mang một chính sách cài đặt: install-allowed nguồn có thể được cài đặt từ, trong khi discovery-only nguồn có thể nhìn thấy trong search/info
nhưng từ chối cài đặt. Quản lý ngăn xếp với specify bundle catalog list|add|remove.
Tác giả xác nhận và đóng gói các gói cục bộ. Phân phối đang lưu trữ tạo phẩm được xây dựng và thêm nguồn danh mục; việc gửi gói cộng đồng sử dụng Gửi gói mẫu phát hành để có thể xem lại danh mục thành phần bắt buộc và bằng chứng cài đặt:
specify bundle validate --path ./my-bundle # structural + reference checks
specify bundle build --path ./my-bundle # produce a versioned .zip artifact
Bốn bản kê khai gói ví dụ sẵn sàng đọc trực tiếp bên dưới
examples/bundles/ (quản lý sản phẩm, nhà phân tích kinh doanh, nhà nghiên cứu bảo mật, nhà phát triển). Đây là các ví dụ về đóng gói gói, không chứa thông số kỹ thuật tính năng được tạo; để biết các ví dụ về cộng đồng từ đầu đến cuối, hãy xem
hướng dẫn cộng đồng.
Những đảm bảo chính: info cho thấy chính xác những gì install bổ sung (minh bạch); số lượt cài đặt không có tác dụng và chỉ giới hạn ở thư mục gốc của dự án; remove không bao giờ chạm vào các thành phần mà gói cài đặt khác vẫn cần; và tất cả các lệnh tiêu thụ/tác giả đều hoạt động ngoại tuyến chống lại các nguồn cục bộ hoặc được ghim.
Khi nào nên sử dụng cái nào
| Mục tiêu | sử dụng |
|---|---|
| Thêm lệnh hoặc quy trình làm việc hoàn toàn mới | Tiện ích mở rộng |
| Tùy chỉnh định dạng của thông số kỹ thuật, kế hoạch hoặc nhiệm vụ | cài sẵn |
| Tích hợp một công cụ hoặc dịch vụ bên ngoài | Tiện ích mở rộng |
| Thực thi các tiêu chuẩn tổ chức hoặc quy định | cài sẵn |
| Gửi các mẫu dành riêng cho miền có thể tái sử dụng | Hoặc - cài đặt trước cho phần ghi đè mẫu, tiện ích mở rộng cho mẫu đi kèm với lệnh mới |
| Cung cấp thiết lập dựa trên vai trò hoàn chỉnh trong một lệnh | Gói |
📚 Triết lý cốt lõi
Spec-Driven Development là một quy trình có cấu trúc nhấn mạnh:
- Phát triển theo mục đích trong đó thông số kỹ thuật xác định "cái gì" trước cái "làm thế nào"
- Tạo đặc điểm kỹ thuật phong phú sử dụng các rào chắn và nguyên tắc tổ chức
- Tinh chỉnh nhiều bước thay vì tạo mã một lần từ lời nhắc
- Sự phụ thuộc nặng nề về khả năng của mô hình AI nâng cao để giải thích thông số kỹ thuật
🌟 Các giai đoạn phát triển
| Giai đoạn | Tập trung | Hoạt động chính |
|---|---|---|
| Phát triển 0-1 ("Cánh đồng xanh") | Tạo từ đầu |
|
| Khám phá sáng tạo | Triển khai song song |
|
| Cải tiến lặp đi lặp lại ("Brownfield") | Hiện đại hóa Brownfield |
|
Đối với các dự án hiện có, hãy tách biệt các bản cập nhật công cụ Spec Kit với quá trình phát triển tạo phẩm tính năng: làm mới các tệp dự án được quản lý khi nâng cấp và cập nhật
specs/ tạo tác khi hành vi dự định thay đổi. các
Hướng dẫn thông số kỹ thuật phát triển mô tả vòng lặp brownfield được đề xuất.
🎯 Mục tiêu thử nghiệm
Nghiên cứu và thử nghiệm của chúng tôi tập trung vào:
Độc lập về công nghệ
- Tạo ứng dụng bằng cách sử dụng ngăn xếp công nghệ đa dạng
- Xác thực giả thuyết rằng Spec-Driven Development là một quy trình không gắn liền với các công nghệ, ngôn ngữ lập trình hoặc khung cụ thể
Những hạn chế của doanh nghiệp
- Chứng minh sự phát triển ứng dụng quan trọng
- Kết hợp các ràng buộc về mặt tổ chức (nhà cung cấp đám mây, nhóm công nghệ, thực hành kỹ thuật)
- Hỗ trợ hệ thống thiết kế doanh nghiệp và các yêu cầu tuân thủ
Phát triển lấy người dùng làm trung tâm
- Xây dựng ứng dụng cho các nhóm người dùng và sở thích khác nhau
- Hỗ trợ các phương pháp phát triển khác nhau (từ mã hóa rung cảm đến phát triển dựa trên AI)
Quy trình sáng tạo và lặp đi lặp lại
- Xác thực khái niệm khám phá triển khai song song
- Cung cấp quy trình phát triển tính năng lặp lại mạnh mẽ
- Mở rộng quy trình để xử lý các nhiệm vụ nâng cấp và hiện đại hóa
🔧 Điều kiện tiên quyết
- Linux/macOS/Windows
- Được hỗ trợ Đại lý mã hóa AI.
- tia cực tím để quản lý gói (được khuyến nghị) hoặc pipx để cài đặt liên tục
- Python 3.11+
- Git
Nếu bạn gặp vấn đề với một đại lý, vui lòng mở một vấn đề để chúng tôi có thể tinh chỉnh việc tích hợp.
📖 Tìm hiểu thêm
- Hoàn thành phương pháp Spec-Driven Development - Đi sâu vào toàn bộ quá trình
- Hướng dẫn bắt đầu nhanh - Hướng dẫn thực hiện từng bước
💬 Hỗ trợ
Để được hỗ trợ, vui lòng mở một vấn đề về GitHub. Chúng tôi hoan nghênh các báo cáo lỗi, yêu cầu tính năng và câu hỏi về việc sử dụng Spec-Driven Development.
🙏 Lời cảm ơn
Dự án này chịu ảnh hưởng nặng nề và dựa trên công việc và nghiên cứu của John Lâm.
📄 Giấy phép
Dự án này được cấp phép theo các điều khoản của giấy phép nguồn mở MIT. Vui lòng tham khảo GIẤY PHÉP tập tin cho các điều khoản đầy đủ.
Dự án cùng danh mục
Trợ lý AI cá nhân của riêng bạn. Bất kỳ hệ điều hành nào. Bất kỳ nền tảng nào. Cách tôm hùm. 🦞
Hệ thống tối ưu hóa hiệu suất khai thác tác nhân. Kỹ năng, bản năng, trí nhớ, bảo mật và sự phát triển ưu tiên nghiên cứu cho Claude Code, Codex, Opencode, Cursor và hơn thế nữa.
Đại lý phát triển cùng bạn
Kỹ năng dành cho kỹ sư thực sự. Trực tiếp từ thư mục .agents của tôi.
Triển lãm bảo tàng do đại lý quản lý, được xây dựng trong Rust với Gajae-Code / LazyCodex — được phát triển và duy trì mà không có sự can thiệp của con người.
