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

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

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

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

Làm được gì

  • Tạo và duy trì task_plan.md (các phase + 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.
  • Dùng hook vòng đời (UserPromptSubmit, PreToolUse, PostToolUse, PreCompact, Stop) để tự chèn nội dung kế hoạch vào ngữ cảnh, giúp khôi phục trạng thái sau khi bị nén ngữ cảnh hoặc đứt phiên.
  • Có script init-session.sh để khởi tạo và check-complete.sh --validate để kiểm tra định dạng marker **Status:** pending/in_progress/complete.
  • set-active-plan.sh --list liệt kê các kế hoạch đã lưu kèm tiến độ; chỉ lưu trữ (archive) khi người dùng đồng ý.
  • Kèm quy tắc thực chiến: ghi phát hiện sau mỗi 2 thao tác xem/tìm kiếm, giao thức lỗi 3 lần thử rồi báo người dùng, không lặp lại hành động đã thất bại.

Dành cho ai

  • Người thường giao các tác vụ cần từ 5 lệnh gọi công cụ trở lên: refactor lớn, nghiên cứu, dựng dự án mới.
  • Người hay bị mất ngữ cảnh khi phiên làm việc kéo dài và phải giải thích lại từ đầu.
  • Nhóm chạy nhiều tác vụ song song, cần tách kế hoạch bằng PLAN_ID hoặc worktree riêng.

Ví dụ sử dụng

  1. Bắt đầu refactor: chạy init-session.sh, viết Phase 1–5, cập nhật trạng thái sang complete sau mỗi phase.
  2. Nghiên cứu đối thủ: cứ sau 2 lần đọc web/PDF thì ghi ngay ý chính vào findings.md để không mất thông tin đa phương thức.
  3. Tiếp tục việc hôm qua: chạy session-catchup.py --metadata . để xem tổng hợp bản ghi phiên cùng dự án, rồi đọc lại 3 file kế hoạch để khôi phục trạng thái.

· · · 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/.codebuddy/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 .codebuddy/skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-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/planning-with-files && cp -r /tmp/pwf/.codebuddy/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à clone kho: git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/pwf
  2. Tạo thư mục skill: mkdir -p ~/.claude/skills/planning-with-files
  3. Sao chép nội dung: cp -r /tmp/pwf/.codebuddy/skills/planning-with-files/* ~/.claude/skills/planning-with-files/
  4. Cấp quyền chạy cho script: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
  5. Nếu hook báo không tìm thấy script, thêm vào ~/.zshrc hoặc ~/.bashrc: export PWF_SCRIPT_DIR="$HOME/.claude/skills/planning-with-files/scripts" rồi mở lại terminal.
  6. Kiểm tra Python bằng python3 --version (cần cho session-catchup.py).
  7. Khởi động lại Claude Code, vào thư mục gốc dự án và yêu cầu "hãy lập kế hoạch trước" để xem task_plan.md có được tạo không.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT