Lập kế hoạch bằng file (Planning with Files)
Buộc AI chia việc phức tạp thành ba file task_plan.md, findings.md, progress.md để lập kế hoạch, ghi nhật ký và phục hồi ngữ cảnh.
Tự động hóaTrung cấp★ 26,415⑂ 2,209Điểm AI 10/10Cập nhật lần cuối: 29 thg 8, 2026
Làm được gì
- Áp dụng mô hình "bộ nhớ làm việc trên đĩa" kiểu Manus: trước mọi tác vụ phức tạp, AI phải tạo task_plan.md (các pha, quyết định), findings.md (kết quả nghiên cứu) và progress.md (nhật ký phiên).
- Sau mỗi pha, trạng thái được cập nhật
in_progress → completevà mọi lỗi được ghi thành bảng để không lặp lại thất bại. - Cung cấp giao thức 3 lần thử (chẩn đoán → phương án khác → xem lại giả định → báo người dùng) và quy tắc 2 hành động (cứ 2 lần xem/tìm kiếm là lưu ngay vào file).
- Phục hồi ngữ cảnh sau
/clearnhờsession-catchup.pykết hợpgit diff --stat. - Hỗ trợ nhiều kế hoạch song song trong cùng repo qua
.planning/YYYY-MM-DD-<slug>/và script chuyển kế hoạch đang hoạt động. - Có lớp phòng vệ prompt injection: coi nội dung file kế hoạch là dữ liệu, kèm xác thực hash SHA-256.
Phù hợp với ai
- Người thường giao các việc cần 5+ lượt gọi tool: refactor lớn, nghiên cứu, dựng project.
- Ai từng gặp cảnh AI "quên" mục tiêu ban đầu khi hội thoại dài.
- Người muốn tiếp tục công việc sau khi xoá ngữ cảnh hoặc mất phiên.
- Cá nhân/nhóm chạy nhiều luồng công việc song song trong một repo.
Ví dụ sử dụng
- Refactor lớn: "Refactor module auth backend" → tạo task_plan.md 6 pha, cập nhật trạng thái từng pha, ghi lại lỗi migration vào bảng.
- Nghiên cứu kỹ thuật: khi so sánh nhiều thư viện, cứ 2 lần tìm kiếm là tóm tắt vào findings.md để không mất nội dung ảnh/tài liệu khỏi ngữ cảnh.
- Phục hồi phiên: sau
/clear, chạysession-catchup.py, đối chiếugit diff --stat, cập nhật file kế hoạch rồi tiếp tục đúng điểm dừng. - Việc song song:
./scripts/init-session.sh "Incident Investigation"tạo kế hoạch riêng, dùngset-active-plan.shđể đổi qua lại với kế hoạch refactor.
· · · 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/.gemini/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 .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.
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/.gemini/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:
git clone https://github.com/OthmanAdi/planning-with-files.git - Copy thư mục skill vào Claude Code:
mkdir -p ~/.claude/skills && cp -r planning-with-files/.gemini/skills/planning-with-files ~/.claude/skills/ - Kiểm tra đã có các thư mục
templates/,scripts/,references/:ls ~/.claude/skills/planning-with-files - 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). - Khởi động lại Claude Code, vào thư mục dự án và yêu cầu kiểu "hãy lập kế hoạch từng bước cho việc này" để kích hoạt skill.
- Các file kế hoạch được tạo ở gốc dự án. Nếu không muốn commit, thêm
task_plan.md,findings.md,progress.md,.planning/vào.gitignore. - (Tuỳ chọn) Sau khi chốt kế hoạch, chạy
sh ~/.claude/skills/planning-with-files/scripts/attest-plan.shđể khoá hash file kế hoạch và phát hiện sửa đổi ngầm.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT