Claude Skill MartKhám phá skillSkill 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 để công việc của AI không bị mất khi ngữ cảnh bị nén hoặc /clear.

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

Làm được gì

Kỹ năng này buộc Claude Code dùng ba tệp markdown trong thư mục dự án như "bộ nhớ làm việc trên đĩa":

  • task_plan.md — các Phase, trạng thái, bước tiếp theo, quyết định đã chốt
  • findings.md — kết quả nghiên cứu, phát hiện (ghi ngay sau mỗi 2 lần tra cứu)
  • progress.md — nhật ký phiên, kết quả test, lỗi gặp phải

Các hook (UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact) tự động chèn lại nội dung kế hoạch vào ngữ cảnh, nên sau khi /compact hay /clear agent vẫn biết đang ở đâu. Script session-catchup.py phục hồi ngữ cảnh phiên trước, kết hợp git diff để cập nhật lại kế hoạch.

Ngoài ra có giao thức xử lý lỗi 3 lần thử, thư mục kế hoạch riêng .planning/<ngày-slug>/ cho nhiều tác vụ song song, cơ chế xác thực hash (attestation) chống chỉnh sửa kế hoạch, và các chế độ autonomous/gated cho vòng chạy dài.

Phù hợp với ai

  • Lập trình viên làm việc dài hạn: refactor lớn, migration, dựng dự án mới
  • Người thường xuyên bị AI "quên mục tiêu" mỗi khi ngữ cảnh đầy
  • Người làm nghiên cứu, cần lưu lại phát hiện thành tài liệu
  • Nhóm chạy nhiều tác vụ song song trong cùng một repo

Ví dụ sử dụng

  1. Migration API: yêu cầu "chuyển dự án sang API v2" → sinh task_plan.md chia thành Phase 1–6, mỗi phase xong được đánh dấu complete; hôm sau mở phiên mới, hook đọc lại kế hoạch và tiếp tục.
  2. Nghiên cứu công nghệ: so sánh 3 thư viện, sau mỗi 2 lần đọc tài liệu ghi ngay kết luận vào findings.md nên không mất dữ liệu khi ngữ cảnh tràn.
  3. Chạy song song: ./scripts/init-session.sh "Backend Refactor" và ./scripts/init-session.sh "Incident Investigation" tạo hai kế hoạch riêng; dùng set-active-plan.sh để đổi kế hoạch đang hoạt động.

· · · Hướng dẫn cài đặt · · ·

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 skills/planning-with-files từ repo GitHub OthmanAdi/planning-with-files vào ~/.claude/skills/othmanadi-planning-with-files-11/ 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/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à chuyển đến thư mục bạn muốn tải mã nguồn.
  2. Tải repo: git clone https://github.com/OthmanAdi/planning-with-files.git
  3. Sao chép kỹ năng: mkdir -p ~/.claude/skills && cp -r planning-with-files/skills/planning-with-files ~/.claude/skills/
  4. Nếu muốn có cả lệnh /plan-goal và /plan-loop, hãy cài theo đường plugin trong Claude Code: /plugin marketplace add OthmanAdi/planning-with-files rồi /plugin install planning-with-files.
  5. Cấp quyền chạy cho script: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
  6. Khởi động lại Claude Code, rồi thử: "Hãy lập kế hoạch từng bước cho tác vụ này".
  7. Kiểm tra cài đặt bằng /plan-doctor hoặc sh ~/.claude/skills/planning-with-files/scripts/plan-doctor.sh.
  8. Lưu ý: các tệp kế hoạch được tạo trong thư mục dự án của bạn, không phải trong thư mục cài kỹ năng.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT