Lập kế hoạch bằng file (Planning with Files)
Biến ba file task_plan.md, findings.md, progress.md thành 'bộ nhớ làm việc trên ổ đĩa' để AI agent không mất ngữ cảnh trong các tác vụ nhiều bước.
Giúp được gì
Triết lý: cửa sổ ngữ cảnh là RAM (dễ bay), hệ thống file là ổ đĩa (bền vững). Skill buộc agent tạo ba file kế hoạch trước khi bắt tay làm việc và cập nhật sau mỗi giai đoạn.
- task_plan.md — các Phase kèm trạng thái
pending/in_progress/completevà quyết định đã chốt - findings.md — nơi lưu kết quả tra cứu, tài liệu, nội dung ảnh/PDF
- progress.md — nhật ký phiên làm việc, kết quả test
Ngoài ra còn có script khởi tạo (init-session.sh), kiểm tra định dạng (check-complete.sh --validate), chạy nhiều kế hoạch song song qua PLAN_ID và set-active-plan.sh, cùng cơ chế khóa nội dung kế hoạch bằng hash SHA-256 (attest-plan.sh). Các quy tắc vận hành rõ ràng: ghi lại sau mỗi 2 thao tác tra cứu, không lặp lại hành động đã thất bại, thất bại 3 lần thì hỏi người dùng.
Phù hợp với ai
- Người thường giao các việc dài cần từ 5 lệnh gọi công cụ trở lên: refactor, nghiên cứu, migration
- Người từng bực mình vì agent quên mục tiêu khi hội thoại kéo dài
- Người chạy nhiều terminal song song và muốn tách biệt kế hoạch từng tác vụ
- Người quan tâm tới rủi ro prompt injection từ nội dung web đưa vào ngữ cảnh
Ví dụ sử dụng
- Refactor lớn: chạy
init-session.sh "Backend Refactor", định nghĩa Phase 1–6, agent cập nhật trạng thái sau từng giai đoạn thay vì làm loạn xạ. - Nghiên cứu kỹ thuật: đọc hơn 10 tài liệu, cứ 2 lần tra cứu lại ghi ý chính vào
findings.md, nên khi viết kết luận vẫn còn đủ dẫn chứng. - Tiếp tục sau khi nghỉ: hôm sau mở lại, agent đọc ba file cộng
git diff --statvà khôi phục đúng trạng thái "đang ở Phase 3, 2 test còn fail".
· · · 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/.continue/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 AI Skill Mart. Copy thư mục .continue/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-3/ 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/.continue/skills/planning-with-files ~/.claude/skills/planning-with-files⚠ Đâ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à chuyển tới thư mục làm việc.
- Tải mã nguồn:
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r /tmp/pwf/.continue/skills/planning-with-files ~/.claude/skills/planning-with-files - Cấp quyền chạy cho script:
chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh - (Nên làm) Mở xem
scripts/session-catchup.pyđể chắc chắn bạn chấp nhận việc nó đọc bản ghi phiên cục bộ. - Khởi động lại Claude Code, rồi ở thư mục gốc dự án yêu cầu kiểu "hãy quản lý việc này bằng file kế hoạch".
- Lưu ý: các file kế hoạch sẽ nằm ở thư mục gốc dự án, không phải trong thư mục cài skill.