Lập kế hoạch bằng file (Planning with Files)
Kỹ năng kiểu Manus giữ task_plan, findings và progress dưới dạng file markdown trên đĩa để công việc không mất khi ngữ cảnh bị nén hay /clear.
Kỹ năng này làm gì
Áp dụng nguyên tắc Manus: cửa sổ ngữ cảnh là "RAM" (dễ mất), hệ thống file là "đĩa" (bền vững). Trước mọi tác vụ phức tạp, agent buộc phải tạo ba file markdown trong thư mục dự án và cập nhật liên tục:
task_plan.md— các giai đoạn, trạng thái, quyết định quan trọngfindings.md— kết quả nghiên cứu, phát hiệnprogress.md— nhật ký phiên làm việc, kết quả test
Kỹ năng đăng ký các hook (UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact) để tiêm lại kế hoạch vào ngữ cảnh, nhắc cập nhật tiến độ sau khi sửa file, và dùng session-catchup.py để khôi phục ngữ cảnh sau /clear. Ngoài ra còn có giao thức xử lý lỗi 3 lần thử, quy tắc 2 hành động, bảng quyết định đọc/ghi và danh sách anti-pattern.
Phù hợp với ai
- Người thường xuyên chạy các tác vụ dài hàng chục lượt gọi công cụ (refactor, migration)
- Ai từng bực bội vì mất mạch công việc sau khi hội thoại bị nén hoặc
/clear - Lập trình viên muốn lưu lại lịch sử lỗi và kết quả nghiên cứu một cách có hệ thống
- Nhóm dùng song song Cursor và Claude Code, muốn chia sẻ cùng bộ file kế hoạch
Ví dụ sử dụng
- Refactor lớn: yêu cầu "chuyển repo này sang TypeScript" — agent tạo
task_plan.mdvới 5–7 giai đoạn, đánh dấucompletesau mỗi giai đoạn và ghi bảng lỗi build đã gặp. - Nghiên cứu kỹ thuật: khi so sánh nhiều thư viện, cứ sau 2 lần tìm kiếm là ghi tóm tắt vào
findings.md, nên bảng so sánh vẫn còn dù ngữ cảnh bị nén. - Khôi phục phiên: sáng hôm sau chạy script catchup cùng
git diff --stat, cập nhật file kế hoạch rồi tiếp tục đúng giai đoạn còn dang dở.
· · · 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 .cursor/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-4/ 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/pwf && mkdir -p ~/.claude/skills && cp -r /tmp/pwf/.cursor/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 kho:
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf - Tạo thư mục skill:
mkdir -p ~/.claude/skills(dùng Cursor thì là~/.cursor/skills) - Sao chép skill:
cp -r /tmp/pwf/.cursor/skills/planning-with-files ~/.claude/skills/ - Cấp quyền chạy cho script:
chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh - Mở xem nội dung các script trong
scripts/và lệnh hook một lượt, vì chúng chạy tự động. - Khởi động lại Claude Code, 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" để kiểm tra
task_plan.mdđược tạo. - Nếu cài ở đường dẫn không chuẩn, đặt biến môi trường
PWF_SCRIPT_DIRtrỏ tới thư mụcscriptscủa skill.