Lưu trữ change của OpenSpec
Kỹ năng hoàn tất và lưu trữ một change OpenSpec đã triển khai xong vào thư mục archive theo ngày, sau khi kiểm tra đầy đủ.
Tự động hóaTrung cấp★ 968⑂ 2Điểm AI 7/10Cập nhật lần cuối: 30 thg 10, 2026
Kỹ năng này làm gì
Hoàn tất (finalize) và lưu trữ một change đã triển khai xong trong quy trình OpenSpec.
- Chạy
openspec list --jsonđể liệt kê các change đang hoạt động và để người dùng tự chọn (không tự đoán). - Chạy
openspec status --change <name> --jsonđể kiểm tra trạng thái artifact; nếu còn dở thì cảnh báo và hỏi xác nhận. - Đếm mục
- [ ]và- [x]trongtasks.mdđể báo số task chưa hoàn thành. - Nếu có delta spec trong
openspec/changes/<name>/specs/, so sánh với spec chính và đề xuất đồng bộ. - Cuối cùng di chuyển thư mục sang
openspec/changes/archive/YYYY-MM-DD-<name>và in bản tóm tắt. - Repo này còn thêm một "cổng lưu trữ" (
npm run openspec:gate) bắt buộc phải qua trước khi archive.
Dành cho ai
- Nhóm phát triển theo spec-driven development với OpenSpec CLI
- Người bảo trì muốn lịch sử thay đổi được sắp xếp theo ngày
- Lập trình viên muốn khóa sổ triển khai và đồng bộ tài liệu trong cùng một bước
Ví dụ sử dụng
- "Mình làm xong
add-login-retryrồi, archive giúp" → kiểm tra artifact/task rồi chuyển sangarchive/2026-07-26-add-login-retry/. - Không nêu tên change: "dọn các change đã xong" → hiện danh sách change đang hoạt động để chọn.
- Khi còn delta spec → tóm tắt khác biệt (thêm/sửa/xóa) rồi hỏi "Đồng bộ ngay" hay "Archive mà không đồng bộ".
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/Gitruck/cli/HEAD/.agents/skills/openspec-archive-change/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên AI Skill Mart. Copy thư mục .agents/skills/openspec-archive-change từ repo GitHub Gitruck/cli vào ~/.claude/skills/openspec-archive-change/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/Gitruck/cli /tmp/gitruck-cli && mkdir -p ~/.claude/skills && cp -r /tmp/gitruck-cli/.agents/skills/openspec-archive-change ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Tải repo:
git clone https://github.com/Gitruck/cli /tmp/gitruck-cli - Tạo thư mục kỹ năng:
mkdir -p ~/.claude/skills - Sao chép kỹ năng:
cp -r /tmp/gitruck-cli/.agents/skills/openspec-archive-change ~/.claude/skills/ - Kiểm tra điều kiện tiên quyết: chạy
openspec --version; nếu chưa có OpenSpec CLI thì kỹ năng sẽ không hoạt động. - Dự án của bạn cần có cấu trúc
openspec/changes/. Lưu ý phần "cổng lưu trữ" dùngopenspec/gate.mjschỉ tồn tại cục bộ trong repo gốc — ở dự án khác hãy xóa đoạn đó hoặc tự viết script tương đương. - Khởi động lại Claude Code và thử yêu cầu: "archive change đã hoàn thành".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT