Claude Task Master là gì: chia PRD thành việc cho AI lập trình

Thử hình dung thế này. Anh trưởng nhóm viết một bản mô tả dài cho trang đặt phòng họp nội bộ, dán cả vào Cursor rồi bảo agent "làm đi". Agent hăng hái dựng giao diện đẹp lung linh, nhưng quên luôn phần lưu dữ liệu. Nhắc lại thì nó sửa phần dữ liệu, rồi quên mất giao diện vừa làm hôm qua.

Agent lập trình giỏi làm từng việc nhỏ, nhưng ôm cả dự án trong đầu thì rơi rớt. Claude Task Master là gì? Claude Task Master là công cụ quản lý công việc mã nguồn mở của Eyal Toledano, dùng Claude đọc tài liệu yêu cầu sản phẩm (PRD) rồi chia thành danh sách việc có thứ tự, phụ thuộc và cách kiểm tra, để agent trong Cursor làm lần lượt. Gói npm claude-task-master lên bản đầu ngày 04/03/2025, giấy phép MIT.

Đọc nhanh trong 30 giây

• Claude Task Master là công cụ mã nguồn mở (MIT) của Eyal Toledano, bản đầu ngày 04/03/2025.
• Nó biến PRD thành file tasks.json: mỗi việc có trạng thái, phụ thuộc, mức ưu tiên, cách kiểm tra.
• Cài bằng npm install claude-task-master rồi npx claude-task-init, cần khóa Anthropic API.
• Hợp với người dùng Cursor ở chế độ Agent cho dự án nhiều tuần, biết viết PRD.

Claude Task Master là gì, giải quyết chuyện gì?

Claude Task Master biến một bản mô tả sản phẩm dài thành bảng việc mà cả người và AI đều theo được. Agent không còn phải nhớ cả dự án, chỉ cần hỏi "việc tiếp theo là gì" và làm đúng việc đó.

Ví von cho dễ hình dung: chủ nhà đưa bản vẽ, nhưng thợ không thể làm mái, móng và điện cùng một lúc. Người quản lý công trình chia ra hạng mục, ghi rõ hạng mục nào phải xong trước. Task Master là người quản lý công trình đó, còn agent trong Cursor là đội thợ.

Hoặc gần gũi hơn: một căn bếp nhà hàng giờ cao điểm. Đầu bếp giỏi mấy mà không có phiếu order thì cũng nấu lộn món. tasks.json chính là xấp phiếu order kẹp trên cửa bếp: món nào trước, bàn nào đang chờ, món nào đã ra.

Mỗi việc là một phiếu order đầy đủ: làm gì, sau việc nào, kiểm tra ra sao.

Mỗi việc trong tasks.json có các trường theo README:

Cài Claude Task Master từng bước

Yêu cầu theo README lúc này: Node.js 14.0.0 trở lên, khóa Anthropic API, Anthropic SDK bản 0.39.0 trở lên. OpenAI SDK là tùy chọn, dùng khi muốn gọi Perplexity để nghiên cứu.

1. Cài gói vào dự án:

npm install claude-task-master

2. Khởi tạo dự án, trả lời vài câu hỏi về tên và thông tin dự án:

npx claude-task-init

Nếu lệnh không phản hồi, README hướng dẫn chạy trực tiếp:

node node_modules/claude-task-master/scripts/init.js

3. Tạo file .env ở gốc dự án, điền ANTHROPIC_API_KEY. Các biến tùy chọn gồm MODEL (mặc định claude-3-7-sonnet-20250219), MAX_TOKENS (mặc định 4000), PERPLEXITY_API_KEY nếu muốn chia việc có nghiên cứu, DEFAULT_SUBTASKS (mặc định 3).
4. File package.json của dự án cần có "type": "module", vì gói dùng ES module.
5. Mở dự án trong Cursor. File .cursor/rules/dev_workflow.mdc được Cursor tự nạp, giúp agent biết cách dùng hệ thống quản lý việc.
6. Đặt PRD vào thư mục scripts/, ví dụ scripts/prd.txt, rồi chuyển khung chat Cursor sang chế độ Agent.

Mẹo

README khuyên PRD càng chi tiết thì bảng việc càng tốt. Trước khi cho Task Master chia việc, dành thời gian viết rõ: ai dùng, có những màn hình nào, dữ liệu lưu ở đâu. Phiếu order viết ẩu thì bếp nấu ẩu.

Model mặc định là Claude 3.7 Sonnet, cùng đợt Anthropic ra mắt Claude Code bản thử nghiệm. Anh chị muốn tìm hiểu agent lập trình của chính Anthropic có thể đọc bài Claude Code là gì: agent lập trình trong terminal.

Một ngày làm việc với Task Master trông ra sao?

Mỗi ngày làm việc là một vòng: hỏi việc tiếp theo, làm, đánh dấu xong, hỏi tiếp.

Từ một bản PRD tới vòng lặp "việc tiếp theo là gì".

Bước 1: từ PRD ra bảng việc. Quay lại anh trưởng nhóm với trang đặt phòng họp. Lần này anh gõ trong Cursor:

Please use the dev.js script to parse my PRD and generate tasks. The PRD is located at scripts/prd.txt.

Agent sẽ chạy node scripts/dev.js parse-prd --input=scripts/prd.txt để tạo tasks.json, rồi node scripts/dev.js generate để tách thành từng file task_001.txt, task_002.txt trong thư mục tasks/.

Bước 2: mỗi buổi chỉ hỏi một câu.

What tasks are available to work on next?

Agent xem danh sách, kiểm tra việc nào đã đủ điều kiện vì các việc phụ thuộc đã xong, rồi đề xuất việc tiếp theo theo mức ưu tiên.

Bước 3: đổi hướng giữa chừng. Làm tới việc 4 thì nhóm quyết đổi từ Fastify sang Express. Thay vì sửa tay từng việc còn lại, anh bảo agent cập nhật.

Năm lệnh đủ dùng cho cả vòng đời dự án.

node scripts/dev.js update --from=4 --prompt="Now we are using Express instead of Fastify."

Các việc từ số 4 trở đi được viết lại, việc đã xong giữ nguyên. Gặp việc quá lớn thì chia nhỏ:

node scripts/dev.js expand --id=5 --subtasks=3

Thêm cờ --research nếu đã có khóa Perplexity, để Task Master tra cứu trước khi chia việc con. Xong việc nào thì đánh dấu bằng node scripts/dev.js set-status --id=3 --status=done.

Lưu ý

• Gắn với Cursor: README viết quy trình cho agent của Cursor, dựa vào file rules của Cursor. Trình soạn code khác thì tài liệu không nói cách dùng.
• Chi phí API: mỗi lần tạo, cập nhật hay chia nhỏ việc là một lần gọi Claude qua khóa của anh chị. Bật --research thì tốn thêm lượt gọi Perplexity.
• Dự án mới vài ngày tuổi: phiên bản và lệnh đổi liên tục, nên ghim phiên bản gói khi dùng cho dự án thật.
• Dữ liệu: nội dung PRD được gửi tới Anthropic API. PRD có thông tin kinh doanh nhạy cảm thì cần cân nhắc.

Nhận xét của chuyên gia

Task Master trúng một điểm mà nhiều người làm dự án với AI bỏ qua: agent giỏi làm từng việc nhỏ, nhưng kém giữ bức tranh cả dự án. Tách PRD thành việc có phụ thuộc và cách kiểm tra là cách quản lý dự án quen thuộc, chỉ khác là người thực hiện là AI.

Hợp với ai: người làm sản phẩm hoặc trưởng nhóm biết viết PRD, đang dùng Cursor; dự án nội bộ từ vài tuần trở lên như công cụ đặt lịch, trang quản lý đơn hàng, dashboard báo cáo.

Chưa hợp với ai: việc nhỏ chỉ sửa vài file, vì dựng PRD và bảng việc tốn công hơn làm luôn; nhóm không dùng Cursor; người chưa từng viết tài liệu yêu cầu, vì PRD sơ sài sẽ sinh ra bảng việc sơ sài.

Cách bắt đầu của tôi: lấy một dự án nhỏ đã làm xong, viết lại PRD một trang, cho Task Master chia việc rồi so với cách chia của chính anh chị. Khớp tới đâu thì tin tới đó. Và luôn coi tasks.json là bản nháp: trưởng nhóm đọc lại thứ tự, phụ thuộc, cách kiểm tra rồi mới cho agent chạy.

Một câu để nhớ: AI làm thợ thì giỏi, nhưng phải có người viết phiếu order cho rõ.

Câu hỏi thường gặp

Claude Task Master có miễn phí không?

Mã nguồn miễn phí theo giấy phép MIT. Anh chị trả phí cho lượng gọi Claude qua khóa Anthropic API, và Perplexity nếu dùng chế độ nghiên cứu.

Claude Task Master có cần Cursor không?

README thiết kế quy trình cho agent của Cursor qua file rules tự nạp. Các lệnh dev.js vẫn chạy tay được trong terminal bằng npm run dev.

PRD là gì, viết thế nào?

PRD là tài liệu mô tả sản phẩm cần làm: cho ai, giải quyết việc gì, có những chức năng nào. README khuyên viết càng chi tiết càng tốt vì đây là đầu vào để chia việc.

Claude Task Master dùng mô hình nào?

Mặc định là claude-3-7-sonnet-20250219, đổi được qua biến MODEL trong file .env. Chế độ nghiên cứu gọi thêm Perplexity nếu có PERPLEXITY_API_KEY.

Xem thêm các mốc khác trong chuỗi dòng thời gian AI.

Nguồn: eyaltoledano/claude-task-master trên GitHub, 04/03/2025.