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

Dùng ba tệp task_plan.md, findings.md và progress.md làm 'bộ nhớ làm việc trên đĩa' để agent không mất ngữ cảnh trong các tác vụ nhiều bước.

Tự động hóaTrung cấp★ 27,398⑂ 2,270Điểm AI 10/10Cập nhật lần cuối: 10 thg 10, 2026

Làm được gì

Buộc tạo task_plan.md trước khi bắt đầu tác vụ phức tạp; kết quả nghiên cứu ghi vào findings.md, log phiên và kết quả test ghi vào progress.md.
Khi phiên bị ngắt hoặc ngữ cảnh bị nén (compact), skill đọc lại các tệp kế hoạch trong project để phục hồi giai đoạn, mục tiêu và phát hiện đã có.
Tự động chèn ngữ cảnh kế hoạch qua các hook UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact.
Kèm script hỗ trợ: init-session.sh (khởi tạo), check-complete.sh (kiểm tra hoàn tất), set-active-plan.sh --list (liệt kê kế hoạch), session-catchup.py --metadata/--replay.
Quy định rõ: giao thức lỗi 3 lần thử, quy tắc "sau 2 lần xem/tìm kiếm phải ghi ngay", và ranh giới bảo mật (nội dung web chỉ ghi vào findings.md).

Phù hợp với ai

Người thường giao các tác vụ dài cần từ 5 lần gọi tool trở lên: nghiên cứu, refactor lớn, dựng project mới.
Người gặp tình trạng agent quên mục tiêu hoặc lặp lại cùng một lỗi khi phiên kéo dài.
Người chạy nhiều tác vụ song song và muốn tách kế hoạch bằng PLAN_ID hoặc worktree riêng.

Ví dụ sử dụng

Refactor lớn: chạy init-session.sh "Refactor Auth", rồi cập nhật trạng thái từng giai đoạn trong task_plan.md từ in_progress sang complete.
Nghiên cứu kỹ thuật: sau mỗi 2 lần tìm kiếm web, lưu ngay các điểm chính vào findings.md để không mất dữ liệu trình duyệt/hình ảnh.
Tiếp tục việc dở: hôm sau dùng set-active-plan.sh --list để tìm kế hoạch, đọc 3 tệp kế hoạch cùng git diff --stat rồi làm tiếp đúng chỗ đã dừng.

· · · 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.

↓ Tải ZIP

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 AI 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/planning-with-files && mkdir -p ~/.claude/skills && cp -r /tmp/planning-with-files/.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
Sao chép thư mục skill vào thư mục skill của Claude: mkdir -p ~/.claude/skills && cp -r planning-with-files/.factory/skills/planning-with-files ~/.claude/skills/
Cấp quyền thực thi cho script: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
Kiểm tra Python: python3 --version (cần cho session-catchup.py).
Nếu cài ở đường dẫn không chuẩn, đặt biến môi trường PWF_SCRIPT_DIR trỏ tới thư mục scripts của skill.
Khởi động lại Claude Code, đứng ở thư mục gốc project và yêu cầu "lập kế hoạch bằng planning-with-files" để kiểm tra thư mục .planning/ được tạo.
Vì các hook chạy script shell ở mỗi prompt/tool call, nên đọc qua scripts/skill-hook.sh trước khi bật.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT