Lập kế hoạch bằng tệp (Planning with Files)
Ghi task_plan.md, findings.md và progress.md ra đĩa để công việc nhiều bước không bị mất khi hết ngữ cảnh hay chạy /clear.
Skill này làm gì
Áp dụng mô hình "bộ nhớ làm việc trên đĩa" kiểu Manus cho Claude Code. Trước khi bắt đầu một tác vụ phức tạp, agent tạo ba tệp markdown trong thư mục dự án và cập nhật liên tục:
task_plan.md— danh sách các phase, trạng thái và quyết định quan trọngfindings.md— lưu kết quả nghiên cứu, phát hiện (ưu tiên thông tin dễ bay mất như ảnh, kết quả duyệt web)progress.md— nhật ký phiên làm việc, kết quả test, tệp đã sửa
Skill còn cài các hook tự động: chèn lại kế hoạch khi bạn gửi prompt, trước khi gọi công cụ, trước khi nén ngữ cảnh (PreCompact) và nhắc cập nhật tiến độ sau mỗi lần Write/Edit. Sau /clear, script session-catchup.py giúp khôi phục trạng thái phiên trước.
Tài liệu còn có "giao thức 3 lần thất bại" (thử 3 cách rồi hỏi người dùng), ma trận quyết định đọc/ghi và bảng các anti-pattern.
Phù hợp với ai
- Người thường làm các tác vụ dài như refactor lớn, migration, cần hàng chục lượt gọi công cụ
- Người từng bực bội vì agent quên mục tiêu sau khi ngữ cảnh đầy hoặc sau
/clear - Người muốn lưu lại quá trình nghiên cứu và các lần thử sai để chia sẻ với đội
Ví dụ sử dụng
- Chuyển module cũ sang TypeScript: yêu cầu lập kế hoạch, agent tạo
task_plan.mdtheo từng phase và đánh dấucompletesau mỗi tệp được chuyển. - Nghiên cứu công nghệ: khi so sánh nhiều thư viện, cứ sau 2 lần tìm kiếm agent ghi ý chính vào
findings.md, nên bảng so sánh vẫn còn dù ngữ cảnh bị cắt. - Tiếp tục việc dang dở: hôm sau chạy script catchup cộng
git diff --statđể biết đã làm tới đâu rồi tiếp tục.
· · · Hướng dẫn cài đặt · · ·
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 .opencode/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-10/ 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/.opencode/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à tải kho mã:
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r /tmp/planning-with-files/.opencode/skills/planning-with-files ~/.claude/skills/ - Cấp quyền chạy cho script:
chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh - (Tùy chọn) Nếu cài ở đường dẫn khác, thêm vào file cấu hình shell:
export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files/scripts - Khởi động lại Claude Code và thử câu lệnh "hãy lập kế hoạch cho việc này". Nếu thấy
task_plan.mdxuất hiện trong thư mục dự án là thành công. - Vì các hook tự chạy script shell, hãy mở xem nội dung trong thư mục
scripts/trước khi tin dùng.