Claude Skill MartKhám phá skillCâu dùng ngayHọc qua videoDùng terminalSkill là gì?
 
← Về danh sách

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

Ghi kế hoạch, phát hiện và nhật ký tiến độ ra file markdown trên đĩa để công việc của agent sống sót qua /clear và mất ngữ cảnh.

Tự động hóaTrung cấp★ 26,415⑂ 2,209Điểm AI 10/10Cập nhật lần cuối: 29 thg 8, 2026

Làm được gì

Mang mô hình "bộ nhớ làm việc trên đĩa" kiểu Manus vào Claude Code. Trước mọi tác vụ phức tạp, skill bắt buộc tạo task_plan.md (các pha và trạng thái), findings.md (kết quả nghiên cứu) và progress.md (nhật ký phiên) ngay trong thư mục dự án, rồi cập nhật sau mỗi pha.

  • Tự động chèn ngữ cảnh: hook UserPromptSubmit, PreToolUse và PreCompact bơm lại phần đầu kế hoạch vào hội thoại để agent không trôi khỏi mục tiêu.
  • Khôi phục phiên: sau /clear, session-catchup.py dò ngữ cảnh chưa đồng bộ và kết hợp với git diff để dựng lại trạng thái.
  • Quy tắc 3 lần lỗi: không lặp lại đúng hành động thất bại, sau 3 lần thì báo lại cho người dùng.
  • Nhiều kế hoạch song song: mỗi tác vụ nằm trong .planning/<ngày-slug>/, ghim bằng PLAN_ID hoặc PWF_PLAN_ROOT.
  • Lớp bảo vệ: nội dung kế hoạch được bọc trong dấu phân cách BEGIN/END và coi là dữ liệu; chữ ký SHA-256 chặn việc chèn nội dung nếu file bị sửa ngoài luồng.

Phù hợp với ai

  • Người giao cho agent các việc dài hơi (refactor, migration) tốn hàng chục lần gọi tool
  • Ai từng gặp cảnh agent quên mục tiêu sau khi context bị nén
  • Người muốn lưu kết quả nghiên cứu ra file thay vì để trôi trong cửa sổ chat
  • Đội nhóm chạy nhiều luồng công việc song song trên cùng một repo

Ví dụ sử dụng

  1. Refactor lớn: chạy init-session.sh "Backend Refactor", chia thành 6 pha; dù bạn /clear giữa chừng, lượt sau kế hoạch vẫn được nạp lại và công việc tiếp tục.
  2. Nghiên cứu dài: áp dụng quy tắc 2 hành động — cứ sau 2 lần xem web/ảnh là ghi ngay vào findings.md, tránh mất thông tin đa phương thức.
  3. Chạy không giám sát: init-session.sh --gated "Build Pipeline" bật chế độ gated để agent không tự dừng khi còn pha dang dở, kèm giới hạn số lần chặn và phát hiện đình trệ.

· · · 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/.pi/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 Claude Skill Mart.
Copy thư mục .pi/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/pi-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/planning-with-files && mkdir -p ~/.claude/skills && cp -r /tmp/planning-with-files/.pi/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 repo: git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files
  2. Sao chép thư mục skill: mkdir -p ~/.claude/skills && cp -r /tmp/planning-with-files/.pi/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. Nếu muốn dùng cả lệnh /plan-goal và /plan-loop, hãy cài theo đường plugin: trong Claude Code gõ /plugin marketplace add OthmanAdi/planning-with-files rồi /plugin install.
  5. Khởi động lại Claude Code, thử yêu cầu "lập kế hoạch cho việc này" và kiểm tra xem task_plan.md có được tạo không.
  6. Nếu hook im lặng hoặc chạy sai, chạy tự kiểm tra: sh ~/.claude/skills/planning-with-files/scripts/plan-doctor.sh
  7. (Tùy chọn) Cần có python3 để dùng tính năng khôi phục phiên sau /clear.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT