Hệ thống lập kế hoạch bằng tệp (bản tiếng Trung phồn thể)
Quản lý các tác vụ nhiều bước bằng ba tệp task_plan.md, findings.md, progress.md và tự khôi phục ngữ cảnh sau khi phiên bị ngắt.
Kỹ năng 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 mọi tác vụ phức tạp, Claude tạo và liên tục cập nhật ba tệp Markdown:
task_plan.md— các giai đoạn, trạng thái tiến độ, quyết định quan trọngfindings.md— kết quả nghiên cứu, tìm kiếm, đọc tài liệuprogress.md— nhật ký phiên, kết quả kiểm thử, lỗi gặp phải
Các hook UserPromptSubmit / PreToolUse / PreCompact tự động chèn nội dung kế hoạch vào ngữ cảnh, còn session-catchup.py khôi phục trạng thái sau lệnh /clear. Tài liệu còn có "giao thức 3 lần thất bại", ma trận quyết định đọc/ghi, bài kiểm tra 5 câu hỏi khi khởi động lại, và quy tắc an toàn: chỉ ghi nội dung web vào findings.md để tránh prompt injection gián tiếp.
Phù hợp với ai
- Người thường xuyên làm refactor, nghiên cứu hoặc xây dựng dự án cần hơn 5 lượt gọi tool
- Người bực bội vì Claude quên mục tiêu sau khi ngữ cảnh bị nén
- Nhóm cần dấu vết thực thi lưu thành tệp thay vì chỉ dùng TodoWrite
- Người dùng quen giao diện tiếng Trung phồn thể (kho còn có bản tiếng Anh và các ngôn ngữ khác)
Ví dụ sử dụng
- Di chuyển module cũ: yêu cầu "lập kế hoạch chuyển module này sang TypeScript" — Claude tạo task_plan.md gồm 5 giai đoạn, đánh dấu
completesau mỗi giai đoạn và ghi lại các lỗi đã gặp. - Nghiên cứu đối thủ: cứ sau 2 lần tìm kiếm web, thông tin cốt lõi được lưu vào findings.md, tránh mất dữ liệu ảnh chụp màn hình; cuối cùng chỉ cần đọc findings.md là viết được báo cáo.
- Tiếp tục công việc dang dở: hôm sau mở lại, script catch-up so sánh
git diff --statvới tệp kế hoạch, báo phần chưa đồng bộ và tiếp tục đúng chỗ đang dừng.
· · · 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 skills/planning-with-files-zht từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/planning-with-files-zht/ 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/skills/planning-with-files-zht ~/.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:
git clone https://github.com/OthmanAdi/planning-with-files.git - Tạo thư mục kỹ năng nếu chưa có:
mkdir -p ~/.claude/skills - Sao chép bản phồn thể:
cp -r planning-with-files/skills/planning-with-files-zht ~/.claude/skills/ - Cấp quyền chạy cho script:
chmod +x ~/.claude/skills/planning-with-files-zht/scripts/*.sh - Mở xem qua các script trong
scripts/để hiểu chúng làm gì (hook sẽ chạy ở mỗi lần gọi tool). - Khởi động lại Claude Code, gõ
/skillshoặc yêu cầu "lập kế hoạch cho tác vụ này" để kiểm tra. - Nếu cài ở đường dẫn khác thường, đặt biến môi trường:
export PWF_SCRIPT_DIR=~/duong/dan/planning-with-files-zht/scripts - Chạy trong thư mục dự án — các tệp task_plan.md, findings.md, progress.md sẽ được tạo ở gốc dự án của bạn.