Vì sao cần skill này
Khi nhờ AI (Claude Code, Cursor…) làm một tính năng nhiều bước, cám dỗ lớn nhất là để nó lao vào code ngay. Kết quả quen thuộc: AI đi sai hướng ở bước 2, nhưng bạn chỉ phát hiện ở bước 8 — khi đã có một đống code phải bỏ hoặc sửa. Chi phí đổi hướng lúc đó đắt hơn nhiều so với lúc chưa viết gì.
Writing Plans giải quyết đúng chỗ đó: bắt AI dừng lại lập một kế hoạch triển khai chi tiết trước khi chạm vào code, chi tiết tới mức một kỹ sư chưa biết gì về dự án của bạn vẫn làm theo được từng bước mà không phải đoán. Và gói này đi kèm phần thứ hai: một mẫu để AI tự rà soát bản kế hoạch trước khi bắt tay — bắt lỗi ngay từ trên giấy, nơi sửa còn rẻ.
Gói này gồm hai phần — ghép thành một quy trình
Phần 1 — writing-plans (viết kế hoạch): biến một bản đặc tả (spec/yêu cầu) thành kế hoạch triển khai theo từng task nhỏ.
Phần 2 — plan-document-reviewer-prompt (rà kế hoạch): một mẫu prompt để cử một "AI reviewer" kiểm tra bản kế hoạch đó trước khi thực thi.
Quy trình đầy đủ: viết kế hoạch → AI rà kế hoạch → mới bắt đầu code.
Skill làm được gì
1. Chia việc lớn thành các task nhỏ, kiểm thử được độc lập. Mỗi task ghi rõ: file nào cần tạo/sửa (đường dẫn chính xác), nhận gì từ task trước và sinh ra gì cho task sau (tên hàm, kiểu dữ liệu cụ thể). Nhờ vậy có thể giao từng task cho một phiên AI riêng mà không bị lẫn.
2. Mỗi bước là một hành động 2–5 phút, theo nhịp TDD. Trình tự chuẩn cho mỗi task: viết test (cho fail trước) → viết code tối thiểu để pass → chạy test → commit. Cách này giữ cho AI đi từng bước nhỏ, kiểm chứng được, thay vì "code một mạch".
3. Cấm mô tả mơ hồ tuyệt đối. Skill coi các cụm như "TODO", "xử lý lỗi cho phù hợp", "viết test cho phần trên" (mà không có code thật) là lỗi kế hoạch — không được phép. Mỗi bước phải chứa nội dung thật, đủ để làm ngay.
4. Tự rà lại kế hoạch (self-review). Sau khi viết xong, đối chiếu kế hoạch với spec (đã phủ hết yêu cầu chưa), quét placeholder còn sót, và kiểm tính nhất quán tên hàm/kiểu dữ liệu giữa các task (một hàm gọi là clearLayers() ở task 3 nhưng clearFullLayers() ở task 7 là một lỗi).
5. Mẫu "AI reviewer" có hiệu chỉnh thông minh. Phần rà kế hoạch chỉ báo lỗi thật sự gây kẹt khi triển khai (thiếu yêu cầu, bước mâu thuẫn, task quá mơ hồ để làm) — bỏ qua góp ý câu chữ, sở thích, "nên có". Nhờ vậy reviewer không bắt bẻ vụn vặt, chỉ chặn khi có lỗ hổng nghiêm trọng.
Giải quyết vấn đề gì — cho ai ở VNPAY
Giá trị trực tiếp — cho Khối Công nghệ (nhất là đội dùng AI để code). Nếu đội phát triển đang dùng Claude Code/Cursor, đây là cách bắt AI lập kế hoạch kỹ và được rà soát trước khi sinh code — giảm hẳn rủi ro AI đi sai hướng hay sinh code ẩu. Kỷ luật cấm placeholder, TDD, commit nhỏ, rà kế hoạch trước khi làm rất hợp môi trường tài chính cần chất lượng và kiểm soát chặt. Đây là "người anh em" của các skill Root Cause Tracing và Performance Optimization — cùng bộ kỹ năng làm việc kỷ luật trên codebase.
Giá trị gián tiếp — cho PM & P&T. Anh/chị không viết code, nhưng bản chất của skill này chính là nghề chia nhỏ công việc (task breakdown) — áp thẳng được cho quản trị dự án:
- Chia một hạng mục lớn thành các task có "đầu ra kiểm được" độc lập — đúng nguyên tắc lập kế hoạch dự án.
- Cấm mô tả mơ hồ: mỗi đầu việc phải rõ ai làm, làm gì, xong là thế nào — tinh thần "không placeholder".
- Rà kế hoạch trước khi chạy, với bộ tiêu chí chỉ soi cái gây kẹt thật sự — một checklist rà kế hoạch dự án rất thực dụng, tránh sa đà vào tiểu tiết.
Đặt kỳ vọng đúng
- Đây là skill kỹ thuật, hợp nhất khi chạy trong Claude Code (làm việc trực tiếp trong codebase). Không phải dạng tải file vào chat rồi hỏi.
- Thuộc bộ "Superpowers".
writing-planstham chiếu các skill cùng bộ để thực thi kế hoạch (giao từng task cho subagent, chạy theo checkpoint). Dùng lẻ để lập và rà kế hoạch vẫn tốt; muốn chạy trọn vòng "lập → rà → thực thi" thì nên có cả bộ. - Ví dụ và công cụ nhắm tới hệ có test tự động + git (Python/pytest trong mẫu). Stack khác thì tư duy vẫn đúng, phần code mẫu cần chuyển đổi.
Điều kiện để dùng
- Hợp nhất với Claude Code; cần gói Claude hỗ trợ Skills và code/agent (Pro, Max, Team hoặc Enterprise).
- Codebase nên có quy trình test tự động và dùng git để phát huy nhịp TDD + commit nhỏ.
Hướng dẫn upload skill lên Claude Desktop
Sau khi tải file skill về, làm theo 3 bước:
Bước 1 — Mở Customize. Trong giao diện Claude Desktop, bấm "Customize" ở góc trên bên trái.
Bước 2 — Mở menu Add. Trong màn hình Customize, bấm vào dropdown của phần "Add" ở góc trên bên phải.
Bước 3 — Upload skill. Chọn "Upload skill", rồi trỏ tới file skill của bạn.
Lưu ý về định dạng file: skill cần ở dạng thư mục chứaSKILL.md(ở đây kèm cả file mẫu prompt rà kế hoạch). Nếu tải về từ site nội bộ dưới dạng.zip, cứ upload file.zipđó — bên trong đã là đúng cấu trúc skill.
Upload xong, skill nằm sẵn trong danh sách kỹ năng và Claude tự biết khi nào cần gọi.
Các cách gọi skill lên
1. Để Claude tự nhận diện (khuyên dùng). Khi bạn có một spec/yêu cầu cho việc nhiều bước và muốn triển khai, Claude sẽ tự dùng skill để lập kế hoạch trước:
"Đây là spec tính năng [X]. Lập kế hoạch triển khai chi tiết trước khi code."
2. Gọi đích danh:
"Dùng skill writing-plans để lập kế hoạch cho phần này."
3. Yêu cầu rà kế hoạch trước khi thực thi:
"Rà lại bản kế hoạch này xem đã đủ và đủ rõ để bắt tay code chưa — chỉ nêu chỗ có thể khiến người làm bị kẹt."
4. Chia nhỏ khi phạm vi lớn:
"Spec này gồm nhiều phần độc lập — hãy tách thành các kế hoạch riêng, mỗi phần ra được phần mềm chạy và kiểm thử được độc lập."
Gợi ý dùng hiệu quả: hãy để AI lập và rà kế hoạch xong, bạn duyệt, rồi mới cho thực thi. Chính bước duyệt kế hoạch trên giấy là nơi bắt lỗi rẻ nhất.
Lưu ý bảo mật cho môi trường VNPAY
- Khi đưa spec, mã nguồn, hay mô tả hệ thống nội bộ cho Claude để lập kế hoạch, kiểm tra quy định dùng công cụ AI và chính sách mã nguồn của VNPAY trước.
- Tránh để lẫn thông tin nhạy cảm (khoá/credential, endpoint nội bộ, dữ liệu khách hàng thật) trong spec/kế hoạch gửi đi.
- Kế hoạch do AI lập vẫn cần người có chuyên môn duyệt trước khi thực thi — nhất là với hệ thống liên quan giao dịch/tài chính.
(Đây là khuyến nghị chung; team cần đối chiếu với chính sách bảo mật nội bộ hiện hành của VNPAY.)
Tóm lại
Writing Plans đóng gói một thói quen của những đội phát triển kỷ luật: nghĩ kỹ và viết kế hoạch rõ ràng trước khi code, rồi rà kế hoạch trước khi bắt tay. Với đội kỹ thuật dùng AI, đây là cách giữ cho AI đi đúng hướng, đi từng bước kiểm chứng được, thay vì sinh một đống code sai phải bỏ. Với PM và P&T, tinh thần "chia việc thành các đầu ra kiểm được, không mô tả mơ hồ, và rà kế hoạch trước khi chạy" là một tư duy quản trị đáng mang theo — dù để dùng skill này đúng nghĩa, bạn cần đang làm việc với code.
Tài liệu tham khảo
- Anthropic Agent Skills — Claude Platform Docs. Available at: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview (Accessed: 05/08/2026).
- Skill nguồn:
writing-plans+plan-document-reviewer-prompt, thuộc bộ Superpowers (Jesse Vincent), tải từ GitHub.