init-deep — Trình tạo kho tri thức AGENTS.md phân cấp

Kỹ năng này làm gì

Chỉ với lệnh /init-deep, kỹ năng duyệt toàn bộ mã nguồn và dựng nên một kho tri thức AGENTS.md phân cấp dành cho AI agent.

• Khám phá: chạy song song nhiều sub-agent explore để lập bản đồ cấu trúc, tìm entry point, tệp cấu hình (.eslintrc, pyproject.toml), các bình luận cấm (DO NOT/NEVER), build/CI và quy ước test.
• Phân tích: dùng bash đếm độ sâu thư mục và số tệp, kết hợp LSP (lsp_symbols, lsp_find_references) cùng tìm kiếm cấu trúc ast-grep để đo mật độ symbol, số export và mức độ được tham chiếu.
• Chấm điểm: ma trận trọng số (số tệp 3x, số thư mục con 2x, độ trung tâm tham chiếu 3x…). Điểm >15 thì tạo AGENTS.md, 8–15 chỉ tạo khi là domain riêng, <8 thì bỏ qua.
• Sinh & rà soát: tệp gốc dùng khuôn mẫu đầy đủ (OVERVIEW, STRUCTURE, CODE MAP, CONVENTIONS, ANTI-PATTERNS, 50–150 dòng), tệp con 30–80 dòng và loại bỏ nội dung trùng với tệp cha.

Hỗ trợ --create-new (tạo lại từ đầu) và --max-depth=N (giới hạn độ sâu).

Phù hợp với ai

• Lập trình viên lần đầu đưa AI agent vào một repo lớn/legacy gần như không có tài liệu.
• Nhóm làm monorepo, mỗi package có quy ước riêng cần mô tả cho agent.
• Maintainer muốn làm mới các tệp CLAUDE.md / AGENTS.md đã lỗi thời.

Ví dụ sử dụng

1. Nắm nhanh dự án mới: chạy /init-deep trên repo 500 tệp vừa clone, bạn nhận được AGENTS.md gốc tóm tắt stack, sơ đồ thư mục và bảng symbol chính — dùng luôn làm tài liệu onboarding.
2. Tài liệu hóa monorepo: chấm điểm từng packages/* và chỉ đặt AGENTS.md ở nơi thực sự phức tạp, tránh lặp lại nội dung của tệp cha.
3. Làm lại tài liệu: khi hướng dẫn cũ đã lộn xộn, dùng /init-deep --create-new để đọc và giữ ngữ cảnh cũ rồi tái tạo toàn bộ.

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục packages/omo-senpi/skills/init-deep từ repo GitHub code-yeongyu/oh-my-openagent vào ~/.claude/skills/code-yeongyu-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.