Bỏ qua tới nội dung
Ông T.vn

shadcn/improve: audit code và lập kế hoạch triển khai — hướng dẫn cài đặt và dùng

13 phút đọcCập nhật

Bài này là một góc nhìn khác về shadcn/improve — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: shadcn/improve: kiểm tra code, viết kế hoạch cho model rẻ làm — hướng dẫn cài đặt và dùng →

shadcn/improve: audit code và lập kế hoạch triển khai — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

shadcn/improve là một Agent Skill giúp audit codebase, xếp hạng phát hiện và viết kế hoạch triển khai độc lập cho agent hoặc con người thực hiện. Skill không tự sửa mã nguồn; nó tạo các file kế hoạch Markdown trong thư mục plans/. Cài đặt khá đơn giản bằng npx nếu agent của bạn hỗ trợ định dạng Agent Skills.

shadcn/improve là một Agent Skill dùng model có năng lực cao để audit toàn bộ codebase và viết kế hoạch triển khai cho những agent khác thực hiện. Thay vì giao cả việc đọc hiểu, quyết định và sửa code cho một model duy nhất, bạn dùng model mạnh ở phần phân tích rồi giao phần thực thi cho model rẻ hơn.

Repo này phù hợp với nhóm phát triển có codebase đang lớn dần, nhiều việc tồn đọng hoặc cần đánh giá trước khi mở pull request. Điểm đáng giá nhất là kế hoạch được viết thành tài liệu Markdown độc lập. Một agent khác, hoặc chính một lập trình viên, có thể đọc kế hoạch mà không cần biết phiên audit ban đầu.

Repo hiện có khoảng 11.634 sao và 471 fork. Repo dùng giấy phép MIT và vẫn còn được cập nhật. Skill không tự triển khai thay bạn: sản phẩm chính của nó là danh sách phát hiện, thứ tự ưu tiên và các file kế hoạch có tiêu chí kiểm tra rõ ràng.

Skill

shadcn/improve

Skill dùng model mạnh để audit codebase, tìm vấn đề và viết kế hoạch chi tiết cho agent khác triển khai.

I.shadcn/improve làm được gì

A.Audit codebase theo nhiều góc nhìn

Lệnh mặc định sẽ lập bản đồ repo rồi kiểm tra nhiều nhóm vấn đề. Các nhóm được README nêu gồm tính đúng đắn, bảo mật, hiệu năng, độ bao phủ kiểm thử, nợ kỹ thuật, dependency và migration, trải nghiệm phát triển, tài liệu và định hướng tính năng.

Lợi ích thực tế là bạn không chỉ nhận một danh sách lỗi ngẫu nhiên. Mỗi phát hiện được gắn với bằng chứng trong repo, mức ảnh hưởng, công sức ước tính và độ tin cậy. Điều này giúp nhóm thảo luận dựa trên vị trí code và tác động cụ thể.

B.Tạo bảng phát hiện có ưu tiên

Skill xem xét lại các vị trí được agent phụ trợ trích dẫn trước khi hiển thị kết quả. Những cảnh báo sai hoặc gán nhầm được loại bỏ. Các phát hiện còn lại được sắp xếp theo mức đòn bẩy, tức tác động so với công sức và có tính đến độ tin cậy.

Với người quản lý dự án hoặc chủ sản phẩm, bảng này giúp chọn đúng việc để làm trước. Bạn không phải sửa theo thứ tự phát hiện xuất hiện, mà có thể chọn những mục có lợi ích lớn và chi phí hợp lý.

C.Viết kế hoạch tự đủ thông tin

Sau khi bạn chọn các phát hiện, skill tạo một file cho mỗi mục trong thư mục plans/ và tạo thêm chỉ mục với thứ tự đề xuất cùng biểu đồ phụ thuộc. Kế hoạch có đường dẫn file, đoạn code hiện tại, quy ước của repo, lệnh kiểm tra và điều kiện hoàn thành.

Một agent yếu hơn vẫn có thể làm theo vì kế hoạch không yêu cầu nó nhớ cuộc trò chuyện trước. README gọi đây là các kế hoạch self-contained. Mỗi bước có cổng xác minh và kết quả mong đợi để việc hoàn thành dễ kiểm tra bằng máy.

D.Đặt ranh giới và điều kiện dừng

Kế hoạch có phần ngoài phạm vi và điều kiện STOP. Nếu trạng thái thực tế không khớp với mô tả trong kế hoạch, executor phải dừng và báo lại thay vì tự đoán.

Đây là điểm hữu ích với codebase nhạy cảm. Model thực thi không được tự mở rộng yêu cầu chỉ vì thấy một hướng cải tiến khác trong lúc sửa.

E.Hỗ trợ nhiều kiểu audit

Bạn có thể chạy audit đầy đủ, audit nhanh hoặc audit sâu. Ngoài ra còn có audit tập trung vào bảo mật, hiệu năng, kiểm thử hay lỗi; audit chỉ phần thay đổi của branch; và chế độ đề xuất tính năng tiếp theo.

Các chế độ này phù hợp với những thời điểm khác nhau. Audit nhanh dùng khi cần tìm các điểm nóng. Audit sâu dùng khi muốn xem xét mọi package và mọi nhóm vấn đề. Audit branch phù hợp trước pull request.

F.Quản lý vòng đời của kế hoạch

Sau khi kế hoạch được thực hiện, lệnh reconcile kiểm tra kế hoạch nào đã hoàn tất, điều tra kế hoạch bị chặn, làm mới kế hoạch bị lệch so với code và nghỉ các phát hiện đã được sửa độc lập.

Skill cũng có chế độ execute để điều phối executor rẻ hơn trong một worktree cô lập, xem xét phần thay đổi và đưa ra verdict. Việc merge vẫn do bạn quyết định.

G.Xuất kế hoạch thành GitHub issue

Tùy chọn --issues cho phép xuất kế hoạch thành GitHub issue. Nhờ đó, kế hoạch vẫn giữ dạng nội dung tự đủ thông tin và có thể được agent hoặc con người tiếp nhận từ hệ thống quản lý công việc.

II.Cần chuẩn bị gì

Bạn cần một agent hỗ trợ định dạng Agent Skills. README nói skill hoạt động trong bất kỳ agent nào hỗ trợ Agent Skills format. Tư liệu không nêu tên cụ thể của các agent được hỗ trợ, cũng không nêu phiên bản hệ điều hành.

Bạn cần có một codebase để mở trong agent. Skill sẽ đọc repo, nhận diện stack, quy ước và các lệnh build, test, lint hiện có. Nếu repo có tài liệu như ADR trong docs/adr/, PRD, CONTEXT.md, DESIGN.md hoặc PRODUCT.md, skill có thể tiếp nhận chúng để tránh đề xuất trái với quyết định đã có.

Bạn cần cài được công cụ npx để chạy lệnh cài đặt được README cung cấp. README không ghi phiên bản Node.js, phiên bản npx, tài khoản, API key, GPU hay phần cứng tối thiểu. Vì vậy không nên tự suy ra các yêu cầu đó từ tài liệu này.

Skill được phát hành theo giấy phép MIT. README cũng nói các kế hoạch được viết dưới dạng Markdown thuần, nên agent hoặc con người có thể đọc chúng mà không cần một định dạng dữ liệu riêng.

Skill không tự sửa source code. Các thay đổi do executor thực hiện nằm trong worktree cô lập và việc merge luôn do bạn quyết định. Không đưa secret vào kế hoạch; README chỉ cho phép ghi vị trí và loại credential, đồng thời khuyến nghị rotation.

III.Cài đặt từng bước

  1. Chuẩn bị agentMở agent hỗ trợ định dạng Agent Skills trong codebase cần kiểm tra
  2. Cài skillChạy lệnh npx được README cung cấp
  3. Chạy audit đầu tiênDùng /improve hoặc /improve quick để nhận phát hiện
  4. Chọn việc cần lập kế hoạchTrả lời các số phát hiện muốn triển khai
  5. Đọc và giao kế hoạchXem thư mục plans/ rồi đưa file cho agent hoặc dùng execute

A.Chuẩn bị thư mục codebase

Mở agent của bạn tại repo cần audit. Cách mở cụ thể không được README mô tả, nên bạn làm theo quy trình của agent đang dùng. Điều quan trọng là agent phải nhìn thấy codebase và hỗ trợ Agent Skills.

Nếu bạn đang lấy repo này về để xem nội dung, có thể dùng lệnh Git phổ thông sau. README không cung cấp lệnh clone riêng, nên lệnh này chỉ là cách clone GitHub thông thường.

Terminal
git clone https://github.com/shadcn/improve.git
cd improve

Lệnh đầu tiên tải repo về máy. Lệnh thứ hai chuyển terminal vào thư mục repo. Người mới thường chạy lệnh thứ hai ở một thư mục không tồn tại vì clone chưa hoàn tất, hoặc mở agent ở repo khác với repo muốn audit. Hãy kiểm tra bạn đang làm việc trong đúng codebase trước khi chạy skill.

B.Cài Agent Skill

Trong terminal, chạy đúng lệnh cài đặt được README cung cấp:

Terminal
npx skills add shadcn/improve

Lệnh này thêm skill shadcn/improve thông qua npx. README không ghi thêm cờ, biến môi trường hay thư mục đích, nên không tự thêm các tham số khác. Nếu terminal báo không nhận ra npx, tài liệu của repo chưa hướng dẫn cách cài npx; hãy xử lý phần công cụ Node.js theo môi trường của bạn trước rồi quay lại lệnh trên.

C.Chạy audit đầu tiên

Mở agent trong repo cần kiểm tra và chạy audit mặc định:

text
/improve

README mô tả đây là quy trình audit đầy đủ, gồm lập bản đồ repo, đưa ra các phát hiện có ưu tiên và tạo kế hoạch sau khi bạn chọn mục cần làm. Nếu muốn giảm chi phí cho lượt đầu, dùng audit nhanh:

text
/improve quick

Chế độ quick tìm hotspot và các phát hiện hàng đầu. Đây là lựa chọn hợp lý khi repo lớn hoặc bạn chỉ muốn biết những vấn đề đáng chú ý nhất trước.

D.Chọn phát hiện để lập kế hoạch

Sau khi nhận bảng phát hiện, xem số thứ tự và trả lời agent bằng các mục muốn lập kế hoạch. README đưa ví dụ:

text
plan 1, 3 and 5

Skill sẽ tạo một file cho từng phát hiện được chọn trong thư mục plans/, cùng một index có thứ tự đề xuất. Hãy đọc các file này trước khi giao cho executor. Kiểm tra xem đường dẫn, đoạn code, lệnh xác minh và phạm vi có khớp với mục tiêu của bạn không.

E.Giao kế hoạch cho executor

Bạn có thể đưa trực tiếp file kế hoạch cho bất kỳ agent nào bằng yêu cầu dạng sau:

text
implement plans/001-*.md

Hoặc để skill điều phối executor rẻ hơn:

text
/improve execute 001

Chế độ execute dùng worktree Git cô lập, giao kế hoạch cho executor, xem xét diff theo kế hoạch và báo verdict. README nêu ba hướng xử lý là approve, gửi lại để sửa tối đa hai vòng hoặc block và tinh chỉnh kế hoạch. Quyết định merge vẫn thuộc về bạn.

IV.Kiểm tra đã chạy được chưa

Dấu hiệu đầu tiên là lệnh /improve hoặc /improve quick được agent nhận diện thay vì coi như văn bản bình thường. Sau đó, một lượt chạy thành công phải trả về bảng findings có các nhóm như category, effort và confidence, kèm bằng chứng dạng file:line, tác động và độ tin cậy.

Khi bạn chọn phát hiện, hãy kiểm tra thư mục plans/. README mô tả kết quả là mỗi kế hoạch một file Markdown và một index có thứ tự ưu tiên cùng dependency graph. Nếu chưa có plans/ sau khi đã chọn mục, hãy kiểm tra lại agent có nhận skill hay không và bạn có chạy lệnh trong đúng codebase hay không.

Một kế hoạch đạt yêu cầu cần có ngữ cảnh hiện tại, đoạn code liên quan, bước thực hiện chính xác, lệnh kiểm tra và kết quả mong đợi. Kế hoạch cũng cần nêu tiêu chí hoàn thành, phần ngoài phạm vi và điều kiện STOP. Đây là các dấu hiệu cho thấy skill đã tạo đầu ra có thể giao cho executor, thay vì chỉ đưa lời khuyên chung.

Trước pull request, bạn có thể chạy:

text
/improve branch

Kết quả mong đợi là audit chỉ tập trung vào những gì branch hiện tại thay đổi. Sau khi một số kế hoạch đã được xử lý, dùng:

text
/improve reconcile

Kết quả mong đợi là backlog được làm mới: kế hoạch đã xong được xác minh, kế hoạch bị chặn được điều tra, kế hoạch bị lệch được cập nhật và phát hiện đã được sửa độc lập được nghỉ.

V.Dùng vào việc thật

A.Chủ shop có code bán hàng đang chậm

Một chủ shop có ứng dụng quản lý sản phẩm, đơn hàng và tồn kho. Người này không muốn giao cả repo cho một model rẻ tự sửa vì chưa biết vấn đề nằm ở truy vấn, thiết kế dữ liệu hay luồng xử lý.

Có thể mở agent trong repo rồi chạy:

text
/improve performance

Skill sẽ tập trung audit hiệu năng. Chủ shop chọn các phát hiện quan trọng, chẳng hạn một truy vấn lặp hoặc một điểm xử lý tốn thời gian, rồi yêu cầu lập kế hoạch theo số thứ tự. Kết quả là kế hoạch có file, đoạn code hiện tại, cách sửa dự kiến và lệnh kiểm tra để dev thực hiện.

B.Nhân viên văn phòng quản lý một công cụ nội bộ

Một nhân viên phụ trách công cụ nội bộ muốn biết trước pull request có lỗi bảo mật nào dễ bị bỏ sót không. Người này chạy:

text
/improve security

Skill chỉ tập trung vào audit bảo mật. Nếu phát hiện được chọn để lập kế hoạch, kế hoạch phải ghi vị trí và loại credential cần xử lý chứ không tái hiện giá trị secret. Nhân viên có thể gửi file kế hoạch cho dev hoặc đưa thành issue bằng:

text
/improve security --issues

Kết quả là các kế hoạch được đăng thành GitHub issue theo nội dung tự đủ thông tin, để người phụ trách có thể giao việc mà không cần chép lại toàn bộ phiên audit.

C.Dev mới chuẩn bị gửi pull request

Một dev mới chỉ muốn kiểm tra phần mình vừa thay đổi, không muốn audit mọi package trong repo. Dev chạy:

text
/improve branch

Skill xem xét phạm vi thay đổi của branch. Dev nhận được findings liên quan trực tiếp đến phần đang làm, rồi có thể chọn một hoặc vài mục để tạo kế hoạch. Cách này giúp review tập trung hơn và giảm nguy cơ bị ngập trong các vấn đề không liên quan đến pull request.

D.Nhóm phát triển có backlog lâu ngày

Một nhóm có nhiều kế hoạch cũ và không biết mục nào còn phù hợp với code hiện tại. Sau khi các thay đổi đã được merge, nhóm chạy:

text
/improve reconcile

Skill kiểm tra những kế hoạch đã đánh dấu hoàn tất, điều tra kế hoạch bị block, làm mới kế hoạch bị drift và retire các phát hiện đã được sửa độc lập. Nhóm có một backlog gần với trạng thái code hơn thay vì tiếp tục giao những kế hoạch đã lỗi thời.

Một model mạnh nên quyết định cần làm gì; một model rẻ hơn có thể làm theo kế hoạch đã được kiểm chứng.

Ông T

VI.Lỗi hay gặp và cách xử lý

A.Agent không nhận lệnh /improve

Nguyên nhân dễ gặp là agent chưa hỗ trợ Agent Skills hoặc skill chưa được cài trong môi trường đang mở. Hãy xác nhận bạn đã chạy đúng lệnh npx skills add shadcn/improve và đang mở agent trong đúng codebase. README không cung cấp lệnh chẩn đoán riêng, nên không nên tự thêm cờ hoặc biến môi trường chưa được tài liệu hóa.

B.Chạy audit ở sai repo

Skill audit codebase mà agent đang mở. Nếu bạn mở nhầm thư mục, findings và đường dẫn file sẽ không phản ánh dự án cần kiểm tra. Hãy dừng, mở lại agent ở đúng repo rồi chạy lại /improve hoặc /improve quick.

C.Kế hoạch không còn khớp với code

Code có thể thay đổi sau khi kế hoạch được tạo. Không nên để executor tự đoán khi đường dẫn, đoạn code hoặc lệnh kiểm tra đã khác. Dùng /improve reconcile để xác minh kế hoạch, làm mới kế hoạch bị drift hoặc điều tra kế hoạch bị block.

D.Executor sửa vượt phạm vi

Kế hoạch có hard boundaries và STOP conditions để hạn chế việc tự suy diễn. Nếu diff chứa thay đổi ngoài phạm vi, yêu cầu review lại theo kế hoạch và để skill gửi lại cho executor sửa hoặc block. Việc merge không tự động thuộc về skill.

E.Vô tình đưa secret vào kế hoạch

README quy định không tái hiện giá trị secret. Chỉ ghi vị trí và loại credential, đồng thời khuyến nghị rotation. Nếu đầu ra có giá trị bí mật, dừng việc chia sẻ kế hoạch, loại bỏ hoặc xoay vòng credential theo quy trình an toàn của dự án rồi mới giao kế hoạch.

VII.Có nên dùng không

Nên dùng nếu bạn có codebase đủ lớn để việc đọc hiểu quan trọng hơn tốc độ sửa một file, có nhiều backlog cần xếp ưu tiên, hoặc muốn tách phần phân tích khỏi phần thực thi. Skill đặc biệt hữu ích khi nhóm muốn kế hoạch có bằng chứng, tiêu chí kiểm tra và ranh giới rõ ràng.

Điểm mạnh là quy trình có nhiều lớp: recon để hiểu repo, audit theo chín nhóm, vet để bỏ false positive, prioritize để xếp hạng và plan để tạo tài liệu có thể giao cho agent khác. Các kế hoạch dạng Markdown cũng dễ đọc với con người và không khóa bạn vào một công cụ thực thi duy nhất.

Giới hạn lớn nhất là skill không tự triển khai thay bạn. Nó cũng không biến một repo thiếu kiểm thử hoặc thiếu tài liệu thành codebase hoàn hảo. README không nêu cụ thể hệ điều hành, phiên bản runtime, chi phí model, danh sách agent tương thích, tài khoản cần dùng hay yêu cầu phần cứng, nên bạn cần kiểm tra các điều đó ở môi trường agent của mình.

Bạn nên chọn cách khác nếu chỉ cần sửa một lỗi rất nhỏ và đã biết chính xác file cùng lệnh kiểm tra, hoặc nếu agent của bạn không hỗ trợ Agent Skills. Khi đó, một quy trình review và triển khai trực tiếp có thể đơn giản hơn. Với dự án quan trọng, hãy xem kế hoạch là đầu vào cho quyết định kỹ thuật, đọc lại diff và tự quyết định merge thay vì phó mặc toàn bộ cho executor.

4.3/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

shadcn/improve có miễn phí không?

README không nói về giá hoặc chi phí sử dụng. Repo dùng giấy phép MIT, nhưng chi phí của agent hoặc model mà bạn dùng không được nêu trong tư liệu.

Có cần GPU để chạy skill không?

Tư liệu không nêu yêu cầu GPU hay phần cứng tối thiểu. Skill được cài bằng npx và chạy trong một agent hỗ trợ Agent Skills.

Có chạy được trên Windows không?

README không nêu hệ điều hành được hỗ trợ, nên chưa có thông tin xác nhận riêng cho Windows.

Skill có tự sửa code không?

Không. README ghi rõ skill không bao giờ tự triển khai source code; nó chỉ ghi kế hoạch vào plans/. Chế độ execute có thể điều phối executor trong worktree cô lập, nhưng việc merge vẫn do bạn quyết định.

Có cần API key hoặc tài khoản riêng không?

README không nêu API key, tài khoản hay credential bắt buộc để cài và dùng skill. Nếu codebase có secret, kế hoạch chỉ nên ghi vị trí và loại credential, không ghi giá trị.

shadcn/improve khác audit code thông thường thế nào?

Skill audit theo nhiều nhóm, kiểm tra lại bằng chứng, xếp hạng phát hiện rồi tạo kế hoạch tự đủ thông tin cho executor. Điểm cốt lõi là tách phần model mạnh phân tích và lập kế hoạch khỏi phần model khác thực thi.

Có thể dùng skill cho một branch thay vì toàn bộ repo không?

Có. README cung cấp lệnh `/improve branch` để audit phần thay đổi của branch hiện tại. Đây là lựa chọn phù hợp trước pull request.

Chuyển nhanh tới mục

  1. I.shadcn/improve làm được gì
    1. A.Audit codebase theo nhiều góc nhìn
    2. B.Tạo bảng phát hiện có ưu tiên
    3. C.Viết kế hoạch tự đủ thông tin
    4. D.Đặt ranh giới và điều kiện dừng
    5. E.Hỗ trợ nhiều kiểu audit
    6. F.Quản lý vòng đời của kế hoạch
    7. G.Xuất kế hoạch thành GitHub issue
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chuẩn bị thư mục codebase
    2. B.Cài Agent Skill
    3. C.Chạy audit đầu tiên
    4. D.Chọn phát hiện để lập kế hoạch
    5. E.Giao kế hoạch cho executor
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop có code bán hàng đang chậm
    2. B.Nhân viên văn phòng quản lý một công cụ nội bộ
    3. C.Dev mới chuẩn bị gửi pull request
    4. D.Nhóm phát triển có backlog lâu ngày
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Agent không nhận lệnh /improve
    2. B.Chạy audit ở sai repo
    3. C.Kế hoạch không còn khớp với code
    4. D.Executor sửa vượt phạm vi
    5. E.Vô tình đưa secret vào kế hoạch
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.