Dùng chế độ kế hoạch

Hướng dẫn này chỉ cho bạn cách lấy một kế hoạch có cấu trúc từ một agent trước khi nó viết bất kỳ dòng mã nào.

Ở chế độ kế hoạch, agent nghiên cứu chỉ đọc và thứ duy nhất nó giao là một kế hoạch có kiểu: một đồ thị phụ thuộc gồm các bước do bạn phê duyệt, rồi Control Center biên dịch thành công việc thật. Hãy dùng nó khi bạn muốn thấy phạm vi của một thay đổi, xem các bước được chia nhỏ, hay muốn rủi ro và phụ thuộc được nêu tên trước khi có bất cứ thứ gì bị đụng tới.

Chuyển một space sang chế độ kế hoạch

Bất kỳ cách nào sau đây cũng chuyển chế độ của space và thay đổi được lưu lại:

Chọn Kế hoạch từ hộp chọn chế độ ở tận cùng bên trái của thanh công cụ trình soạn
Nhấn Shift+Tab
Gửi /plan. Một /plan trần chỉ nạp chế độ; /plan <request> nạp nó và gửi phần còn lại làm tin nhắn của bạn

/plan không bao giờ được truyền dưới dạng văn bản — nó đặt chế độ đã lưu, thứ là thẩm quyền mà bề mặt công cụ, preset rào chắn và prompt đều đọc. Vì vậy chế độ giữ nguyên cho lượt này và mọi lượt sau đó, cho tới khi bạn đổi lại.

Chế độ được lưu trên space, nên cùng một agent có thể ở chế độ kế hoạch tại đây và ở chế độ agent ở nơi khác.

Thứ mà agent tạo ra

Nó nghiên cứu chỉ đọc — bộ nhớ, chỉ mục mã, các tệp
Nó gọi submit_plan đúng một lần, với một goal cùng nodes, mỗi nút mang một key ổn định, một title, một description và các khóa nút mà nó dependsOn (chính điều này cho phép công việc độc lập chạy song song)
Nó dừng lại

Công cụ xác thực đồ thị — khóa trùng, phụ thuộc treo, chu trình — và trả về các vi phạm để agent sửa thay vì chấp nhận một kế hoạch hỏng.

Kế hoạch xuất hiện trong cuộc hội thoại dưới dạng một hàng gọn hiển thị mục tiêu, trạng thái và số bước. Plan Studio — đồ thị phụ thuộc, trình kiểm tra từng nút và ước tính chi phí — mở ra thành một tab bên cạnh cuộc hội thoại: nhấn Mở trên hàng đó, hoặc chỉ cần chờ, vì một kế hoạch về đích trong vòng 30 giây khi bạn đang xem cuộc hội thoại sẽ tự mở tab của nó.

Harness của chính Control Center dựng sổ đăng ký công cụ của agent từ đặc tả bề mặt của chế độ kế hoạch, nên đơn giản là không có công cụ ghi, sửa hay lệnh nào để gọi — hạn chế này không phải một chỉ thị trong prompt mà mô hình có thể tự thuyết phục để lách qua.

Adapter Claude Code không nhận được kiểu lọc đó: chế độ tới nó như một yêu cầu mà runner của chính nó có thể tôn trọng hoặc không, và Control Center chỉ luôn nhìn thấy các lời gọi mcp__* của nó. Huy hiệu thực thi bên cạnh hộp chọn chế độ xuất hiện đúng khi rơi vào trường hợp đó.

Khi yêu cầu mơ hồ, một agent kế hoạch có thể tạm dừng và hỏi bạn tối đa ba câu hỏi chặn bằng công cụ ask_user. Nó hiển thị một biểu mẫu trong cuộc hội thoại — các lựa chọn, hoặc văn bản tự do — và lượt chạy bị chặn cho tới khi bạn trả lời. Công cụ này thuộc cấp đọc, nên nó tồn tại được trên bề mặt chỉ đọc của chế độ kế hoạch, và nó được miễn khỏi lớp bọc phê duyệt (một lời nhắc đặt trước một lời nhắc sẽ thất bại theo hướng đóng khi không có người phê duyệt nào được kết nối, tước của agent chính hành vi hỏi).

Nó cần một space để hiển thị vào, nên một lượt điều phối một lần không có cuộc hội thoại sẽ không có nó. Việc nêu sẵn phạm vi, kho mã đích và tiêu chí chấp nhận ngay trong tin nhắn đầu tiên vẫn nhanh hơn một vòng hỏi đáp.

Văn xuôi không phải là kết quả giao ở đây. Một lượt chạy kết thúc mà không gọi submit_plan sẽ đăng một dòng hiển thị “Đã kết thúc mà không gửi kế hoạch (không có lời gọi submit_plan).” trong cuộc hội thoại và đánh dấu lượt chạy là đã bỏ lỡ kết quả giao. Trạng thái của lượt chạy cố ý giữ nguyên ở completed — điều đó giữ máy trạng thái của quy trình và phiếu không bị đụng tới — nên hãy đọc dòng đó, chứ không phải huy hiệu trạng thái.

Phê duyệt kế hoạch

Từ hàng của kế hoạch trong cuộc hội thoại, nhấn Phê duyệt và chạy. Từ thanh phê duyệt của Plan Studio, nhấn Phê duyệt kế hoạch (hoặc Từ chối bên cạnh; việc phê duyệt bị vô hiệu hóa khi đồ thị có lỗi xác thực).

Sau đó:

Control Center biên dịch kế hoạch thành một điều phối và hiện thực hóa nó — các phiếu và lượt chạy. Không có mô hình nào tham gia ở bước này; nó mang tính tất định
Kế hoạch thực thi với tư cách chính agent đã viết ra nó. Việc có kéo thêm ai khác vào hay không là quyết định của agent đó lúc chạy — nó có thể delegate_task một bước cho một đồng đội phù hợp hơn, trong giới hạn độ sâu ủy thác của không gian làm việc
Mục tiêu của kế hoạch trở thành mục tiêu của cuộc hội thoại và công việc chạy trong chính cuộc hội thoại đó: mỗi bước đăng thứ agent được yêu cầu và truyền trực tiếp lượt của nó về, nên bạn theo dõi nó (và có thể dừng một lượt) ngay tại nơi bạn đang ở
Hàng mục tiêu trong bảng bên Chung của cuộc hội thoại (dưới Việc cần làm) mang tiến độ của lượt chạy dưới dạng settled/total cùng nút dừng của nó; Plan Studio hiển thị trạng thái từng nút trên đồ thị và cũng hủy được ở đó

Tiếp tục làm việc mà không phê duyệt

Nếu bạn muốn ở lại cuộc hội thoại này hơn là phê duyệt kế hoạch, agent có thể gọi exit_plan_mode. Đó là lối thoát duy nhất được cho phép: nó mở một yêu cầu phê duyệt bền vững gắn với cuộc hội thoại và trả về pending — space vẫn ở chế độ kế hoạch và agent không được hành động. Khi yêu cầu được phê duyệt, lời gọi exit_plan_mode kế tiếp của agent sẽ chuyển space từ chế độ kế hoạch sang chế độ agent và mở khóa các công cụ thay đổi của nó. Một lần từ chối cho phép nó mở một yêu cầu mới cho một kế hoạch đã chỉnh sửa.

Để rời chế độ kế hoạch, hãy đổi hộp chọn của trình soạn (hoặc Shift+Tab), hay phê duyệt kế hoạch đã gửi. exit_plan_mode mở một phê duyệt bền vững được quyết định bằng công cụ MCP decide_approval. Lớp phủ rào chắn cho các lời gọi công cụ bị chặn là một hàng đợi khác, nằm trong bộ nhớ, và không mang các yêu cầu thoát chế độ kế hoạch.

Chế độ kế hoạch trong một bước quy trình

Một nút quy trình messaging.createSpace đọc chế độ hội thoại từ extra mode trong cấu hình nút — extras['mode']: 'plan'. Khóa này khớp chính xác: mọi cách viết khác, kể cả conversationMode hay dispatchMode, đều bị bỏ qua âm thầm và phòng sẽ quay về mặc định của body, tức chế độ Rà soát, chứ không phải trò chuyện. Một bước promptAgent tham gia vào phòng mà nó không tạo ra và không cấp lại quyền cho phòng đó. Hộp chọn Chế độ điều phối trong trình soạn cấu hình nút (allParallel / manager) dành cho các nút điều phối đội. Hãy đặt chế độ hội thoại bằng extras['mode'] trên một mẫu mở space, hoặc trên cấu hình của nút đó thông qua API.