Skip to content

v1.0.0 — chọn rule, không sinh rule

Choose a tag to compare

View all tags
@tms-anhnguyen1 tms-anhnguyen1 released this 22 Sep 09:51
· 18 commits to main since this release
v1.0.0
e20429b

Bản phát hành đầu tiên. agent-stack dựng CLAUDE.md và .claude/ cho một dự án bằng cách chọn rule, skill và command từ một knowledge base có kiểm duyệt, nằm trong Git — không có dòng nội dung nào do model viết.

Cài đặt

npm install -g @tomosia/agent-stack
agent-stack generate --framework rails --write

Hoặc cài như plugin Claude Code, để dùng /generate và /catalog:

/plugin marketplace add TOMOSIA-VIETNAM/agent-stack
/plugin install agent-stack@agent-stack

Cần Node 20+. Không cần API key, và lúc generate không gọi network.

Có gì trong bản này

  • Chọn tất định. Phân giải dependency, kiểm tra tương thích, kết hợp và kiểm tra đều là TypeScript trong src/. Cùng framework vào thì cùng file ra, giống tới từng byte. Model chỉ làm hai việc: ánh xạ một câu tiếng người sang cờ CLI, và chuyển tiếp xung đột cho operator.
  • Xung đột làm dừng cả lần chạy. Khi hai technology được khai là không tương thích, generator nêu tên xung đột và in ra cờ để bỏ qua; nó không tự chọn bên thắng.
  • Checklist duyệt trước khi ghi. generate --write trong terminal liệt kê từng artifact kèm đường dẫn đích; tick cái nào ghi cái đó. Checklist chỉ thu hẹp kết quả, không bao giờ thêm vào.
  • Không đè file của bạn. CLAUDE.md merge trong cặp marker agent-stack:begin / agent-stack:end. File agent-stack chưa từng ghi thì mặc định để yên, trừ khi bạn tick nó hoặc chạy --overwrite. Chỉ file nằm trong manifest của lần chạy trước mới bị xoá.
  • Đường dẫn là metadata. File trong knowledge/ được copy nguyên văn — agent-stack không đọc, không sửa, không dựng lại front matter. Ngoại lệ duy nhất là claude-md/, được inline vào CLAUDE.md.
  • Agent detect đọc Gemfile.lock, composer.lock và cấu trúc thư mục để suy ra framework, gắn nhãn found / uncertain / missing, rồi đưa bạn duyệt trước khi generate.

Phạm vi nội dung

  • Layer global — 26 skill và 9 command copy từ addyosmani/agent-skills, cùng bộ hướng dẫn hành vi từ multica-ai/andrej-karpathy-skills, đều ghim theo commit trong upstream.yaml và giữ giấy phép MIT gốc.
  • Layer framework — Ruby, Rails và Active Record, tất cả gate bằng rails.
  • Catalog có hai entry: Rails và Laravel. Laravel chưa có nội dung nào; validator ghi nhận là uncovered-technology chứ không làm hỏng lần chạy. Bổ sung nội dung cho nó là đóng góp có giá trị nhất lúc này — xem CONTRIBUTING.md.

Cam kết tương thích

Từ 1.0.0, ba thứ này theo SemVer: cờ CLI, hợp đồng --json, và bố cục thư mục knowledge/. Thay đổi phá vỡ chúng sẽ lên major.

Giấy phép

Apache-2.0. Nội dung trong knowledge/ copy từ dự án khác giữ giấy phép riêng; xem NOTICE. Mỗi dự án được generate ghi lại phần ghi công trong .claude/agent-stack-manifest.json.

Assets 2
Loading