Tóm tắt nhanh:
ak-project-organizationquét những gì bạn chỉ định, đưa bảng đề xuất từ đâu chuyển tới đâu, rồi di chuyển, đổi tên và kiểm lại cấu trúc cuối.ak-plan,ak-journal,ak-docscũng tra nó để biết nên ghi file vào đâu. Nó không ép quy tắc của mình lên repo đã có quy ước, và không có skill tiếp theo cố định.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn có một thư mục lộn xộn, hoặc cần chỗ cho một loại file mà repo chưa có quy ước. Không cần khi chỉ tạo một file bình thường: cứ làm như thường, agent theo quy ước sẵn có của repo.
flowchart LR
A["Thư mục lộn xộn hoặc cần cấu trúc mới"] --> B["ak-project-organization"]
B --> C["Bảng đề xuất từ → tới"]
C --> D["Di chuyển, đổi tên, kiểm lại"]
E["ak-plan, ak-journal, ak-docs"] -->|"hỏi chỗ ghi file"| B
B --> F["Đường dẫn và tên đúng"]Bốn ý cốt lõi:
| Ý | Câu hỏi | Ví dụ |
|---|---|---|
| Hai chế độ | Ai gọi skill, và nó trả lại gì? | Bạn gọi với assets/ thì nó sắp xếp lại; ak-journal gọi thì chỉ nhận đường dẫn và tên file |
| Quy ước của repo đi trước | Khi repo đã có cách làm riêng, skill theo ai? | Repo Go dùng user_auth_service.go thì giữ snake_case |
| Ba kiểu đặt tên | Tên file có cần ngày không? | 260304-1530-auth-plan, system-architecture.md, logo-dark.svg |
| Một file hay một thư mục | Kết quả nên là file phẳng hay thư mục riêng? | Video lẻ ở assets/videos/launch.mp4, video kèm phụ đề gom vào assets/videos/launch/ |
Thay đổi đảo ngược được thì nó làm tiếp, không hỏi từng bước. Nó chỉ dừng lại hỏi khi có ghi đè, mất thay đổi chưa commit hoặc quyết định cấu trúc chưa rõ, và không bao giờ ghi đè file đã có.
Prompt mẫu cho dọn thư mục asset:
/ak-project-organization assets/
Gom file theo đúng loại: ảnh, logo, video, thiết kế.
Xong khi: mỗi file nằm trong thư mục loại của nó và tên theo quy ước của repo.Skill này không có cờ. Đầu vào duy nhất là danh sách thư mục hoặc file cần sắp xếp, ví dụ assets/ hay plans/ docs/; phần còn lại của prompt là kết quả và ràng buộc bạn muốn giữ.
Phần dưới đây là bản chi tiết: luồng chạy, 4 tình huống kèm prompt, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-project-organization: dọn file và thư mục cho đúng chỗ, đúng tên" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-project-organization". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-project-organization
