init-deep — Trình tạo AGENTS.md phân cấp
Phân tích toàn bộ dự án và tạo hệ thống tài liệu AGENTS.md phân cấp ở thư mục gốc cùng các thư mục con phức tạp.
Lập trìnhNâng cao★ 67,531⑂ 5,507Điểm AI 7/10Cập nhật lần cuối: 9 thg 8, 2026
Nó làm được gì
Chỉ với lệnh /init-deep, skill quét repo và sinh cơ sở tri thức AGENTS.md phân cấp dành cho AI agent.
- Bước 1 – Khám phá song song: chạy nhiều agent explore cùng lúc (cấu trúc, entry point, convention, anti-pattern, build/CI, test) trong khi phiên chính dùng bash để đo độ sâu thư mục, số file, mật độ code. Số agent được tăng động theo quy mô dự án (>100 file, >10k dòng, độ sâu ≥4, monorepo, nhiều ngôn ngữ).
- Bước 2 – Tính điểm: cộng có trọng số số file (x3), số thư mục con (x2), mật độ symbol, số export, độ trung tâm tham chiếu (từ LSP/codegraph). Điểm >15 → tạo AGENTS.md; 8–15 → chỉ tạo nếu là domain riêng; <8 → bỏ qua.
- Bước 3 – Sinh file: file gốc theo mẫu OVERVIEW / STRUCTURE / WHERE TO LOOK / CODE MAP / CONVENTIONS / ANTI-PATTERNS / COMMANDS, dài 50–150 dòng; file con 30–80 dòng, viết song song. File đã tồn tại thì dùng Edit, không ghi đè bằng Write.
- Bước 4 – Rà soát: xoá lời khuyên chung chung, xoá phần trùng với tài liệu cha, cắt bớt cho đúng giới hạn, kiểm tra văn phong ngắn gọn.
Hỗ trợ --create-new (đọc rồi tái tạo từ đầu) và --max-depth=N (giới hạn độ sâu).
Phù hợp với ai
- Lập trình viên muốn chuẩn hoá tài liệu ngữ cảnh cho AI trong repo đã lớn
- Nhóm làm monorepo nhiều package, cần tách quy ước theo từng package
- Tech lead muốn giảm thời gian onboarding cho người mới và cho agent
Ví dụ sử dụng
- Thiết lập lần đầu: monorepo Next.js + Python ~30k dòng, chạy
/init-deep→ tạo AGENTS.md gốc và chỉ thêm file con ởapps/web,packages/api. - Cập nhật sau refactor: chạy lại
/init-deepđể Edit phần STRUCTURE và COMMANDS trong tài liệu cũ cho khớp code hiện tại. - Tái tạo sạch: khi tài liệu đã lộn xộn, dùng
/init-deep --create-new --max-depth=2để dựng lại bộ tài liệu gọn hơn.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục packages/shared-skills/skills/init-deep từ repo GitHub code-yeongyu/oh-my-openagent vào ~/.claude/skills/code-yeongyu-init-deep-2/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/oh-my-openagent && mkdir -p ~/.claude/skills && cp -r /tmp/oh-my-openagent/packages/shared-skills/skills/init-deep ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal.
- Clone repo vào thư mục tạm:
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/oh-my-openagent - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy skill:
cp -r /tmp/oh-my-openagent/packages/shared-skills/skills/init-deep ~/.claude/skills/ - Kiểm tra file
~/.claude/skills/init-deep/SKILL.mdđã tồn tại. - Khởi động lại Claude Code, mở thư mục dự án và gõ
/init-deephoặc yêu cầu "tạo AGENTS.md phân cấp cho repo này". - Lưu ý: skill dựa vào các tool
codegraph_*,lsp_*và sub-agent chạy nền. Nếu môi trường không có, Claude sẽ dùng cách quét file thông thường và bản đồ code sẽ kém chính xác hơn. - Mẹo: lần đầu nên chạy
--max-depth=2để kiểm soát số lượng file được sinh ra.
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION