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)

Biến task_plan.md, findings.md và progress.md thành "bộ nhớ làm việc trên đĩa" để agent không mất ngữ cảnh trong các tác vụ nhiều bước.

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

Làm được gì

  • Tạo ba tệp task_plan.md (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 dự án để lưu trạng thái bền vững.
  • Khôi phục công việc sau khi mất phiên hoặc sau nén ngữ cảnh bằng resolve-plan-dir.sh kết hợp git diff --stat.
  • Hook vòng đời (UserPromptSubmit / PreToolUse / PostToolUse / Stop / PreCompact) tự chèn lại tóm tắt kế hoạch mỗi lượt.
  • Bắt buộc định dạng ### Phase N với dòng **Status:** pending|in_progress|complete, kiểm tra bằng check-complete.sh.
  • Quy tắc vận hành: ghi mọi lỗi vào kế hoạch, giao thức 3 lần thử rồi báo người dùng, quy tắc 2 thao tác (cứ 2 lần xem/tìm thì ghi ngay phát hiện).
  • Hỗ trợ kế hoạch đặt tên cho tác vụ song song (.planning/<ngày>-<slug>/), ghim bằng PLAN_ID/PWF_PLAN_ROOT, chế độ autonomous/gated và niêm phong kế hoạch bằng SHA-256.

Phù hợp với ai

  • Người thường giao các tác vụ cần từ 5 lệnh công cụ trở lên: nghiên cứu, refactor, dựng dự án.
  • Ai từng bực vì agent quên mục tiêu hoặc lặp lại cùng một lỗi trong phiên dài.
  • Nhóm chạy nhiều agent song song trong cùng một repo và cần tách biệt công việc.
  • Người muốn điều kiện "hoàn thành" dựa trên tệp thật chứ không dựa vào hội thoại.

Ví dụ sử dụng

  1. Refactor lớn: init-session.sh "Backend Refactor" → export PLAN_ID=... → cập nhật Status từng giai đoạn; khi quay lại chỉ cần đọc tệp kế hoạch là tiếp tục được.
  2. Nghiên cứu kỹ thuật: cứ sau 2 lần đọc tài liệu/web thì ghi tóm tắt vào findings.md, nhờ đó dữ liệu không mất khi ngữ cảnh bị nén và dùng lại khi viết báo cáo.
  3. Chạy dài tự động: dùng /plan-loop 10m để kiểm tra định kỳ và /plan-goal đặt điều kiện dừng "mọi giai đoạn báo complete".

· · · 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/.agents/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 .agents/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/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/pwf && mkdir -p ~/.claude/skills && cp -r /tmp/pwf/.agents/skills/planning-with-files ~/.claude/skills/planning-with-files

⚠ Đâ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à tải repo: git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf
  2. Trước khi cài, xem qua thư mục script: ls /tmp/pwf/.agents/skills/planning-with-files/scripts và đọc nội dung skill-hook.sh (hook chạy mỗi lượt nên nên kiểm tra).
  3. Sao chép skill: mkdir -p ~/.claude/skills && cp -r /tmp/pwf/.agents/skills/planning-with-files ~/.claude/skills/planning-with-files
  4. Nếu muốn có các lệnh /plan-goal, /plan-loop, /plan-doctor, hãy cài theo đường plugin trong Claude Code: /plugin marketplace add OthmanAdi/planning-with-files rồi /plugin install.
  5. Khởi động lại Claude Code, vào thư mục gốc dự án và chạy sh ~/.claude/skills/planning-with-files/scripts/init-session.sh để tạo tệp kế hoạch.
  6. Nếu hook có vẻ không hoạt động, chạy sh ~/.claude/skills/planning-with-files/scripts/plan-doctor.sh để tự chẩn đoán.
  7. Khi chạy nhiều tác vụ song song, đặt export PLAN_ID=<ID do script in ra> ở từng terminal trước khi khởi động agent.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT