Lập kế hoạch bằng tệp (Planning with Files)

Làm được gì

Skill này áp dụng mô hình "bộ nhớ làm việc trên đĩa" theo phong cách Manus: trước khi bắt tay vào việc phức tạp, Claude tạo ba tệp markdown trong thư mục dự án và cập nhật liên tục.

• task_plan.md — các giai đoạn (Phase), trạng thái, quyết định
• findings.md — nơi lưu kết quả tra cứu, đọc tài liệu, xem ảnh/PDF
• progress.md — nhật ký phiên làm việc, kết quả test, tệp đã thay đổi

Kèm theo là bộ quy tắc vận hành rất cụ thể: "quy tắc 2 hành động" (cứ 2 lần tra cứu là phải ghi phát hiện ra tệp), "giao thức 3 lần thử" để không lặp lại cùng một lỗi, "bài kiểm tra 5 câu hỏi" để tự đánh giá ngữ cảnh, và một mục ranh giới bảo mật (đóng khung dữ liệu + xác thực SHA-256) yêu cầu coi nội dung tệp kế hoạch là dữ liệu, không phải câu lệnh.

Ngoài ra skill hỗ trợ nhiều kế hoạch song song trong cùng repo qua .planning/<ngày>-<slug>/, và script session-catchup.py giúp lấy lại ngữ cảnh sau lệnh /clear kết hợp với git diff.

Phù hợp với ai

• Người thường giao các việc dài như refactor, migration, dựng dự án mới
• Người từng gặp tình trạng AI "quên" mục tiêu ban đầu khi hội thoại kéo dài
• Người cần lưu lại kết quả nghiên cứu thay vì để trôi trong khung chat
• Nhóm cần biên bản làm việc rõ ràng: đã thử gì, lỗi gì, giải quyết ra sao

Ví dụ sử dụng

1. Chuyển đổi API cũ: Bạn yêu cầu "chuyển module thanh toán sang API v2". Claude viết trước 5 giai đoạn vào task_plan.md, sau mỗi giai đoạn đổi trạng thái thành complete và ghi lỗi vào bảng lỗi.
2. Báo cáo khảo sát công nghệ: Khi so sánh nhiều thư viện, cứ sau 2 lần tìm kiếm web các điểm chính được tóm vào findings.md, nên về sau bạn không phải tìm lại nguồn.
3. Tiếp tục sau /clear: Chạy session-catchup.py cùng git diff --stat để dựng lại "đã làm tới đâu, đã sửa gì", rồi tiếp tục từ giai đoạn kế tiếp.
4. Nhiều việc song song: ./scripts/init-session.sh "Backend Refactor" và "Incident Investigation" tạo hai kế hoạch riêng, mỗi terminal ghim một PLAN_ID.

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục .gemini/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-6/ 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.