init-deep — Trình tạo cơ sở tri thức AGENTS.md phân cấp
Phân tích toàn bộ codebase rồi tự động sinh các file AGENTS.md phân cấp ở thư mục gốc và các thư mục quan trọng.
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
Làm được gì
Lệnh /init-deep quét toàn dự án và dựng một cơ sở tri thức AGENTS.md theo cấp bậc.
- Pha 1 – Khám phá song song: bung nhiều agent explore (cấu trúc, entry point, quy ước, anti-pattern, build/CI, test) trong nền, đồng thời phiên chính chạy thống kê bash và bản đồ ký hiệu qua LSP/codegraph. Số agent tăng động theo số file, số dòng, độ sâu thư mục, monorepo, số ngôn ngữ.
- Pha 2 – Chấm điểm: ma trận trọng số (số file x3, độ trung tâm tham chiếu x3, mật độ symbol, ranh giới module...) quyết định thư mục nào cần AGENTS.md: >15 tạo, 8–15 chỉ khi là domain riêng, <8 bỏ qua.
- Pha 3 – Sinh tài liệu: file gốc đầy đủ 50–150 dòng (OVERVIEW, STRUCTURE, WHERE TO LOOK, CODE MAP, CONVENTIONS, ANTI-PATTERNS, COMMANDS); file con 30–80 dòng, viết song song. File đã tồn tại chỉ được sửa bằng Edit, không ghi đè.
- Pha 4 – Rà soát: xoá nội dung trùng với cấp cha, xoá lời khuyên chung chung, cắt gọn độ dài.
Hỗ trợ --create-new (đọc rồi tạo lại từ đầu) và --max-depth=N.
Phù hợp với ai
- Lập trình viên tiếp quản repo lớn, ít tài liệu và muốn AI hiểu nhanh dự án
- Nhóm làm monorepo cần tài liệu ngữ cảnh riêng cho từng package
- Tech lead muốn có "bản đồ nên xem ở đâu" cho người mới
- Người đang dùng hệ đa agent OMO / Codex
Ví dụ sử dụng
- Monorepo 50k dòng mới nhận bàn giao: chạy
/init-deep, nhận AGENTS.md gốc cùng các file con chỉ ởpackages/api,packages/webcó điểm cao. - Tài liệu đã cũ: chạy lại
/init-deepkhông tham số để giữ nội dung còn đúng và chỉ cập nhật phần thay đổi. - Viết lại toàn bộ sau refactor:
/init-deep --create-new --max-depth=2để tái sinh tài liệu nhưng giới hạn 2 cấp thư mục.
· · · 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/omo-codex/plugin/skills/init-deep từ repo GitHub code-yeongyu/oh-my-openagent vào ~/.claude/skills/init-deep/ 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/omo && mkdir -p ~/.claude/skills && cp -r /tmp/omo/packages/omo-codex/plugin/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.
- Tạo thư mục skill:
mkdir -p ~/.claude/skills - Tải mã nguồn:
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/omo - Sao chép skill:
cp -r /tmp/omo/packages/omo-codex/plugin/skills/init-deep ~/.claude/skills/ - Kiểm tra:
ls ~/.claude/skills/init-deep/SKILL.md - Khởi động lại Claude Code, vào thư mục dự án và gõ
/init-deephoặc yêu cầu "dùng skill init-deep tạo AGENTS.md". - Lưu ý: nếu môi trường không có codegraph/LSP hay công cụ spawn subagent, các bước đó sẽ bị bỏ qua và chất lượng tài liệu giảm. Nên commit git trước khi chạy.
Xem mã nguồn trên GitHub ↗Giấy phép: NOASSERTION