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 để tác nhân 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 "cửa sổ ngữ cảnh = RAM, hệ tệp = ổ đĩa": mọi thứ quan trọng đều được ghi ra tệp.
- Tạo và cập nhật ba tệp:
task_plan.md(giai đoạn, quyết định),findings.md(kết quả nghiên cứu),progress.md(nhật ký phiên). - Các hook vòng đời (UserPromptSubmit, PreToolUse, Stop, PreCompact) tự chèn lại kế hoạch đã chọn vào ngữ cảnh mỗi lượt.
- Quy tắc cụ thể: ghi lại sau mỗi 2 thao tác xem/tìm kiếm, giao thức lỗi 3 lần, bảng nhật ký lỗi, không lặp lại hành động thất bại.
- Hỗ trợ nhiều kế hoạch song song qua
.planning/<id>/và biếnPLAN_ID, cùng tùy chọn xác thực SHA-256 và cổng hoàn tất (chế độ gated).
Phù hợp với ai
- Người thường giao các tác vụ nghiên cứu, tái cấu trúc hoặc xây dựng cần trên 5 lượt gọi công cụ.
- Ai từng mất ngữ cảnh sau khi phiên bị nén (compact) hoặc bị ngắt giữa chừng.
- Lập trình viên chạy nhiều phiên tác nhân song song trong cùng một kho mã.
Ví dụ sử dụng
- Trước một đợt tái cấu trúc lớn, chạy
scripts/init-session.sh "Backend Refactor"rồi cập nhật trạng thái từng giai đoạn thànhcomplete. - Khi nghiên cứu web/PDF, cứ sau 2 lần xem thì lưu ngay phát hiện vào
findings.mdđể không mất thông tin hình ảnh. - Mở hai terminal, ghim
PLAN_IDkhác nhau cho "điều tra sự cố" và "phát triển tính năng" trong cùng kho mà không xung đột.
· · · 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/.agents/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 .agents/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/planning-with-files/ 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/.agents/skills/planning-with-files ~/.claude/skills/ && rm -rf /tmp/pwf⚠ Đâ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à tải kho mã:
git clone https://github.com/OthmanAdi/planning-with-files.git - Sao chép thư mục kỹ năng:
mkdir -p ~/.claude/skills && cp -r planning-with-files/.agents/skills/planning-with-files ~/.claude/skills/ - Nếu muốn dùng thêm lệnh
/plan-goalvà/plan-loop, cài theo đường plugin trong Claude Code:/plugin marketplace add OthmanAdi/planning-with-filesrồi/plugin install. - Khởi động lại Claude Code, vào thư mục gốc dự án và chạy
sh ~/.claude/skills/planning-with-files/scripts/plan-doctor.shđể kiểm tra hook. - Khởi tạo kế hoạch đầu tiên:
sh ~/.claude/skills/planning-with-files/scripts/init-session.sh "Tên tác vụ", rồiexport PLAN_ID=<id in ra>nếu chạy song song. - Hãy dùng chế độ mặc định trước; chỉ bật
--autonomoushoặc--gatedkhi đã quen.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT