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)

Giữ task_plan.md, findings.md và progress.md trên ổ đĩa để AI không mất ngữ cảnh trong các tác vụ nhiều bước, kéo dài nhiều phiên.

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ì

Áp dụng mô hình "Manus": cửa sổ ngữ cảnh là RAM, hệ tệp là ổ cứng — cái gì quan trọng thì ghi ra đĩa.

  • Ba tệp kế hoạch: task_plan.md (các Phase và trạng thái), findings.md (kết quả nghiên cứu), progress.md (nhật ký phiên làm việc) đặt trong thư mục dự án của bạn.
  • Khôi phục phiên: đọc lại kế hoạch đang chọn trước khi làm tiếp, kèm session-catchup.py --metadata để lấy thống kê các phiên trước của cùng dự án.
  • Kiểm tra định dạng: init-session.sh khởi tạo, check-complete.sh --validate xác nhận cấu trúc ### Phase N + **Status:** còn nguyên vẹn.
  • Kỷ luật xử lý lỗi: mọi lỗi được ghi vào tệp kế hoạch; giao thức "3 lần thử" buộc đổi cách tiếp cận và báo cho người dùng sau 3 thất bại.
  • Hook vòng đời: tự chèn ngữ cảnh kế hoạch vào các mốc UserPromptSubmit, PreToolUse, PreCompact, Stop.

Dành cho ai

  • Người thường giao các việc nghiên cứu/triển khai cần từ 5 lượt gọi công cụ trở lên
  • Ai hay gặp cảnh AI quên mất quyết định ở các bước trước trong phiên dài
  • Người chạy nhiều tác vụ song song (nhiều worktree) và cần tách kế hoạch riêng cho từng tác vụ
  • Ai muốn ghi chép bền vững thay vì danh sách tạm kiểu TodoWrite

Ví dụ sử dụng

  1. Dự án refactor: chạy init-session.sh tạo kế hoạch 5 Phase, sau mỗi giai đoạn đổi trạng thái sang complete và ghi danh sách tệp đã sửa vào progress.md.
  2. Khảo sát kỹ thuật: theo "quy tắc 2 hành động", cứ đọc 2 tài liệu là lưu ngay ý chính vào findings.md, nên thông tin không mất khi ngữ cảnh bị nén.
  3. Tiếp tục sau khi nghỉ: hôm sau chạy set-active-plan.sh --list để xem các kế hoạch đã lưu cùng tiến độ, ghim đúng kế hoạch và làm tiếp từ 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)
  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 .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.

  1. Mở terminal và tải mã nguồn: git clone https://github.com/OthmanAdi/planning-with-files.git
  2. Tạo thư mục kỹ năng: mkdir -p ~/.claude/skills
  3. Sao chép kỹ năng: cp -r planning-with-files/.codex/skills/planning-with-files ~/.claude/skills/
  4. Nếu bạn dùng Codex, chạy thêm: mkdir -p ~/.codex/skills && cp -r planning-with-files/.codex/skills/planning-with-files ~/.codex/skills/ (các ví dụ trong SKILL.md dùng đường dẫn ~/.codex/...).
  5. Cấp quyền chạy cho script: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
  6. Nếu cài vào đường dẫn khác chuẩn, thêm export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files/scripts vào .bashrc/.zshrc.
  7. Khởi động lại Claude Code, rồi ở thư mục gốc dự án hãy yêu cầu: "quản lý việc này bằng tệp kế hoạch giúp tôi".
  8. Kiểm tra bằng cách chạy sh ~/.claude/skills/planning-with-files/scripts/init-session.sh tại thư mục dự án và xem thư mục .planning/ có được tạo không.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT