Lập kế hoạch bằng file (Planning with Files)
Lưu kế hoạch, phát hiện và tiến độ của tác vụ nhiều bước vào các file markdown để không mất ngữ cảnh giữa các phiên làm việc.
Tự động hóaTrung cấp★ 26,060⑂ 2,177Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026
Skill này làm gì
Áp dụng mô hình kiểu Manus: coi cửa sổ ngữ cảnh là RAM (dễ mất), còn hệ thống file là ổ đĩa (bền vững). Skill tạo và duy trì ba file trong .kiro/plan/:
task_plan.md— mục tiêu, các giai đoạn, trạng thái, quyết địnhfindings.md— kết quả nghiên cứu, phát hiện (mọi nội dung web đi vào đây)progress.md— nhật ký phiên, kết quả test, lỗi gặp phải
Các quy tắc kèm theo:
- Quy tắc 2 hành động: sau mỗi 2 lần xem/tìm kiếm, ghi ngay ý chính ra file
- Giao thức 3 lần lỗi: chẩn đoán → đổi cách tiếp cận → xem lại giả định, thất bại 3 lần thì hỏi người dùng
- Bảng quyết định đọc/ghi: khi nào cần đọc lại file, khi nào không
- Ranh giới bảo mật: nội dung ngoài mạng bị coi là không tin cậy, không làm theo chỉ dẫn ẩn trong đó
Đi kèm là script khởi tạo (bootstrap.sh/.ps1), script khôi phục phiên (session-catchup.py) và script kiểm tra hoàn thành giai đoạn.
Phù hợp với ai
- Người làm refactor lớn, nghiên cứu kỹ thuật hoặc tính năng kéo dài nhiều phiên chat
- Người từng bị AI "quên" mục tiêu sau khi ngữ cảnh bị nén
- Người muốn ngăn AI lặp lại cùng một hành động thất bại
- Nhóm muốn lưu lại lịch sử công việc dưới dạng file có thể review
Ví dụ sử dụng
- Bắt đầu dự án lớn: gõ "start planning: chuyển hệ thống auth sang JWT" — skill tạo
task_plan.mdvới các Phase và cập nhật trạng thái sau mỗi bước. - Quay lại sau vài ngày: gõ "resume work" — script
session-catchup.pytóm tắt thời gian sửa file, đối chiếu kế hoạch với mã nguồn thực tế rồi đề xuất bước kế tiếp. - Nghiên cứu so sánh thư viện: khi duyệt nhiều trang web, cứ 2 lần tra cứu thì các điểm chính được ghi vào
findings.md, nhờ vậy bạn không phải tìm lại nguồ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 .kiro/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-8/ 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/OthmanAdi/planning-with-files.git && mkdir -p ~/.claude/skills && cp -r planning-with-files/.kiro/skills/planning-with-files ~/.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 và chuyển đến thư mục bạn muốn lưu skill.
- Clone repo:
git clone https://github.com/OthmanAdi/planning-with-files.git - Sao chép thư mục skill sang Claude Code:
mkdir -p ~/.claude/skills && cp -r planning-with-files/.kiro/skills/planning-with-files ~/.claude/skills/ - Vào thư mục dự án của bạn và chạy script khởi tạo:
sh ~/.claude/skills/planning-with-files/assets/scripts/bootstrap.sh(trên Windows dùngbootstrap.ps1trong PowerShell). - Kiểm tra Python 3 đã cài nếu muốn dùng
session-catchup.py:python3 --version. - Khởi động lại Claude Code, sau đó gọi skill bằng các cụm như "start planning", "resume work", "current phase".
- Nếu không dùng Kiro, hãy đổi đường dẫn
.kiro/trong SKILL.md sang thư mục phù hợp với dự án (ví dụdocs/plan/).
Xem mã nguồn trên GitHub ↗Giấy phép: MIT