OpenSpec

Worksets (beta) ​

Mở store và các repo sử dụng nó trong một cửa sổ trình soạn thảo, để agent của bạn thấy cả hai.

Với một store, ngữ cảnh mà agent của bạn cần được chia sẻ giữa các thư mục. Các đặc tả và thay đổi nằm trong store, còn mã nằm trong từng repo. Một agent khởi động trong một repo chỉ có thể đọc và grep repo đó mà không gì khác, vì vậy nó hoạt động với một nửa bức tranh.

Worksets là tiện ích mà OpenSpec cung cấp cho việc này. Một workset là một danh sách đã lưu, có tên gồm các thư mục bạn mở cùng nhau. Trang này giả định rằng store đã được thiết lập và đăng ký trên máy của bạn. Stores (beta) bao gồm điều đó.

Cách hoạt động ​

  • Nó là gì: một danh sách có tên gồm các thư mục, chỉ được lưu trên máy của bạn. Không có gì được ghi vào các thư mục thành viên, và không có gì được cam kết.
  • Việc mở làm gì: OpenSpec tạo một tệp .code-workspace từ danh sách và khởi chạy trình soạn thảo của bạn trên đó. Mọi thư mục thành viên nằm trong một cửa sổ.
  • Những gì bạn nhận được: tìm kiếm của trình soạn thảo và bất kỳ agent nào bạn chạy trong cửa sổ đó đều có thể đọc mọi thư mục thành viên. Agent có thể grep các đặc tả của store và mã của repo trong một phiên.
  • Điều nó không thay đổi: thư mục openspec/ mà một lệnh sử dụng. Điều đó vẫn tuân theo Nơi các artifact được tạo.

Thiết lập ​

  1. Lưu workset (một lần cho mỗi máy). Liệt kê repo và store làm thành viên, và công cụ để mở chúng:

    bash
    # lưu một danh sách có tên gồm các thư mục bạn mở cùng nhau
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Đã lưu workset 'platform' (2 thành viên) vào máy của bạn.
Mở nó bất cứ lúc nào bằng: openspec workset open platform

  2. Mở nó bất cứ khi nào bạn bắt đầu làm việc:

    bash
    # mở mọi thành viên trong một cửa sổ VS Code
openspec workset open platform

openspec workset list hiển thị những gì bạn đã lưu, và openspec workset remove <name> xóa một workset mà không chạm vào các thư mục thành viên:

yaml
platform  (mở trong VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

Sử dụng nó: một thay đổi, hai thư mục ​

Giả sử thay đổi add-login nằm trong store team-plans, và mã cho nó nằm trong web-app. Mở workset platform và yêu cầu agent của bạn triển khai thay đổi. Trong phiên đó, nó có thể:

  • đọc team-plans/openspec/changes/add-login/ và các đặc tả bên cạnh nó
  • chỉnh sửa mã trong web-app/
  • chạy các lệnh openspec từ bên trong web-app

Không có workset, agent chỉ thấy thư mục mà nó được khởi động.

Các công cụ có sẵn ​

  • VS Code (--tool code) và Cursor (--tool cursor): được tích hợp sẵn. Mỗi cái mở một cửa sổ với mọi thư mục thành viên.
  • Claude Code và Codex trong terminal: tạm thời bị vô hiệu hóa làm trình mở workset trong khi luồng đó được làm lại. --tool claude hoặc --tool codex dừng lại với một lỗi nói rõ điều đó và chỉ bạn đến VS Code hoặc Cursor.
  • Các trình soạn thảo khác: thêm chúng dưới khóa openers trong Cài đặt CLI (config.json).