Lập kế hoạch bằng file (Planning with Files)
Buộc AI agent lưu kế hoạch, phát hiện và tiến độ vào các file Markdown trên đĩa để không mất trạng thái khi ngữ cảnh bị nén hoặc reset.
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ì
- Tạo và cập nhật liên tục
task_plan.md(các pha, quyết định),findings.md(kết quả nghiên cứu),progress.md(log phiên làm việc) ngay trong thư mục dự án của bạn. - Áp dụng tư duy "ngữ cảnh = RAM, file = ổ đĩa": mọi thứ quan trọng đều được ghi ra file.
- Dùng hook UserPromptSubmit/PreToolUse/PostToolUse/Stop/PreCompact để tự chèn ngữ cảnh kế hoạch và giữ trạng thái trước khi hội thoại bị nén.
- Cung cấp script hỗ trợ:
init-session.sh,check-complete.sh,set-active-plan.sh --list,session-catchup.py --metadata/--replay. - Có bộ quy tắc rõ ràng: ghi phát hiện sau mỗi 2 lần xem/tra cứu, đọc lại kế hoạch trước khi quyết định, log mọi lỗi, và quy trình 3 lần thất bại thì báo lại người dùng.
Phù hợp với ai
- Người thường giao các việc dài cần 5+ lần gọi tool: khảo sát code, refactor, dựng dự án mới.
- Người từng gặp cảnh agent quên mục tiêu giữa chừng hoặc lặp lại đúng lỗi cũ.
- Người chạy nhiều task song song và cần ghim từng kế hoạch bằng
PLAN_IDhoặc worktree riêng.
Ví dụ sử dụng
- "Khảo sát toàn bộ luồng xác thực của repo này" → chạy
init-session.sh "auth-audit", sau mỗi 2 lần đọc file thì ghi kết luận vàofindings.md. - Trong một đợt migration dài, khi ngữ cảnh bị compact, hook PreCompact và việc đọc lại
task_plan.mdgiúp agent biết ngay đang ở pha nào. - Khi lỗi build lặp lại, agent theo giao thức 3 bước đổi cách tiếp cận và ghi lịch sử thử nghiệm vào bảng lỗi để không lặp lại.
· · · 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/.cursor/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 .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.
- 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/.cursor/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 chosession-catchup.py). - Nếu cài ở đường dẫn khác, khai báo:
export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files/scripts - Khởi động lại Claude Code, mở thư mục gốc dự án và yêu cầu "tạo file kế hoạch cho việc này" để kiểm tra
task_plan.mdxuất hiện trong dự án. - Thử liệt kê kế hoạch:
sh ~/.claude/skills/planning-with-files/scripts/set-active-plan.sh --list
Xem mã nguồn trên GitHub ↗Giấy phép: MIT