Lệnh

Đây là tài liệu tham khảo cho các lệnh slash của OpenSpec. Các lệnh này được kích hoạt trong giao diện trò chuyện của trợ lý lập trình AI (ví dụ: Claude Code, Cursor, Devin Desktop).

Để biết các mẫu quy trình làm việc và thời điểm sử dụng từng lệnh, xem Quy trình làm việc. Đối với các lệnh CLI, xem CLI.

Các trang này sử dụng /opsx:<command> làm tên chuẩn. Một số công cụ viết khác nhau — Cursor và GitHub Copilot đăng ký /opsx-propose, Codex sử dụng $openspec-propose — vì vậy hãy kiểm tra Cách gọi cho công cụ của bạn. Các tệp do OpenSpec tạo đã sử dụng đúng định dạng.

Tham chiếu nhanh

Đường dẫn nhanh mặc định (hồ sơ `core`)

Lệnh	Mục đích
`/opsx:propose`	Tạo thay đổi và tạo các tài liệu lập kế hoạch trong một bước
`/opsx:explore`	Suy nghĩ về các ý tưởng trước khi cam kết thực hiện thay đổi
`/opsx:apply`	Thực hiện các tác vụ từ thay đổi
`/opsx:update`	Sửa đổi các tài liệu lập kế hoạch của thay đổi và giữ chúng nhất quán
`/opsx:sync`	Hợp nhất các đặc tả delta vào các đặc tả chính
`/opsx:archive`	Lưu trữ một thay đổi đã hoàn thành

Lệnh quy trình làm việc mở rộng (chọn quy trình làm việc tùy chỉnh)

Lệnh	Mục đích
`/opsx:new`	Bắt đầu khung thay đổi mới
`/opsx:continue`	Tạo tài liệu tiếp theo dựa trên các phụ thuộc
`/opsx:ff`	Fast-forward: tạo tất cả các tài liệu lập kế hoạch cùng lúc
`/opsx:verify`	Xác nhận việc triển khai khớp với các tài liệu
`/opsx:bulk-archive`	Lưu trữ nhiều thay đổi cùng lúc
`/opsx:onboard`	Hướng dẫn từng bước qua toàn bộ quy trình làm việc

Hồ sơ toàn cầu mặc định là core. Để kích hoạt các lệnh quy trình làm việc mở rộng, chạy openspec config profile, chọn các quy trình làm việc, sau đó chạy openspec update trong dự án của bạn.

Tham Khảo Lệnh

`/opsx:propose`

Tạo một thay đổi mới và sinh các bản kế hoạch trong một bước. Đây là lệnh khởi động mặc định trong hồ sơ core.

Cú pháp:

text

/opsx:propose [change-name-or-description]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name-or-description`	Không	Tên dạng kebab-case hoặc mô tả thay đổi bằng ngôn ngữ tự nhiên

Chức năng:

Tạo openspec/changes/<change-name>/
Sinh các bản kế hoạch cần thiết trước khi triển khai (đối với spec-driven: proposal, specs, design, tasks)
Dừng lại khi thay đổi đã sẵn sàng cho /opsx:apply

Ví dụ:

text

You: /opsx:propose add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md
     ✓ specs/ui/spec.md
     ✓ design.md
     ✓ tasks.md
     Ready for implementation. Run /opsx:apply.

Mẹo:

Sử dụng lệnh này cho đường dẫn end-to-end nhanh nhất
Nếu bạn muốn kiểm soát từng bước các bản kế hoạch, hãy bật workflow mở rộng và sử dụng /opsx:new + /opsx:continue

`/opsx:explore`

Bắt đầu ở đây khi bạn chưa chắc chắn. Explore là một đối tác tư duy không rủi ro: nó đọc codebase của bạn, so sánh các phương án, và biến một ý tưởng mơ hồ thành một kế hoạch cụ thể trước khi bất kỳ thay đổi nào tồn tại. Nó được đóng gói trong hồ sơ mặc định. Để xem trường hợp đầy đủ và nhiều ví dụ hơn, hãy xem hướng dẫn Explore First.

Suy nghĩ về các ý tưởng, điều tra các vấn đề, và làm rõ yêu cầu trước khi cam kết một thay đổi.

Cú pháp:

/opsx:explore [topic]

Tham số:

Tham số	Bắt buộc	Mô tả
`topic`	Không	Nội dung bạn muốn khám phá hoặc điều tra

Chức năng:

Mở một cuộc trò chuyện khám phá không yêu cầu cấu trúc
Điều tra codebase để trả lời các câu hỏi
So sánh các phương án và cách tiếp cận
Tạo các sơ đồ trực quan để làm rõ suy nghĩ
Có thể chuyển sang /opsx:propose (mặc định) hoặc /opsx:new (workflow mở rộng) khi các nhận thức trở nên rõ ràng

Ví dụ:

text

You: /opsx:explore

AI:  What would you like to explore?

You: How should we handle authentication for the mobile app?

AI:  Let me investigate your current auth setup...
     [Analyzes codebase]

     I see you're using session-based auth for the web app.
     For mobile, we have three main options:

     1. JWT tokens (stateless, works offline)
     2. OAuth2 (if you need third-party login)
     3. Extend current sessions (simpler, but requires connectivity)

     Your API already has CORS configured. Which direction interests you?

You: Let's go with JWT. Can we start a change for that?

AI:  Ready when you are. Run /opsx:propose add-jwt-auth to begin.

Mẹo:

Sử dụng khi yêu cầu chưa rõ ràng hoặc bạn cần điều tra
Không tạo bản kế hoạch nào trong quá trình khám phá
Phù hợp để so sánh nhiều cách tiếp cận trước khi quyết định
Có thể đọc tệp và tìm kiếm trong codebase

`/opsx:new`

Bắt đầu một bộ khung thay đổi mới. Tạo thư mục thay đổi và chờ bạn sinh các bản kế hoạch bằng /opsx:continue hoặc /opsx:ff.

Lệnh này là một phần của bộ workflow mở rộng (không được bao gồm trong hồ sơ core mặc định).

Cú pháp:

/opsx:new [change-name] [--schema <schema-name>]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name`	Không	Tên cho thư mục thay đổi (sẽ hỏi nếu không cung cấp)
`--schema`	Không	Schema workflow để sử dụng (mặc định: từ config hoặc `spec-driven`)

Chức năng:

Tạo thư mục openspec/changes/<change-name>/
Tạo tệp metadata .openspec.yaml trong thư mục thay đổi
Hiển thị mẫu bản kế hoạch đầu tiên sẵn sàng để tạo
Hỏi tên thay đổi và schema nếu không được cung cấp

Những gì được tạo:

openspec/changes/<change-name>/
└── .openspec.yaml    # Change metadata (schema, created date)

Ví dụ:

You: /opsx:new add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     Schema: spec-driven

     Ready to create: proposal
     Use /opsx:continue to create it, or /opsx:ff to create all artifacts.

Mẹo:

Sử dụng tên mô tả: add-feature, fix-bug, refactor-module
Tránh các tên chung chung như update, changes, wip
Schema cũng có thể được đặt trong config dự án (openspec/config.yaml)

`/opsx:continue`

Tạo bản kế hoạch tiếp theo trong chuỗi phụ thuộc. Tạo một bản kế hoạch một lúc cho tiến độ tăng dần.

Cú pháp:

/opsx:continue [change-name]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name`	Không	Thay đổi nào để tiếp tục (suy luận từ ngữ cảnh nếu không cung cấp)

Chức năng:

Truy vấn đồ thị phụ thuộc của các bản kế hoạch
Hiển thị bản kế hoạch nào sẵn sàng và bản nào bị chặn
Tạo bản kế hoạch đầu tiên sẵn sàng
Đọc các tệp phụ thuộc để lấy ngữ cảnh
Hiển thị những gì trở nên khả dụng sau khi tạo

Ví dụ:

You: /opsx:continue

AI:  Change: add-dark-mode

     Artifact status:
     ✓ proposal    (done)
     ◆ specs       (ready)
     ◆ design      (ready)
     ○ tasks       (blocked - needs: specs, design)

     Creating specs...

     [Reads proposal.md, creates specs based on requirements]

     ✓ Created openspec/changes/add-dark-mode/specs/ui/spec.md

     Now available: design
     Run /opsx:continue to create the next artifact.

Mẹo:

Sử dụng khi bạn muốn xem xét từng bản kế hoạch trước khi tiếp tục
Phù hợp cho các thay đổi phức tạp mà bạn muốn kiểm soát
Nhiều bản kế hoạch có thể trở nên sẵn sàng đồng thời
Bạn có thể chỉnh sửa các bản kế hoạch đã tạo trước khi tiếp tục

`/opsx:ff`

Nhanh chóng tạo tất cả các bản kế hoạch. Tạo tất cả các bản kế hoạch cùng một lúc.

Cú pháp:

/opsx:ff [change-name]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name`	Không	Thay đổi nào để fast-forward (suy luận từ ngữ cảnh nếu không cung cấp)

Chức năng:

Tạo tất cả các bản kế hoạch theo thứ tự phụ thuộc
Theo dõi tiến độ qua danh sách todo
Dừng lại khi tất cả các bản kế hoạch apply-required hoàn tất
Đọc từng phụ thuộc trước khi tạo bản kế hoạch tiếp theo

Ví dụ:

You: /opsx:ff add-dark-mode

AI:  Fast-forwarding add-dark-mode...

     ✓ Creating proposal.md
     ✓ Creating specs/ui/spec.md
     ✓ Creating design.md
     ✓ Creating tasks.md

     All planning artifacts complete!
     Ready for implementation. Run /opsx:apply to begin.

Mẹo:

Sử dụng khi bạn có hình ảnh rõ ràng về những gì đang xây dựng
Nhanh hơn /opsx:continue cho các thay đổi đơn giản
Bạn vẫn có thể chỉnh sửa các bản kế hoạch sau đó
Phù hợp cho các tính năng nhỏ đến trung bình

`/opsx:apply`

Triển khai các tác vụ từ thay đổi. Làm việc qua danh sách tác vụ, viết code và đánh dấu hoàn thành.

Cú pháp:

/opsx:apply [change-name]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name`	Không	Thay đổi nào để triển khai (suy luận từ ngữ cảnh nếu không cung cấp)

Chức năng:

Đọc tasks.md và xác định các tác vụ chưa hoàn thành
Làm việc qua từng tác vụ một
Viết code, tạo tệp, chạy test khi cần
Đánh dấu tác vụ hoàn thành bằng checkbox [x]

Ví dụ:

You: /opsx:apply

AI:  Implementing add-dark-mode...

     Reading tasks.md:
     - [ ] 1.1 Create ThemeContext
     - [ ] 1.2 Add CSS custom properties
     - [ ] 1.3 Implement localStorage persistence

     Working on 1.1: Create ThemeContext...
     [Creates src/context/ThemeContext.tsx]

     ✓ 1.1 Complete

     Working on 1.2: Add CSS custom properties...
     [Updates src/styles/globals.css]

     ✓ 1.2 Complete
     ...

Mẹo:

Có thể tiếp tục từ nơi bạn dừng lại nếu bị gián đoạn
Sử dụng cho các thay đổi song song bằng cách chỉ định tên thay đổi
Trạng thái hoàn thành được theo dõi trong checkbox của tasks.md

`/opsx:update`

Sửa đổi các bản kế hoạch hiện có của một thay đổi và giữ chúng nhất quán với nhau. Chỉ các bản kế hoạch - không bao giờ chỉnh sửa code.

Cú pháp:

text

/opsx:update [change-name]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name`	Không	Thay đổi nào để cập nhật (suy luận từ ngữ cảnh nếu không cung cấp)

Chức năng:

Đọc các bản kế hoạch của thay đổi qua openspec status --change <name> --json
Áp dụng sửa đổi bạn yêu cầu, hoặc xem xét các bản kế hoạch để tìm mâu thuẫn nếu bạn không chỉ định cụ thể
Điều chỉnh các bản kế hoạch hiện có khác theo bất kỳ hướng nào (một sửa đổi design có thể lan ngược lại proposal)
Xác nhận từng sửa đổi với bạn trước khi ghi, một bản kế hoạch một lúc
Kết thúc bằng cách đề xuất bước tiếp theo: /opsx:continue (thiếu bản kế hoạch), /opsx:apply (áp dụng kế hoạch đã sửa vào code), hoặc /opsx:archive (hoàn tất)

Ví dụ:

text

You: /opsx:update add-dark-mode - we're storing the theme in a cookie now, not localStorage

AI:  Reading add-dark-mode artifacts...

     The design references localStorage in two places; tasks 1.3 covers
     localStorage persistence; the proposal doesn't mention storage.

     Proposed revisions:
     1. design.md - swap localStorage decision for cookie storage
     2. tasks.md - reword task 1.3 to cookie persistence

     Apply revision 1? (design.md)

Mẹo:

Không tạo các bản kế hoạch thiếu - đó là /opsx:continue
Nếu thay đổi đã được triển khai, hãy tiếp tục với /opsx:apply để code khớp với kế hoạch đã sửa
Nếu sửa đổi của bạn thay đổi ý định của thay đổi, hãy bắt đầu lại với một thay đổi mới (xem When to Update vs. Start Fresh)

`/opsx:verify`

Kiểm tra rằng triển khai khớp với các bản kế hoạch của thay đổi. Kiểm tra tính đầy đủ, chính xác và nhất quán.

Cú pháp:

/opsx:verify [change-name]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name`	Không	Thay đổi nào để xác minh (suy luận từ ngữ cảnh nếu không cung cấp)

Chức năng:

Kiểm tra ba chiều của chất lượng triển khai
Tìm kiếm trong codebase để tìm bằng chứng triển khai
Báo cáo các vấn đề được phân loại thành CRITICAL, WARNING, hoặc SUGGESTION
Không chặn archive, nhưng hiển thị các vấn đề

Các chiều xác minh:

Chiều	Nội dung xác minh
Tính đầy đủ	Tất cả tác vụ hoàn thành, tất cả yêu cầu được triển khai, các kịch bản được bao phủ
Tính chính xác	Triển khai khớp với ý định của spec, các trường hợp biên được xử lý
Tính nhất quán	Các quyết định thiết kế được phản ánh trong code, các pattern nhất quán

Ví dụ:

You: /opsx:verify

AI:  Verifying add-dark-mode...

     COMPLETENESS
     ✓ All 8 tasks in tasks.md are checked
     ✓ All requirements in specs have corresponding code
     ⚠ Scenario "System preference detection" has no test coverage

     CORRECTNESS
     ✓ Implementation matches spec intent
     ✓ Edge cases from scenarios are handled
     ✓ Error states match spec definitions

     COHERENCE
     ✓ Design decisions reflected in code structure
     ✓ Naming conventions consistent with design.md
     ⚠ Design mentions "CSS variables" but implementation uses Tailwind classes

     SUMMARY
     ─────────────────────────────
     Critical issues: 0
     Warnings: 2
     Ready to archive: Yes (with warnings)

     Recommendations:
     1. Add test for system preference detection
     2. Update design.md to reflect Tailwind usage, or refactor to use CSS variables

Mẹo:

Chạy trước khi archive để phát hiện sớm các sai lệch
Cảnh báo không chặn archive nhưng chỉ ra các vấn đề tiềm ẩn
Phù hợp để xem xét công việc của AI trước khi commit
Có thể phát hiện sự lệch lạc giữa các bản kế hoạch và triển khai

`/opsx:sync`

Lệnh tùy chọn. Hợp nhất delta specs từ một thay đổi vào main specs. Archive sẽ hỏi để sync nếu cần, vì vậy bạn thường không cần chạy lệnh này thủ công.

Cú pháp:

/opsx:sync [change-name]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name`	Không	Thay đổi nào để sync (suy luận từ ngữ cảnh nếu không cung cấp)

Chức năng:

Đọc delta specs từ thư mục thay đổi
Phân tích các phần ADDED/MODIFIED/REMOVED/RENAMED
Hợp nhất các thay đổi vào thư mục openspec/specs/ chính
Giữ nguyên nội dung hiện có không được đề cập trong delta
Không archive thay đổi (vẫn hoạt động)

Ví dụ:

text

You: /opsx:sync

AI:  Syncing add-dark-mode delta specs...

     Reading: openspec/changes/add-dark-mode/specs/ui/spec.md
     Target:  openspec/specs/ui/spec.md

     Changes to apply:
     ✓ ADDED: Theme Selection requirement (2 scenarios)
     ✓ ADDED: Accessibility requirement (1 scenario)

     Merging...
     ✓ openspec/specs/ui/spec.md updated

     Change remains active. Run /opsx:archive when ready to complete.

Khi nào sử dụng thủ công:

Tình huống	Có nên sync?
Thay đổi kéo dài, muốn specs trong main trước khi archive	Có
Nhiều thay đổi song song cần base specs đã cập nhật	Có
Muốn xem trước/xem xét việc hợp nhất riêng biệt	Có
Thay đổi nhanh, đi thẳng đến archive	Không (archive xử lý)

Mẹo:

Sync thông minh, không phải copy-paste
Có thể thêm kịch bản vào các yêu cầu hiện có mà không trùng lặp
Thay đổi vẫn hoạt động sau khi sync (không bị archive)
Hầu hết người dùng sẽ không bao giờ cần gọi lệnh này trực tiếp—archive sẽ hỏi nếu cần

`/opsx:archive`

Archive một thay đổi đã hoàn thành. Hoàn tất thay đổi và di chuyển nó vào thư mục archive.

Cú pháp:

/opsx:archive [change-name]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-name`	Không	Thay đổi nào để archive (suy luận từ ngữ cảnh nếu không cung cấp)

Chức năng:

Kiểm tra trạng thái hoàn thành của các bản kế hoạch
Kiểm tra hoàn thành tác vụ (cảnh báo nếu chưa hoàn thành)
Đề nghị sync delta specs nếu chưa sync
Di chuyển thư mục thay đổi vào openspec/changes/archive/YYYY-MM-DD-<name>/
Lưu giữ tất cả các bản kế hoạch để truy vết

Ví dụ:

text

You: /opsx:archive

AI:  Archiving add-dark-mode...

     Artifact status:
     ✓ proposal.md exists
     ✓ specs/ exists
     ✓ design.md exists
     ✓ tasks.md exists (8/8 tasks complete)

     Delta specs: Not yet synced
     → Sync now? (recommended)

You: Yes

AI:  ✓ Synced specs to openspec/specs/ui/spec.md
     ✓ Moved to openspec/changes/archive/2025-01-24-add-dark-mode/

     Change archived successfully.

Mẹo:

Archive không chặn khi có tác vụ chưa hoàn thành, nhưng sẽ cảnh báo
Delta specs có thể được sync trong quá trình archive hoặc trước đó
Các thay đổi đã archive được lưu giữ cho lịch sử
Sử dụng /opsx:verify trước để phát hiện các vấn đề

`/opsx:bulk-archive`

Archive nhiều thay đổi đã hoàn thành cùng một lúc. Xử lý xung đột specs giữa các thay đổi.

Cú pháp:

/opsx:bulk-archive [change-names...]

Tham số:

Tham số	Bắt buộc	Mô tả
`change-names`	Không	Các thay đổi cụ thể để archive (sẽ hỏi để chọn nếu không cung cấp)

Chức năng:

Liệt kê tất cả các thay đổi đã hoàn thành
Xác thực từng thay đổi trước khi archive
Phát hiện xung đột specs giữa các thay đổi
Giải quyết xung đột bằng cách kiểm tra những gì thực sự được triển khai
Archive theo thứ tự thời gian

Ví dụ:

You: /opsx:bulk-archive

AI:  Found 3 completed changes:
     - add-dark-mode (8/8 tasks complete)
     - fix-login-bug (3/3 tasks complete)
     - update-footer (2/2 tasks complete)

     Checking for spec conflicts...
     ⚠ add-dark-mode and update-footer both touch specs/ui/

     Inspecting codebase to resolve...
     Both changes are implemented. Will merge in chronological order:
     1. add-dark-mode (created Jan 20)
     2. update-footer (created Jan 22)

     Archive all 3 changes?

You: Yes

AI:  ✓ Archived add-dark-mode
     ✓ Archived fix-login-bug
     ✓ Archived update-footer
     Specs merged: add-dark-mode → update-footer

Mẹo:

Phù hợp cho các luồng công việc song song
Giải quyết xung đột theo kiểu agentic (kiểm tra codebase)
Các thay đổi được archive theo thứ tự tạo
Hỏi trước khi ghi đè nội dung spec

`/opsx:onboard`

Hướng dẫn onboarding qua toàn bộ workflow OpenSpec. Một bài học tương tác sử dụng codebase thực tế của bạn.

Cú pháp:

/opsx:onboard

Chức năng:

Đi qua một chu kỳ workflow hoàn chỉnh với lời giải thích
Quét codebase của bạn để tìm các cơ hội cải thiện thực tế
Tạo một thay đổi thực tế với các bản kế hoạch thực
Triển khai công việc thực tế (các thay đổi nhỏ, an toàn)
Archive thay đổi đã hoàn thành
Giải thích từng bước khi nó diễn ra

Các giai đoạn:

Chào mừng và phân tích codebase
Tìm một cơ hội cải thiện
Tạo một thay đổi (/opsx:new)
Viết proposal
Tạo specs
Viết design
Tạo tasks
Triển khai tasks (/opsx:apply)
Xác minh triển khai
Archive thay đổi
Tóm tắt và các bước tiếp theo

Ví dụ:

You: /opsx:onboard

AI:  Welcome to OpenSpec!

     I'll walk you through the complete workflow using your actual codebase.
     We'll find something small to improve, create a proper change for it,
     implement it, and archive it.

     Let me scan your codebase for opportunities...

     [Analyzes codebase]

     I found a few things we could work on:
     1. Add input validation to the contact form
     2. Improve error messages in the auth flow
     3. Add loading states to async buttons

     Which interests you? (or suggest something else)

Mẹo:

Tốt nhất cho người dùng mới học workflow
Sử dụng code thực, không phải ví dụ đồ chơi
Tạo một thay đổi thực mà bạn có thể giữ lại hoặc bỏ đi
Mất khoảng 15-30 phút để hoàn thành

Cú pháp lệnh theo từng công cụ AI

Các công cụ AI khác nhau sử dụng cú pháp lệnh hơi khác nhau. Hãy sử dụng định dạng phù hợp với công cụ của bạn:

Tệp lệnh của công cụ bạn	Ví dụ cú pháp	Ví dụ công cụ
`.../commands/opsx/<id>.*`	`/opsx:propose`, `/opsx:apply`	Claude Code, Gemini CLI, Crush
`.../opsx-<id>.*`	`/opsx-propose`, `/opsx-apply`	Cursor, Devin Desktop, Copilot (IDE), Trae, Oh My Pi
Không có — chỉ dùng skills	`/openspec-propose`, `/openspec-apply-change`	CodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, `.agents` dùng chung
Không có — Kimi Code	`/skill:openspec-propose`	Kimi Code
Không có — Codex CLI	`$openspec-propose`	Codex

Devin Desktop vs Devin Local: các tệp .devin/workflows/opsx-*.md cung cấp cho Devin Desktop lệnh /opsx-propose. Devin Local không có workflows — hãy sử dụng các skills mà OpenSpec ghi vào .devin/skills/, ví dụ /openspec-propose, hoạt động trên cả hai agent.

Ý định là như nhau giữa các công cụ, nhưng cách các lệnh được hiển thị có thể khác nhau tùy theo tích hợp. Cách gọi lệnh liệt kê mọi công cụ được hỗ trợ; bảng này chỉ hiển thị ví dụ của mỗi dạng.

Lưu ý: Các lệnh GitHub Copilot (.github/prompts/*.prompt.md) chỉ khả dụng trong các extension IDE (VS Code, JetBrains, Visual Studio). GitHub Copilot CLI hiện chưa hỗ trợ tệp prompt tùy chỉnh — xem Công cụ được hỗ trợ để biết chi tiết và giải pháp thay thế.

Lệnh cũ (Legacy)

Các lệnh này sử dụng quy trình "làm tất cả cùng lúc" cũ hơn. Chúng vẫn hoạt động nhưng các lệnh OPSX được khuyến nghị.

Lệnh	Chức năng
`/openspec:proposal`	Tạo tất cả các artifact cùng lúc (proposal, specs, design, tasks)
`/openspec:apply`	Triển khai thay đổi
`/openspec:archive`	Lưu trữ thay đổi

Khi nào sử dụng lệnh cũ:

Dự án hiện có đang sử dụng quy trình cũ
Thay đổi đơn giản mà bạn không cần tạo artifact từng bước
Ưu tiên cách tiếp cận tất cả hoặc không gì cả

Chuyển sang OPSX: Các thay đổi cũ có thể tiếp tục với các lệnh OPSX. Cấu trúc artifact tương thích.

Khắc phục sự cố

"Không tìm thấy thay đổi"

Lệnh không thể xác định thay đổi nào để xử lý.

Giải pháp:

Chỉ định tên thay đổi rõ ràng: /opsx:apply add-dark-mode
Kiểm tra xem thư mục thay đổi có tồn tại không: openspec list
Xác nhận bạn đang ở đúng thư mục dự án

"Không có artifact nào sẵn sàng"

Tất cả các artifact đều đã hoàn thành hoặc bị chặn bởi các phụ thuộc còn thiếu.

Giải pháp:

Chạy openspec status --change <name> để xem điều gì đang chặn
Kiểm tra xem các artifact yêu cầu có tồn tại không
Tạo các artifact phụ thuộc còn thiếu trước

"Không tìm thấy schema"

Schema được chỉ định không tồn tại.

Giải pháp:

Liệt kê các schema khả dụng: openspec schemas
Kiểm tra chính tả tên schema
Tạo schema nếu là tùy chỉnh: openspec schema init <name>

Lệnh không được nhận diện

Công cụ AI không nhận diện các lệnh OpenSpec.

Giải pháp:

Đảm bảo OpenSpec đã được khởi tạo: openspec init
Tạo lại các skills: openspec update
Kiểm tra xem thư mục .claude/skills/ có tồn tại không (đối với Claude Code)
Khởi động lại công cụ AI để nhận các skills mới

Artifact không được tạo đúng cách

AI tạo ra các artifact không hoàn chỉnh hoặc không chính xác.

Giải pháp:

Thêm ngữ cảnh dự án trong openspec/config.yaml
Thêm quy tắc cho từng artifact để có hướng dẫn cụ thể
Cung cấp nhiều chi tiết hơn trong mô tả thay đổi của bạn
Sử dụng /opsx:continue thay vì /opsx:ff để kiểm soát tốt hơn

Bước tiếp theo

Quy trình làm việc - Các mẫu phổ biến và khi nào sử dụng từng lệnh
CLI - Lệnh terminal để quản lý và xác thực
Tùy chỉnh - Tạo schema và quy trình tùy chỉnh

Lệnh ​

Tham chiếu nhanh ​

Đường dẫn nhanh mặc định (hồ sơ core) ​

Lệnh quy trình làm việc mở rộng (chọn quy trình làm việc tùy chỉnh) ​

Tham Khảo Lệnh ​

/opsx:propose ​

/opsx:explore ​

/opsx:new ​

/opsx:continue ​

/opsx:ff ​

/opsx:apply ​

/opsx:update ​

/opsx:verify ​

/opsx:sync ​

/opsx:archive ​

/opsx:bulk-archive ​

/opsx:onboard ​

Cú pháp lệnh theo từng công cụ AI ​

Lệnh cũ (Legacy) ​

Khắc phục sự cố ​

"Không tìm thấy thay đổi" ​

"Không có artifact nào sẵn sàng" ​

"Không tìm thấy schema" ​

Lệnh không được nhận diện ​

Artifact không được tạo đúng cách ​

Bước tiếp theo ​

Lệnh

Tham chiếu nhanh

Đường dẫn nhanh mặc định (hồ sơ `core`)

Lệnh quy trình làm việc mở rộng (chọn quy trình làm việc tùy chỉnh)

Tham Khảo Lệnh

`/opsx:propose`

`/opsx:explore`

`/opsx:new`

`/opsx:continue`

`/opsx:ff`

`/opsx:apply`

`/opsx:update`

`/opsx:verify`

`/opsx:sync`

`/opsx:archive`

`/opsx:bulk-archive`

`/opsx:onboard`

Cú pháp lệnh theo từng công cụ AI

Lệnh cũ (Legacy)

Khắc phục sự cố

"Không tìm thấy thay đổi"

"Không có artifact nào sẵn sàng"

"Không tìm thấy schema"

Lệnh không được nhận diện

Artifact không được tạo đúng cách

Bước tiếp theo