Gunakan modus pelan

Panduan ini menunjukkan cara mendapatkan pelan berstruktur daripada ejen sebelum ia menulis sebarang kod.

Dalam modus pelan, ejen menyelidik secara baca sahaja dan satu-satunya serahannya ialah pelan bertaip: graf kebergantungan langkah yang anda luluskan, yang kemudiannya disusun oleh Control Center menjadi kerja sebenar. Gunakannya apabila anda ingin melihat skop sesuatu perubahan, melihat langkahnya terurai, atau mendapatkan risiko dan kebergantungan dinamakan sebelum apa-apa disentuh.

Tukar ruang kepada modus pelan

Mana-mana satu daripada ini menukar modus ruang itu dan perubahannya disimpan:

• Pilih Rancang daripada menu lungsur modus di hujung paling kiri bar alat penggubah mesej
• Tekan Shift+Tab
• Hantar /plan. /plan kosong hanya mempersiapkan modus itu; /plan <request> mempersiapkannya dan menghantar selebihnya sebagai mesej anda

/plan tidak pernah bergerak sebagai teks — ia menetapkan modus tersimpan, yang menjadi autoriti yang dibaca oleh permukaan alat, praset guardrail dan prompt. Jadi modus itu kekal untuk giliran ini dan setiap giliran selepasnya, sehingga anda menukarnya kembali.

Modus disimpan pada ruang, jadi ejen yang sama boleh berada dalam modus pelan di sini dan dalam modus ejen di tempat lain.

Apa yang dihasilkan ejen

1. Ia menyelidik secara baca sahaja — memori, indeks kod, fail
2. Ia memanggil submit_plan satu kali, dengan goal serta nodes, setiap satunya membawa key yang stabil, title, description dan kunci nod yang menjadi dependsOn-nya (inilah yang membolehkan kerja bebas berjalan secara selari)
3. Ia berhenti

Alat itu mengesahkan graf tersebut — kunci pendua, kebergantungan yang tergantung, kitaran — dan memulangkan pelanggaran untuk dibetulkan oleh ejen dan bukannya menerima pelan yang rosak.

Pelan itu muncul dalam perbualan sebagai baris padat yang menunjukkan matlamat, statusnya dan bilangan langkah. Plan Studio — graf kebergantungan, pemeriksa setiap nod dan anggaran kos — terbuka sebagai tab di sisi perbualan: tekan Buka pada baris itu, atau biarkan sahaja, kerana pelan yang tiba dalam masa 30 saat semasa anda memerhati perbualan akan membuka tabnya sendiri.

Jaminan baca sahaja bersifat struktur, tetapi hanya pada harness terbina

Harness Control Center sendiri membina registri alat ejen daripada spesifikasi permukaan modus pelan, jadi memang tiada alat tulis, sunting atau perintah untuk dipanggil — sekatan itu bukan arahan prompt yang boleh diloloskan oleh model dengan dalih apa pun.

Penyesuai Claude Code tidak mendapat penapisan sedemikian: modus sampai kepadanya sebagai permintaan yang mungkin dipatuhi atau tidak oleh pelarinya sendiri, dan Control Center hanya pernah melihat panggilan mcp__*-nya. Lencana penguatkuasaan di sebelah menu lungsur modus muncul tepat apabila itulah keadaannya.

Ejen boleh mengajukan soalan penjelasan kepada anda

Apabila permintaan itu kabur, ejen modus pelan boleh berhenti sejenak dan mengajukan sehingga tiga soalan yang menyekat dengan alat ask_user. Ia merender borang dalam perbualan — pilihan, atau teks bebas — dan larian itu menyekat sehingga anda menjawab. Alat itu peringkat baca, jadi ia kekal dalam permukaan baca sahaja modus pelan, dan ia dikecualikan daripada pembalut kelulusan (gesaan di hadapan gesaan akan gagal secara tertutup tanpa pelulus yang bersambung, sehingga menafikan ejen daripada perbuatan bertanya).

Ia memerlukan ruang untuk dirender, jadi penghantaran sekali sahaja tanpa perbualan tidak mendapatnya. Meletakkan skop, repo sasaran dan kriteria penerimaan di awal mesej pertama anda masih lebih pantas daripada satu pusingan bolak-balik.

Prosa bukanlah serahan di sini. Larian yang tamat tanpa memanggil submit_plan menyiarkan baris “Ended without submitting a plan (no submit_plan call).” yang kelihatan dalam perbualan dan menandakan larian itu sebagai terlepas serahannya. Status larian itu sengaja kekal completed — itu mengekalkan mesin keadaan pipeline dan tiket tanpa disentuh — jadi bacalah baris itu, bukan lencana status.

Luluskan pelan

Daripada baris pelan dalam perbualan, tekan Luluskan dan jalankan. Daripada bar kelulusan Plan Studio, tekan Luluskan rancangan (atau Tolak di sebelahnya; kelulusan dilumpuhkan selagi graf mempunyai ralat pengesahan).

Kemudian:

1. Control Center menyusun pelan itu menjadi satu orkestrasi dan mematerialisasikannya — tiket dan lariannya. Tiada model terlibat dalam langkah ini; ia deterministik
2. Pelan itu dilaksanakan sebagai ejen yang menulisnya. Sama ada untuk melibatkan orang lain ialah keputusan ejen itu pada masa larian — ia boleh delegate_task sesuatu langkah kepada rakan sepasukan yang lebih sesuai, dalam had kedalaman delegasi ruang kerja
3. Matlamat pelan itu menjadi matlamat perbualan dan kerja itu berjalan dalam perbualan yang sama: setiap langkah menyiarkan apa yang diminta daripada ejen dan menstrim balik gilirannya, jadi anda mengikutinya (dan boleh menghentikan sesuatu giliran) di tempat anda sudah berada
4. Baris matlamat dalam panel sisi Umum perbualan (di bawah Tugasan) membawa kemajuan larian sebagai settled/total dan butang hentinya; Plan Studio menunjukkan keadaan setiap nod pada graf dan juga membatalkan di sana

Terus bekerja tanpa meluluskan

Jika anda lebih suka kekal dalam perbualan ini daripada meluluskan pelan itu, ejen boleh memanggil exit_plan_mode. Itulah satu-satunya jalan keluar yang dibenarkan: ia membuka permintaan kelulusan berkekalan yang berpaut pada perbualan dan memulangkan pending — ruang itu kekal dalam modus pelan dan ejen tidak boleh bertindak. Setelah permintaan itu diluluskan, panggilan exit_plan_mode seterusnya oleh ejen menukar ruang itu daripada modus pelan kepada modus ejen dan membuka alat mutasinya. Penolakan membolehkannya membuka permintaan baharu terhadap pelan yang disemak semula.

Untuk keluar daripada modus pelan, tukar menu lungsur komposer (atau Shift+Tab), atau luluskan pelan yang diserahkan. exit_plan_mode membuka kelulusan berkekalan yang diputuskan dengan alat MCP decide_approval. Overlay guardrail untuk panggilan alat yang disekat ialah baris gilir dalam memori yang berbeza dan tidak membawa permintaan keluar modus pelan.

Modus pelan dalam langkah pipeline

Nod pipeline messaging.createSpace membaca modus perbualan daripada extra mode pada konfigurasi nod — extras['mode']: 'plan'. Kunci itu padanan tepat: sebarang ejaan lain, termasuk conversationMode atau dispatchMode, diabaikan secara senyap dan bilik itu kembali kepada nilai lalai badan berkenaan, iaitu modus semakan, bukan sembang. Langkah promptAgent menyertai bilik yang tidak diciptakannya dan tidak menetapkan semula kebenarannya. Pemilih Modus penghantaran dalam editor konfigurasi nod (allParallel / manager) adalah untuk nod penghantaran pasukan. Tetapkan modus perbualan dengan extras['mode'] pada templat yang membuka ruang itu, atau pada konfigurasi nod tersebut melalui API.

Panduan berkaitan

• Sembang dengan ejen
• Gunakan ruang
• Bekerja dalam Plan Studio
• Jalankan orkestrasi

Konsep berkaitan

• Modus
• Orkestrasi