Lập kế hoạch bằng file (Planning with Files)
Giữ task_plan.md, findings.md và progress.md trên đĩa để 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ì
- Tạo và cập nhật
task_plan.md(các pha, quyết định),findings.md(kết quả nghiên cứu),progress.md(log phiên) ngay trong thư mục dự án của bạn. - Dùng hook vòng đời (UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact) để tự chèn nội dung kế hoạch vào ngữ cảnh, giúp phục hồi trạng thái sau khi nén ngữ cảnh hoặc ngắt phiên.
- Áp các quy tắc cứng: ghi kết quả sau mỗi 2 lần xem/tìm kiếm, đọc lại kế hoạch trước khi ra quyết định, log mọi lỗi, và leo thang cho người dùng sau 3 lần thất bại.
- Kèm script hỗ trợ:
init-session.sh,check-complete.sh,set-active-plan.sh --list,session-catchup.py --metadata/--replay.
Phù hợp với ai
- Người thường chạy các tác vụ nghiên cứu, refactor, xây dựng cần 5+ lần gọi tool.
- Lập trình viên gặp tình trạng AI "quên" mục tiêu ban đầu vì giới hạn ngữ cảnh.
- Nhóm chia việc theo nhiều phiên hoặc nhiều worker (một orchestrator + nhiều worktree).
Ví dụ sử dụng
- Migrate codebase lớn: lập kế hoạch theo pha, đánh dấu
in_progress → completesau mỗi pha, ghi bảng lỗi để không lặp lại. - Nghiên cứu đối thủ: sau mỗi 2 lần tra web, lưu ngay ý chính vào
findings.mdđể không mất thông tin từ ảnh/PDF. - Quay lại việc sau vài ngày: chạy
set-active-plan.sh --list, ghimPLAN_ID, đọc ba file kế hoạch và tiếp tục đú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/.codex/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 .codex/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-2/ 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/.codex/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.
- Clone repo vào thư mục tạm:
git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy skill:
cp -r /tmp/pwf/.codex/skills/planning-with-files ~/.claude/skills/ - (Nếu dùng Codex, copy thêm vào
~/.codex/skills/.) - Cấp quyền chạy cho script:
chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh - Kiểm tra Python:
python3 --version(cần chosession-catchup.py). - Nếu cài ở đường dẫn không chuẩn, thêm
export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files/scriptsvào file cấu hình shell. - Khởi động lại Claude Code, vào thư mục gốc dự án và yêu cầu "quản lý việc này bằng file kế hoạch" để kiểm tra.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT