Lập kế hoạch bằng file (Planning with Files)
Giữ task_plan.md, findings.md và progress.md trên đĩa theo phong cách Manus để công việc không bị mất sau /clear hay khi context bị nén.
Làm được gì
Skill coi cửa sổ context như RAM và hệ thống file như đĩa cứng. Khi bắt đầu một tác vụ nhiều bước, nó tạo và liên tục cập nhật ba file markdown trong thư mục dự án:
task_plan.md— các Phase, trạng thái, bước kế tiếp, quyết định đã chốtfindings.md— kết quả nghiên cứu, phát hiện (đặc biệt là nội dung ảnh/PDF/trang web dễ biến mất)progress.md— log phiên làm việc, kết quả test, lỗi gặp phải
Skill đăng ký các hook (UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact) để nhắc lại kế hoạch mỗi lượt, và dùng session-catchup.py để phục hồi ngữ cảnh sau /clear. Ngoài ra còn có giao thức 3 lần thử rồi báo người dùng, thư mục kế hoạch song song .planning/<ngày-slug>/, ký SHA‑256 cho kế hoạch (attestation) và hai chế độ nâng cao autonomous / gated.
Phù hợp với ai
- Người thường giao cho Claude các tác vụ dài, cần 5+ lần gọi tool
- Ai từng gặp cảnh agent quên mục tiêu hoặc lặp lại đúng lỗi cũ khi hội thoại dài
- Người làm nhiều tác vụ song song trên cùng một repo, nhiều terminal
- Người muốn lưu lại kết quả nghiên cứu thành tài liệu để chia sẻ trong nhóm
Ví dụ sử dụng
- Refactor backend lớn: chạy
init-session.sh "Backend Refactor", cập nhật trạng thái từng Phase; khi context đầy và bị nén, agent đọc lại file kế hoạch và tiếp tục đúng chỗ. - Phục hồi sau
/clear: gọi skill, nó so báo cáo catchup vớigit diff --statđể ghi bổ sung những thay đổi chưa được log vào kế hoạch. - Nghiên cứu dài hạn: theo quy tắc "2 hành động", cứ sau 2 lần đọc tài liệu/trang web là ghi ngay điểm chính vào
findings.md, tránh mất thông tin đa phương thứ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 .pi/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/pi-planning-with-files/ 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 ~/.claude/skills/planning-with-files⚠ Đâ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à tải skill:
git clone https://github.com/OthmanAdi/planning-with-files.git ~/.claude/skills/planning-with-files - Nếu muốn dùng cả lệnh slash
/plan-goal,/plan-loop, hãy cài theo đường plugin trong Claude Code: chạy/plugin marketplace add OthmanAdi/planning-with-filesrồi/plugin install. - Kiểm tra:
ls ~/.claude/skills/planning-with-filesphải thấySKILL.md,scripts/,templates/. - Khởi động lại Claude Code để các hook được nạp.
- Mở thư mục dự án của bạn và yêu cầu kiểu "hãy lập kế hoạch từng bước cho việc này" — skill sẽ tạo
task_plan.mdvà các file liên quan. - Tùy chọn: với nhiều tác vụ song song, chạy
sh ~/.claude/skills/planning-with-files/scripts/init-session.sh "Tên tác vụ"; nếu hook có vẻ không chạy, dùngscripts/plan-doctor.shđể tự kiểm tra. - Lưu ý: file kế hoạch nằm ở gốc dự án nên có thể thêm vào
.gitignore; chế độ gated có thể chặn việc kết thúc phiên, nên hãy bắt đầu bằng chế độ mặc định.