Lập kế hoạch bằng tệp (Planning with Files)
Duy trì task_plan.md, findings.md và progress.md trên ổ đĩa để AI không mất mục tiêu và tiến độ trong các tác vụ nhiều bước.
Tự động hóaTrung cấp★ 27,074⑂ 2,254Điểm AI 10/10Cập nhật lần cuối: 22 thg 9, 2026
Làm được gì
- Áp dụng mô hình "bộ nhớ làm việc trên ổ đĩa": cửa sổ ngữ cảnh là RAM, hệ thống tệp là đĩa.
- Tạo và cập nhật ba tệp trong thư mục dự án: task_plan.md (giai đoạn, quyết định), findings.md (kết quả tra cứu), progress.md (log phiên làm việc).
- Các hook UserPromptSubmit / PreToolUse / PostToolUse / Stop / PreCompact tự động chèn lại nội dung kế hoạch, giúp phục hồi trạng thái sau khi ngữ cảnh bị nén hoặc phiên bị ngắt.
- Kèm script hỗ trợ:
init-session.sh(khởi tạo),check-complete.sh(kiểm tra hoàn thành),set-active-plan.sh --list(liệt kê kế hoạch),session-catchup.py --metadata(tổng hợp bản ghi phiên cùng dự án). - Có quy tắc xử lý lỗi "3 lần thử rồi báo người dùng", cấm lặp lại hành động đã thất bại, và biên an toàn: nội dung web chỉ ghi vào findings.md.
Phù hợp với ai
- Người thường giao các việc cần 5+ lượt gọi tool: nghiên cứu, refactor, dựng dự án.
- Ai gặp tình trạng AI "quên" mục tiêu ban đầu khi hội thoại dài.
- Nhóm cần tiếp tục một tác vụ qua nhiều phiên, hoặc chia việc theo mô hình orchestrator/worker.
Ví dụ sử dụng
- Trước khi refactor lớn, chạy
scripts/init-session.sh "Refactor auth", ghimPLAN_IDđược in ra rồi thực hiện theo từng giai đoạn. - Quay lại sau vài ngày: chạy
session-catchup.py --metadata "$(pwd)"và đọc ba tệp kế hoạch để phục hồi trạng thái. - Khi tra cứu tài liệu/web, sau mỗi 2 lần tìm kiếm lưu ngay ý chính vào findings.md để không mất dữ liệu sau khi ngữ cảnh bị né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/.factory/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 .factory/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-5/ 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/.factory/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 /tmp/pwf - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy skill:
cp -r /tmp/pwf/.factory/skills/planning-with-files ~/.claude/skills/ - Cấp quyền chạy cho script:
chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh - (Tuỳ chọn) Nếu cài ở đường dẫn khác, thêm vào shell profile:
export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files/scripts - Kiểm tra Python:
python3 --version(cần cho session-catchup.py). - Khởi động lại Claude Code, ở thư mục gốc dự án hãy yêu cầu "lập kế hoạch tác vụ này ra tệp" để xác nhận skill hoạt động.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT