Hồ sơ

Chọn quy trình làm việc nào được cài đặt, và chúng được cài đặt dưới dạng skills, commands hay cả hai.

Hồ sơ là sở thích của bạn về việc quy trình làm việc OpenSpec nào (các skills và commands trong công cụ AI của bạn) được cài đặt trên máy của bạn. Hồ sơ mặc định là core. Bao gồm hoặc loại trừ các quy trình làm việc và lựa chọn của bạn được lưu dưới dạng hồ sơ custom.

Bộ cốt lõi

Hồ sơ core cài đặt sáu quy trình làm việc, bao gồm toàn bộ vòng lặp từ ý tưởng đến lưu trữ:

Quy trình làm việc	Mục đích
explore	Suy nghĩ về một ý tưởng trước khi nó trở thành đề xuất thay đổi
propose	Tạo đề xuất thay đổi và tạo tất cả các artifact lập kế hoạch của nó trong một bước
apply	Thực hiện các tác vụ của đề xuất thay đổi
update	Sửa đổi các artifact lập kế hoạch hiện có của đề xuất thay đổi
sync	Hợp nhất các cập nhật đặc tả của đề xuất thay đổi vào specs/ mà không lưu trữ
archive	Chuyển đề xuất thay đổi đã hoàn thành vào lưu trữ

Mỗi quy trình đều liên kết đến hợp đồng đầy đủ của nó: đối số, những gì nó tạo ra và những gì nó phản hồi.

Mở rộng bộ: các quy trình tùy chọn

Sáu quy trình làm việc khác có sẵn ngoài bộ cốt lõi. Ba trong số đó (new, continue, ff) tạo ra các artifact đề xuất thay đổi từng cái một, thay vì tất cả cùng một lúc như propose.

Quy trình làm việc	Mục đích
new	Bắt đầu đề xuất thay đổi dưới dạng bộ khung trống
continue	Tạo artifact lập kế hoạch tiếp theo trong đề xuất thay đổi, từng cái một
ff	Tạo đề xuất thay đổi và mọi artifact lập kế hoạch mà quá trình triển khai cần, trong một lần
verify	Kiểm tra xem quá trình triển khai có khớp với các artifact của đề xuất thay đổi không
bulk-archive	Lưu trữ một số đề xuất thay đổi cùng một lúc
onboard	Học quy trình bằng cách thực hiện một đề xuất thay đổi thực tế từ đầu đến cuối

Để thay đổi bộ, hãy chạy trình chọn tương tác:

openspec config profile

Trình chọn hỏi bạn muốn định cấu hình gì (phân phối, quy trình làm việc hoặc cả hai), sau đó liệt kê tất cả mười hai quy trình làm việc dưới dạng hộp kiểm, với những quy trình đã cài đặt được đánh dấu. Bất kỳ lựa chọn nào không đúng là sáu quy trình cốt lõi sẽ được lưu dưới dạng hồ sơ custom, vì vậy bạn cũng có thể bỏ chọn các quy trình cốt lõi mà bạn không sử dụng.

Phân phối: skills, commands hoặc cả hai

Phân phối là một cài đặt hồ sơ cho phép bạn chọn chỉ cài đặt skills hoặc chỉ commands. Mặc định là both. Thiết lập dự án của bạn giải thích hai dạng này và lý do tại sao cả hai tồn tại. Hợp đồng chính xác của trường này nằm trong Cài đặt CLI (config.json).

Hai cách để thay đổi:

Tương tác: chạy openspec config profile và chọn "Chỉ phân phối". Đây là cách chuyển sang chỉ skills:

Current profile settings
  Delivery: both

? What do you want to configure? Delivery only
? Delivery mode (how workflows are installed): Skills only

Config changes:
  delivery: both -> skills
? Apply changes to this project now? (Y/n) y

Trực tiếp: một lệnh, không nhắc nhở:

openspec config set delivery skills   # or: both, commands

Phân phối không bao giờ thay đổi tên hồ sơ. core và custom chỉ mô tả bộ quy trình làm việc, và việc chuyển lại sang core vẫn giữ cài đặt phân phối của bạn.

Chuyển đổi hồ sơ

Việc chuyển đổi gồm hai bước: thay đổi hồ sơ trên máy của bạn, sau đó cập nhật từng dự án để áp dụng.

1. Thay đổi hồ sơ:

   openspec config profile        # interactive
   openspec config profile core   # reset to the core six (keeps delivery)

2. Chạy cập nhật trong mỗi dự án bạn làm việc:

   openspec update

Khi thư mục hiện tại là một dự án OpenSpec hiện có, quy trình tương tác sẽ đề xuất chạy bước 2 cho bạn.