Thuật ngữ
Mỗi thuật ngữ OpenSpec, mỗi dòng một mục.
OpenSpec tái sử dụng các từ có nghĩa khác trong git, CI và công cụ agent. Mỗi hàng đưa ra ý nghĩa OpenSpec. Cột cuối cùng liên kết đến chi tiết hơn nếu có.
| Thuật ngữ | Định nghĩa | Thêm |
|---|---|---|
| Apply | Triển khai các nhiệm vụ trong một đề xuất thay đổi. Kỹ năng: openspec-apply-change. | Apply a change |
| Archive | Hoàn tất một đề xuất thay đổi: hợp nhất các delta của nó vào các spec chính và di chuyển thư mục của nó đến openspec/changes/archive/. | Quickstart |
| Artifact | Một tài liệu kế hoạch bên trong một đề xuất thay đổi: proposal.md, delta specs, design.md, tasks.md. Không phải là kết quả build. | Artifacts |
| Capability | Một khu vực hành vi của hệ thống của bạn. Mỗi khu vực có một spec tại openspec/specs/<capability>/spec.md. | Capabilities |
| Change proposal | Một đơn vị công việc: một thư mục dưới openspec/changes/<name>/ chứa các tạo tác kế hoạch của nó. Thường được rút gọn thành "change". Không phải là một commit git. | Propose |
| Command | Một điểm vào được gõ cho một quy trình làm việc. Cách viết thay đổi tùy theo công cụ (/opsx:propose, /opsx-propose). Tài liệu đặt tên quy trình làm việc theo kỹ năng thay vào đó. | Supported tools |
| Continue | Tạo tạo tác kế hoạch tiếp theo cho một đề xuất thay đổi hiện có. Kỹ năng: openspec-continue-change. | Skills |
| Delivery | Cách các quy trình làm việc được cài đặt: dưới dạng kỹ năng, lệnh hoặc cả hai. | Set up your project |
| Delta spec | Một spec bên trong một đề xuất thay đổi liệt kê chỉ những gì thay đổi, dưới các tiêu đề ADDED, MODIFIED, REMOVED và RENAMED. | Delta specs |
| Explore | Suy nghĩ thấu đáo một ý tưởng với agent trước khi đề xuất. Không viết mã. Kỹ năng: openspec-explore. | Explore an idea |
| Fast-forward | Tạo một đề xuất thay đổi với mọi tạo tác kế hoạch trong một lần, sẵn sàng để triển khai. Kỹ năng: openspec-ff-change. Không phải là fast-forward của git. | Skills |
| Legacy workflow | Các lệnh /openspec:* trước OPSX. | |
| Loop | Vòng lặp mà một đề xuất thay đổi trải qua: khám phá, đề xuất, xem xét, áp dụng, lưu trữ. | Quickstart |
| Main specs | Cây openspec/specs/: hành vi hiện tại, đã thống nhất của hệ thống của bạn. Lưu trữ hợp nhất các delta vào đó. Một khả năng chưa có spec sẽ nhận được một spec từ các yêu cầu ADDED của nó. | Archive |
| OpenSpec root | Cây openspec/ mà một lệnh phân giải và hoạt động trên đó: của repo của bạn hoặc của một store. | Stores |
| OPSX | Hệ thống quy trình làm việc OpenSpec hiện tại và tiền tố lệnh mà nó cài đặt (/opsx:). | |
| Profile | Các quy trình làm việc mà init cài đặt: core hoặc custom. | Profiles |
| Propose | Tạo một đề xuất thay đổi và tạo tất cả các tạo tác kế hoạch của nó trong một bước. Kỹ năng: openspec-propose. | Quickstart |
| Registry | Danh sách ở cấp máy của các store đã đăng ký, trong registry.yaml. Không phải là registry gói. | CLI |
| Requirement | Một hành vi mà hệ thống phải có, được viết với SHALL: ### Requirement: trong một spec. | Delta specs |
| Scenario | Một ví dụ có thể kiểm thử dưới một yêu cầu, ở dạng WHEN/THEN. | Delta specs |
| Schema | Định nghĩa về những tạo tác mà một đề xuất thay đổi tạo ra và theo thứ tự nào. Không phải là JSON Schema. | Schemas |
| Skill | Hướng dẫn của một quy trình làm việc, được cài đặt nơi công cụ AI của bạn đọc chúng (.agents/skills/, ...). | Skills |
| Spec | Một tệp mô tả cách một khả năng hoạt động hiện tại, tại openspec/specs/<capability>/spec.md. | Archive |
| spec-driven | Lược đồ mặc định: đề xuất, sau đó delta specs, sau đó thiết kế, sau đó nhiệm vụ. | spec-driven |
| Store | Một repo OpenSpec độc lập được đăng ký trên máy của bạn, để lập kế hoạch trải rộng nhiều kho lưu trữ. Không phải là một kho dữ liệu. | Stores (beta) |
| Sync | Hợp nhất các delta đã triển khai vào các spec chính mà không lưu trữ. Kỹ năng: openspec-sync-specs. | Skills |
| Template | Nội dung khởi đầu mà một lược đồ cung cấp cho mỗi tạo tác. | Schemas |
| Update | Là một kỹ năng (openspec-update-change): sửa đổi các tạo tác kế hoạch của một đề xuất thay đổi. Là một lệnh CLI (openspec update): làm mới các tệp đã cài đặt của OpenSpec. | Update a change, CLI |
| Verify | Kiểm tra việc triển khai khớp với các tạo tác của một đề xuất thay đổi trước khi lưu trữ. Kỹ năng: openspec-verify-change. | Skills |
| Workflow | Một hành động OpenSpec có tên (đề xuất, áp dụng, lưu trữ, ...), được cài đặt vào công cụ AI của bạn dưới dạng kỹ năng hoặc lệnh. | Set up your project |
| Workset | Một nhóm thư mục cá nhân, cục bộ được mở cùng nhau trong một công cụ. Không phải là một store và không có gì được chia sẻ. | Worksets (beta) |