AI Skill MartKhám phá skillLệnhChương trìnhHọcSkill là gì?
 
← Về danh sách

Lập kế hoạch bằng tệp (Planning with Files)

Lưu ngữ cảnh làm việc của AI agent xuống đĩa qua ba tệp task_plan.md, findings.md và progress.md để tiếp tục các tác vụ dài mà không mất trạng thái.

Tự động hóaTrung cấp★ 27,953⑂ 2,313Điểm AI 10/10Cập nhật lần cuối: 7 thg 11, 2026

Giúp được gì

  • Trước khi bắt đầu tác vụ phức tạp, kỹ năng tạo task_plan.md(các giai đoạn & trạng thái), findings.md(kết quả nghiên cứu), progress.md(nhật ký phiên) ngay trong thư mục dự án như "bộ nhớ làm việc trên đĩa".
  • Mỗi giai đoạn theo định dạng ### Phase N: Tên kèm đúng một dòng **Status:** pending/in_progress/complete, và được kiểm tra bằng check-complete.sh --validate.
  • Các hook vòng đời (UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact) tự động nạp lại nội dung kế hoạch, nên trạng thái vẫn khôi phục được sau khi nén ngữ cảnh hoặc mất phiên.
  • Áp đặt quy tắc thực chiến: quy tắc 2 hành động (cứ 2 lần đọc/tìm kiếm là ghi ngay), giao thức lỗi 3 lần (chẩn đoán → cách khác → xem lại giả định → báo người dùng), bảng ghi lỗi.
  • set-active-plan.sh --list liệt kê các kế hoạch đã lưu và tiến độ; chỉ lưu trữ (archive) những kế hoạch người dùng đồng ý.

Phù hợp với ai

  • Người thường giao các tác vụ cần từ 5 lần gọi công cụ trở lên: nghiên cứu, refactor, xây tính năng mới.
  • Người gặp cảnh agent quên mục tiêu hoặc lặp lại cùng một lỗi khi hội thoại kéo dài.
  • Người làm việc qua nhiều phiên hoặc chạy song song nhiều tác vụ và cần tách kế hoạch riêng.

Ví dụ sử dụng

  1. Phát triển tính năng nhiều phiên: khởi tạo kế hoạch "refactor module thanh toán" với Phase 1–5; hôm sau mở phiên mới, hook tự khôi phục giai đoạn hiện tại và findings.
  2. Nghiên cứu đối thủ: cứ đọc 2 trang web là ghi số liệu chính vào findings.md, giữ lại thông tin đa phương thức trước khi nó biến mất khỏi ngữ cảnh.
  3. Truy vết lỗi khó: ghi mọi lần thử và thông báo lỗi vào bảng ## Errors Encountered, tránh lặp lại và sau 3 lần thất bại thì tổng hợp báo cho bạn.

· · · 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/.cursor/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)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
↓ Tải ZIP
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 .cursor/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-4/ 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/.cursor/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.

  1. Mở terminal và clone kho: git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf
  2. Sao chép thư mục kỹ năng vào đường dẫn kỹ năng người dùng của Claude Code: mkdir -p ~/.claude/skills && cp -r /tmp/pwf/.cursor/skills/planning-with-files ~/.claude/skills/
  3. Cấp quyền chạy cho script: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
  4. Kiểm tra Python bằng python3 --version (cần cho script khôi phục phiên).
  5. Nếu cài ở đường dẫn không chuẩn, thêm vào ~/.zshrc: export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files/scripts
  6. Khởi động lại Claude Code, đứng ở thư mục gốc dự án và yêu cầu "tạo kế hoạch cho tác vụ này" — các tệp kế hoạch sẽ xuất hiện trong .planning/.
  7. Trên Windows, dùng bản PowerShell: init-session.ps1, check-complete.ps1, set-active-plan.ps1.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT