Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi mỗi thay đổi có một thư mục riêng gồm proposal, specs, design và tasks bằng Markdown thường, và lệnh /opsx:archive gộp spec của thay đổi đó vào bộ spec chung khi làm xong. | README, See it in action |
|---|---|---|
| Ưu | Bài của Hashrocket (2025-10-21) cài OpenSpec chỉ bằng npm install, còn Spec Kit cần cài thêm trình quản lý gói Python. Cùng một việc, OpenSpec viết 3 file khoảng 250 dòng, và tác giả thấy dễ đọc duyệt hơn nhiều. | Hashrocket, 2025-10-21 |
| Nhược | Telemetry bật sẵn: mỗi lần chạy lệnh, CLI gửi tên lệnh và số phiên bản kèm một mã ẩn danh tới edge.openspec.dev. Muốn tắt, bạn đặt OPENSPEC_TELEMETRY=0 hoặc DO_NOT_TRACK=1, hoặc chạy openspec config set telemetry.enabled false. | src/telemetry/index.ts |
| Nhược | Một tính năng trải trên nhiều repo (ví dụ frontend và backend tách riêng) vẫn chưa có cách làm đầy đủ: issue mở từ 2026-02-18 vẫn còn mở, và phần Stores dùng cho việc này vẫn đang beta. | Issue #725 |
| Nhược | Bài review của VibecodingHub (2026-07-10) viết một bản sửa nhỏ có thể chậm hơn vì phải qua bước đề xuất và lưu trữ, và spec sẽ lệch khỏi code nếu thay đổi xong không được archive. | VibecodingHub, 2026-07-10 |
| Chưa rõ | Ry Walker đếm được người đóng góp nhiều nhất có 504 commit, người thứ hai chỉ có 3 (số liệu tới tháng 6 năm 2026). Mình chưa tự đếm lại, nên chưa biết dự án còn phụ thuộc vào một người tới mức nào. | rywalker.com |
Khi nên dùng
- Bạn sửa hoặc thêm tính năng vào một dự án đang có, muốn agent viết đề xuất ngắn để bạn duyệt trước khi code, và chỉ cần cài một gói npm.
Khi không nên dùng
- Nhóm bạn cần các bước duyệt cố định và hướng dẫn chi tiết cho người mới (khi đó Spec Kit hợp hơn), hoặc bạn không muốn công cụ gửi telemetry mà quên tắt.
Cách cài
Claude Code
npm install -g @fission-ai/[email protected] && openspec init --tools claudeCodex
npm install -g @fission-ai/[email protected] && openspec init --tools codexCursor
npm install -g @fission-ai/[email protected] && openspec init --tools cursorNó chạm vào những gì
- File đọc và ghi
- openspec init tạo thư mục openspec/ (specs và changes) trong dự án và ghi skill vào .claude/skills/openspec-*/SKILL.md cùng lệnh vào .claude/commands/opsx/. Cấu hình chung (mã ẩn danh cho telemetry, cài đặt) nằm ở %APPDATA%/openspec trên Windows hoặc thư mục XDG. Bước dọn bản cũ xóa các file prompt cũ do OpenSpec tạo trong ~/.codex/prompts, theo một danh sách tên cố định.
- Gọi mạng
- Mỗi lệnh gửi tên lệnh và số phiên bản tới edge.openspec.dev/batch (PostHog), trừ khi bạn tắt telemetry hoặc đang chạy trong CI. CLI hỏi registry.npmjs.org để báo bản mới, tắt bằng OPENSPEC_NO_UPDATE_CHECK. Lệnh openspec install (cập nhật bản đơn file) tải từ raw.githubusercontent.com/Fission-AI/OpenSpec/main.
- Script lúc cài
- Gói npm không có postinstall; script prepare (node build.js) chỉ chạy khi build từ mã nguồn. Cách cài bằng curl ... | sh trong README tải script từ nhánh main, không ghim được phiên bản.
- Tiến trình
- Không mở tiến trình chạy nền. Lệnh openspec feedback tạo đường link mở issue trên GitHub.
Đọc từ: index.ts#L29-L32, version-check.ts#L17, legacy-cleanup.ts#L163-L168, package.json, supported-tools.md#L71
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin