Lập kế hoạch bằng file (Planning with Files)
Giữ kế hoạch, phát hiện và tiến độ trong các file markdown trên đĩa để công việc không mất khi ngữ cảnh bị xóa hoặc nén.
Làm được gì
Đưa mô hình "bộ nhớ làm việc trên đĩa" kiểu Manus vào Claude Code. Khi bắt đầu một việc phức tạp, skill tạo ba file trong thư mục dự án:
task_plan.md— các giai đoạn (Phase), trạng thái, bước tiếp theo, quyết địnhfindings.md— nơi lưu mọi phát hiện khi nghiên cứuprogress.md— log phiên làm việc, kết quả test, lỗi gặp phải
Các hook UserPromptSubmit / PreToolUse / PreCompact / Stop tự chèn nội dung kế hoạch vào ngữ cảnh, và session-catchup.py phục hồi trạng thái sau /clear hoặc compaction. Kèm theo là các quy tắc thực chiến (lưu phát hiện sau mỗi 2 thao tác, giao thức 3 lần thử rồi hỏi người dùng, bài test 5 câu hỏi), kế hoạch song song trong .planning/<ngày-slug>/, xác thực kế hoạch bằng SHA-256, chế độ autonomous/gated và cảnh báo mất dữ liệu khi hai phiên ghi cùng lúc.
Phù hợp với ai
- Người thường xử lý refactor, migration, nghiên cứu nhiều bước và nhiều lần gọi tool
- Người hay bị mất mạch việc khi ngữ cảnh đầy hoặc sau khi
/clear - Người chạy nhiều tác vụ song song trong cùng một repo và muốn tách kế hoạch
- Người cần điều kiện dừng và cơ chế an toàn cho vòng lặp agent chạy dài
Ví dụ sử dụng
- "Migrate module auth cũ sang OAuth" → tạo kế hoạch 6 giai đoạn trong
task_plan.md; kể cả khi/clear, lượt sau agent đọc lại kế hoạch và tiếp tục đúng chỗ. - Làm song song refactor backend và điều tra sự cố:
./scripts/init-session.sh "Backend Refactor"và"Incident Investigation", chuyển qua lại bằngset-active-plan.sh. - Chạy pipeline build qua đêm:
init-session.sh --gated "Build Pipeline"bật cổng hoàn thành để không dừng sớm khi còn giai đoạn dở, đồng thời có bộ đếm chặn và phát hiện đình trệ để tránh loop vô hạn.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/OthmanAdi/planning-with-files/HEAD/skills/planning-with-files/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
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 skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-11/ 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 /tmp/planning-with-files && mkdir -p ~/.claude/skills && cp -r /tmp/planning-with-files/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à clone repo vào thư mục tạm:
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files - Tạo thư mục skills:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r /tmp/planning-with-files/skills/planning-with-files ~/.claude/skills/ - (Khuyến nghị) Nếu muốn dùng cả lệnh
/plan-goalvà/plan-loop, hãy cài theo đường plugin: trong Claude Code chạy/plugin marketplace add OthmanAdi/planning-with-filesrồi/plugin install. - Khởi động lại Claude Code để các hook được đăng ký.
- Vào thư mục dự án và yêu cầu "hãy lập kế hoạch từng bước cho việc này" — file
task_plan.mdsẽ được tạo. - Nếu hook không phản hồi, chạy
sh ~/.claude/skills/planning-with-files/scripts/plan-doctor.shđể tự kiểm tra. Lưu ýsession-catchup.pycần python3.