Xây dựng quy trình Claude Code thông minh hơn với claude-kit

claude-kit cung cấp những gì

claude-kit là tập hợp các skill, agent và mod độc lập dành cho Claude Code. Mỗi thành phần nằm trong thư mục plugins/ của repository, vì vậy bạn chỉ cần cài đặt chức năng mình cần.

• savvy-flow: Gói skill và agent cho phép phiên làm việc lập kế hoạch, phân công công việc cho các worker subagent theo từng cấp độ, rồi xem xét kết quả của chúng. Bạn gọi nó bằng /savvy-flow khi cài đặt thủ công, hoặc bằng namespace của plugin khi cài đặt thông qua marketplace.
• savvy-progress: Mod thêm thanh tiến trình phía trên prompt và bảng agent theo thời gian thực. Mod này được thiết kế cho savvy-flow, nhưng cũng có thể hiển thị mọi subagent.

Hai plugin hoạt động độc lập. Khi cài đặt cả hai, savvy-flow điều khiển thanh tiến trình, còn các worker của nó báo cáo tiến độ lên bảng agent.

Cài đặt claude-kit từ marketplace

Phương pháp marketplace là cách đơn giản nhất để cài đặt các plugin trong Claude Code.

1. Mở Claude Code.
2. Thêm repository làm marketplace và cài đặt các plugin bạn muốn:

/plugin marketplace add johnnyvizz/claude-kit
/plugin install savvy-flow@claude-kit
/plugin install savvy-progress@claude-kit

Khởi động lại phiên làm việc sau khi cài đặt. Các skill và agent được cài qua marketplace sẽ có namespace. Vì vậy, skill savvy-flow được gọi bằng /savvy-flow:savvy-flow, còn các agent của nó sử dụng những tên như savvy-flow:savvy-careful.

Bạn có thể chỉ cài một plugin nếu phù hợp hơn với quy trình làm việc của mình. Hãy cài cả hai khi muốn quy trình lập kế hoạch và các chỉ báo tiến độ trực quan hoạt động cùng nhau.

Cài đặt thành phần thủ công

Cài đặt thủ công hữu ích khi bạn muốn sao chép một skill vào cấu hình Claude Code hoặc tải trực tiếp một mod từ bản sao repository trên máy.

Sao chép repository

git clone https://github.com/johnnyvizz/claude-kit.git ~/claude-kit

Sao chép skill và agent savvy-flow

Skill không cần hệ thống plugin khi được cài theo cách này. Sao chép thư mục skill vào thư mục skill của Claude Code:

cp -R ~/claude-kit/plugins/savvy-flow/skills/savvy-flow ~/.claude/skills/

Sau đó sao chép các định nghĩa agent đi kèm vào thư mục agent:

cp ~/claude-kit/plugins/savvy-flow/agents/*.md ~/.claude/agents/

Với cách này, tên vẫn ngắn gọn: dùng /savvy-flow cho skill và các tên như savvy-careful cho agent.

Tải savvy-progress cho một phiên

Để chỉ tải mod tiến trình cho một phiên Claude Code cụ thể, hãy khởi động Claude Code với thư mục plugin:

claude --plugin-dir ~/claude-kit/plugins/savvy-progress

Tải savvy-progress cho mọi phiên

Để mod khả dụng trong mọi phiên, bao gồm cả ứng dụng desktop, hãy cấu hình CLAUDE_CODE_PLUGIN_DIRS trong ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "~/claude-kit/plugins/savvy-progress"
  }
}

Nếu cấu hình nhiều thư mục plugin, hãy phân tách chúng bằng :. Nếu CLAUDE_CODE_PLUGIN_DIRS đã có giá trị, hãy nối thêm thư mục mới thay vì thay thế các mục hiện có.

Chạy quy trình cơ bản

Sau khi cài đặt savvy-flow, hãy giao cho nó một nhiệm vụ để lập kế hoạch và điều phối. Ví dụ, với skill được sao chép thủ công:

/savvy-flow review the authentication changes and identify missing tests

Với cài đặt từ marketplace, hãy sử dụng dạng có namespace:

/savvy-flow:savvy-flow review the authentication changes and identify missing tests

Mô hình phiên lập kế hoạch công việc, phân công nhiệm vụ cho các worker subagent và xem xét kết quả của chúng. Nếu savvy-progress cũng đang hoạt động, thanh tiến trình và bảng agent sẽ cung cấp chế độ xem trực tiếp về hoạt động đó.

Bạn có thể tùy ý chọn nhiệm vụ: giao một yêu cầu review code, cuộc điều tra hoặc nhiệm vụ phát triển khác được hưởng lợi từ việc lập kế hoạch và phân công công việc.

Tìm hiểu cấu trúc repository

Mỗi plugin tuân theo một cấu trúc nhất quán. Catalog marketplace và các manifest plugin xác định cách Claude Code tìm các thành phần:

.claude-plugin/marketplace.json   catalog được `/plugin marketplace add` đọc
plugins/<name>/
  .claude-plugin/plugin.json      manifest
  skills/<skill>/SKILL.md         một skill
  agents/*.md                     các subagent đi kèm
  hooks/hooks.json                một mod: trỏ đến module hooks
  hooks/register.tsx              một mod: chính module đó
  types/index.d.ts                một mod: contract $.state của nó

Trong cấu trúc này, một skill được mô tả bằng tệp SKILL.md và có thể đi kèm các định nghĩa agent. Một mod sử dụng cấu hình hook và module đăng ký; khai báo kiểu của mod ghi lại contract $.state.

Xác thực plugin trước khi phát hành

Sử dụng các lệnh xác thực của Claude Code để kiểm tra từng plugin hoặc catalog marketplace:

claude plugin validate plugins/<name>
claude plugin validate .

Lệnh đầu tiên xác thực một thư mục plugin. Lệnh thứ hai xác thực catalog repository từ thư mục gốc.

Cập nhật cài đặt thủ công

Khi tải mod trực tiếp từ repository đã sao chép, hãy cập nhật bằng:

cd ~/claude-kit
git pull

Một mod được tải từ thư mục đó sẽ sử dụng các tệp đã cập nhật. Các skill được sao chép vào ~/.claude/skills/ không tự động cập nhật; sau khi kéo các thay đổi mới về, hãy sao chép lại các tệp skill và agent.

Các lưu ý nâng cao

Chủ động chọn lệnh có namespace hoặc lệnh ngắn

Việc cài đặt từ Marketplace cung cấp khả năng cô lập plugin thông qua các tên có namespace như /savvy-flow:savvy-flow. Cài đặt skill thủ công bỏ qua hệ thống plugin và giữ cho các lệnh ngắn gọn. Hãy sử dụng phương thức phù hợp nhất với ưu tiên của bạn: quản lý qua Marketplace hay làm việc trực tiếp với các tệp cục bộ.

Lưu ý khả năng tương thích của mod

Mod sử dụng các function hook thông qua hooks/register.tsx, một API Claude Code đang được phát hành sớm. Repository đã được kiểm thử trên Claude Code 2.1.286, và API có thể thay đổi giữa các phiên bản.

Nếu mod được cài đặt từ Marketplace không xuất hiện, hãy tải thủ công bằng --plugin-dir hoặc cấu hình thư mục của mod thông qua CLAUDE_CODE_PLUGIN_DIRS.

Kết hợp các plugin khi cần khả năng quan sát

savvy-flow có thể hoạt động mà không cần savvy-progress, và savvy-progress cũng có thể hoạt động mà không cần savvy-flow. Cài đặt cả hai là cấu hình cung cấp nhiều thông tin nhất: workflow điều phối tác vụ, còn mod hiển thị tiến độ và trạng thái agent đang hoạt động.

Kết luận

claude-kit cung cấp cho người dùng Claude Code các công cụ lập kế hoạch, ủy quyền, đánh giá và theo dõi tiến độ theo mô-đun. Hãy cài đặt savvy-flow và savvy-progress từ Marketplace để có cấu hình được quản lý, hoặc sao chép repository rồi sao chép hoặc tải các thành phần theo cách thủ công. Hãy ghi nhớ sự khác biệt về namespace, xác thực các thay đổi trước khi phát hành và cập nhật các skill đã sao chép riêng biệt với các mod được tải từ repository.