Skip to content

v1.1.0 — bảo vệ file đã sửa, check, và nhập bằng câu

Choose a tag to compare

@tms-anhnguyen1 tms-anhnguyen1 released this 23 Sep 08:56
· 10 commits to main since this release
ee022b6

Bản minor đầu tiên sau 1.0.0. Ba thay đổi, đều giữ nguyên nguyên tắc chọn, không sinh: không dòng nội dung nào do model viết, cùng đầu vào vẫn ra cùng kết quả.

Cài đặt / nâng cấp

npm install -g @tomosia/agent-stack@1.1.0

Plugin Claude Code: /plugin marketplace update agent-stack, rồi cài lại agent-stack@agent-stack.

Có gì mới

  • File đã sinh mà bạn sửa tay thì không bị đè nữa. Manifest giờ ghi sha256 của từng file đã copy (trường mới checksums). Nếu một file agent-stack đã ghi bị sửa, hoặc thư mục skill đã sinh có thêm file, lần chạy sau sẽ để nó yên và đưa nó ra khỏi manifest. Lần chạy báo cảnh báo modified-file. Chỉ --overwrite, hoặc tick trong checklist, mới lấy lại được file đó. File đã sửa mà không còn được chọn thì không bị xoá (cảnh báo retained-file). Xoá một file thì không tính là sửa, nên lần sau nó được ghi lại.
  • agent-stack check — dự án đã theo kịp knowledge base chưa? Lệnh này chạy đúng pipeline của generate, không ghi gì, rồi liệt kê từng đường dẫn mà generate sẽ add, update hay remove. Không truyền --framework thì nó lấy framework mà lần chạy trước đã ghi trong manifest. Exit 0 là đã cập nhật, 3 là đang cũ, nên đặt được làm bước trong CI. Trong Claude Code thì dùng /check.
  • /generate nhận một câu tiếng người. Ví dụ: /generate một app SaaS bằng Rails, dùng Postgres. Command quy câu đó về --framework rails, rồi đưa bảng ánh xạ cho bạn duyệt trước khi chạy: từ nào thành cờ, từ nào không dùng và vì sao. Không từ nào bị bỏ đi mà không báo. CLI không đổi, đầu vào vẫn chỉ có framework.

Tương thích

Không có thay đổi phá vỡ. Bản này chỉ thêm: lệnh check, exit code 3, trường emit.retained và kept[].state trong --json, hai mã cảnh báo modified-file / retained-file, và trường checksums trong manifest.

Một lưu ý khi nâng cấp: manifest do 1.0.0 ghi chưa có checksum. Vì vậy lần chạy đầu tiên sau khi nâng cấp chưa phân biệt được file đã sửa và vẫn xử lý như trước. Từ lần thứ hai trở đi, file đã sửa mới được bảo vệ. Nếu bạn đã sửa tay file nào trong .claude/, hãy sao lưu trước lần chạy đó.

Toàn bộ thay đổi: v1.0.0...v1.1.0