Lập kế hoạch bằng tệp (Planning with Files)
Duy trì ba tệp task_plan.md, findings.md và progress.md trên đĩa để công việc nhiều bước không bị mất khi ngữ cảnh bị xóa.
Tự động hóaTrung cấp★ 26,167⑂ 2,188Điểm AI 10/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
- Buộc tạo task_plan.md (các giai đoạn và trạng thái), findings.md (kết quả nghiên cứu), progress.md (nhật ký phiên) ngay trong thư mục dự án trước khi bắt đầu việc phức tạp.
- Áp dụng mô hình kiểu Manus: cửa sổ ngữ cảnh là RAM, hệ thống tệp là đĩa — mọi thứ quan trọng đều được ghi ra tệp nên sống sót qua
/clearvà nén ngữ cảnh. - Các hook (UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact) tự động chèn lại kế hoạch và nhắc cập nhật tiến độ sau mỗi lần ghi/sửa tệp.
- Script
session-catchup.pyphát hiện thay đổi chưa đồng bộ từ phiên trước và kết hợpgit diff --statđể phục hồi trạng thái. - Cung cấp quy tắc cụ thể: quy tắc 2 hành động, giao thức lỗi 3 lần thử, bảng quyết định đọc/ghi, bài kiểm tra 5 câu hỏi khởi động lại.
Phù hợp với ai
- Lập trình viên xử lý refactor, migration dài hơi cần hàng chục lượt gọi công cụ.
- Người hay bị mất mạch việc sau khi
/clearhoặc chuyển phiên làm việc. - Nhà nghiên cứu, phân tích cần lưu lại phát hiện một cách có cấu trúc.
Ví dụ sử dụng
- Chuyển đổi dự án sang TypeScript: agent tạo task_plan.md chia thành các giai đoạn và đánh dấu
completesau mỗi bước. - Nối lại công việc hôm trước: chạy
session-catchup.py, đọc báo cáo chênh lệch, cập nhật tệp kế hoạch rồi tiếp tục. - Theo dõi lỗi build lặp lại: mỗi lỗi được ghi vào bảng kèm lần thử và cách xử lý; sau 3 lần thất bại sẽ báo lại cho người dùng.
· · · 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/.mastracode/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 .mastracode/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-9/ 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/.mastracode/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.
- Tải mã nguồn:
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files - Sao chép thư mục kỹ năng:
mkdir -p ~/.claude/skills && cp -r /tmp/planning-with-files/.mastracode/skills/planning-with-files ~/.claude/skills/ - Cấp quyền chạy cho script:
chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh - Kiểm tra Python:
python3 --version(cần cho script phục hồi phiên). - Nếu cài ở đường dẫn khác, thêm
export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files/scriptsvào cấu hình shell. - Khởi động lại Claude Code và yêu cầu "hãy lập kế hoạch từng bước cho việc này" để kích hoạt.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT