Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:repomix

Ngữ cảnh AI từ repo

Đóng gói repo local, remote hoặc bên thứ ba thành ngữ cảnh XML, Markdown, JSON hoặc plain text thân thiện với AI, có đếm token và kiểm tra bảo mật.

01

Đánh giá yêu cầu

02

Cấu hình bộ lọc

03

Chạy đóng gói

04

Xác thực đầu ra

Nguyên tắc 01

Chỉ đóng gói phần ngữ cảnh repo mà tác vụ AI tiếp theo thật sự cần

Nguyên tắc 02

Dùng pattern include và ignore để giữ codebase lớn đúng trọng tâm

Nguyên tắc 03

Đếm token là cổng bàn giao theo context của model đích

Nguyên tắc 04

Kiểm tra bảo mật và rà thủ công đầu ra trước khi chia sẻ

Nguyên tắc 05

Có thể đóng gói repo remote để phân tích mà không cần clone

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

01

Khởi động

Đầu vào, phạm vi, route

  1. 1 Đánh giá yêu cầu Xác định path local hoặc repo remote, mục đích phân tích hay audit bằng AI, định dạng đầu ra và rủi ro dữ liệu nhạy cảm.
  2. 2 Cấu hình bộ lọc Đặt pattern include và ignore, quyết định có theo .gitignore không và chỉ bật loại bỏ comment khi có ích cho nhiệm vụ đích.
02

Xử lý

Agent / skill thực thi

  1. 3 Chạy đóng gói Chạy Repomix local hoặc với `npx repomix --remote`, chọn `--style xml|markdown|plain|json`, rồi ghi hoặc copy file đầu ra.
  2. 4 Xác thực đầu ra Rà file đã tạo, số token hoặc cây token, cảnh báo bảo mật và giới hạn context của model đích trước khi bàn giao.
03

Kiểm chứng

Gate, review, xác thực

  1. 5 Bàn giao ngữ cảnh Cung cấp file đã đóng gói, tóm tắt token, bộ lọc đã chọn và các vùng bị bỏ qua, cảnh báo hoặc lưu ý bảo mật.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:repomix [path] [--style xml|markdown|plain|json]

Đối số

[path]

Đường dẫn repo

Repo hoặc thư mục local cần đóng gói. Bỏ qua để pack working directory hiện hành; chỉ dùng tùy chọn remote khi nguồn không nằm local.

/ak:repomix packages/auth --style markdown

Option dùng chung

--style xml|markdown|plain|json

Kiểu đầu ra

Chọn XML, Markdown, JSON hoặc plain text. Tùy chọn này đổi định dạng bundle, không đổi tập file nguồn được đưa vào.

/ak:repomix . --style markdown
--include <patterns>

Pattern include

Thu hẹp gói vào file hoặc thư mục khớp pattern, như module source, docs, manifest hoặc một package trong monorepo.

/ak:repomix . --include "src/**/*.ts,*.md"
-i <patterns>

Bỏ qua bổ sung

Thêm pattern bỏ qua cho path nhiễu, sinh tự động hoặc nhạy cảm. Không dùng để che cảnh báo bảo mật chưa xử lý.

/ak:repomix . -i "tests/**,*.test.js"
-o <file>

File đầu ra

Ghi bundle đã tạo vào file rõ ràng thay vì mặc định repomix-output.xml trong working directory.

/ak:repomix src -o artifacts/src-context.md --style markdown
--remote <repo-or-url>

Repo remote

Đóng gói repository public dạng shorthand, URL hoặc commit qua xử lý remote của Repomix. Với code private, dùng clone local đã được cấp quyền.

/ak:repomix --remote yamadashy/repomix --style xml
--remove-comments

Loại comment

Xóa comment của ngôn ngữ được hỗ trợ để giảm kích thước context, nhưng có thể mất license, rationale, ghi chú file sinh tự động hoặc ràng buộc an toàn.

/ak:repomix src --remove-comments --style markdown
--copy

Copy vào clipboard

Copy bundle đã tạo vào system clipboard ngoài xử lý thông thường. Rà soát nội dung nhạy cảm trước khi dùng.

/ak:repomix . --copy
--init

Tạo config

Tạo repomix.config.json cho thiết lập đóng gói tái sử dụng. Tùy chọn này không tự tạo bundle repository.

/ak:repomix --init
--token-count-tree [min]

Cây token

Hiển thị file và thư mục nặng token, có thể lọc theo ngưỡng tối thiểu, để thu hẹp bundle trước khi chia sẻ.

/ak:repomix . --token-count-tree 1000
--no-security-check

Bỏ scan bảo mật

Tắt scan dựa trên Secretlint. Chỉ dùng sau quyết định rủi ro rõ ràng; đây không phải bằng chứng bundle an toàn để chia sẻ.

/ak:repomix . --no-security-check

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Snapshot codebase mặc định Khuyến nghị
/ak:repomix . --style xml
Dùng khi:
Dùng khi toàn bộ repo hiện tại cần trở thành ngữ cảnh AI đọc được để phân tích hoặc lập kế hoạch.
Kết quả:
Đánh giá độ nhạy và mục đích dùng, chạy gói XML chuẩn, rà số token và cảnh báo bảo mật, rồi trả file đầu ra kèm lưu ý.
Gói review có trọng tâm
/ak:repomix . --include "src/**/*.ts,*.md" --remove-comments --style markdown
Dùng khi:
Dùng khi cả người review và LLM cần một gói ngữ cảnh source và docs nhỏ hơn.
Kết quả:
Cấu hình bộ lọc include, loại comment được hỗ trợ, xuất gói Markdown để đọc và báo số token cùng vùng bị bỏ qua hoặc có rủi ro.
Audit thư viện remote
/ak:repomix --remote vendor/library --style xml -o audit.xml
Dùng khi:
Dùng khi cần đóng gói repo GitHub bên thứ ba để audit bảo mật hoặc đánh giá thư viện mà không clone.
Kết quả:
Đóng gói repo remote thành audit.xml, giữ kiểm tra bảo mật của Repomix, rà tóm tắt được tạo và nêu credential hoặc cảnh báo trước khi bàn giao.
Scan monorepo nặng token
/ak:repomix . --token-count-tree 1000
Dùng khi:
Dùng trước khi đóng gói monorepo lớn khi cần tìm phần chiếm nhiều token nhất trước.
Kết quả:
Tạo cây đếm token chỉ gồm mục lớn, xác định thư mục hoặc file nên include hoặc ignore và dùng tóm tắt đó để thu hẹp gói cuối.

Phạm vi xử lý

  • Snapshot repo thân thiện với AI
  • Đóng gói repo remote
  • Thiết kế pattern include và ignore
  • Phân tích cây đếm token
  • Kiểm tra bảo mật dựa trên Secretlint
  • Loại bỏ comment và định dạng đầu ra

Tiếp theo