Modus

Apa itu modus

Modus ialah sifat bagi ruang, disimpan sebagai satu lajur pada baris ruang. Setiap perbualan dalam sesebuah ruang berkongsinya, termasuk benang — benang mewarisi modus ruangnya seperti mana-mana perbualan lain. Ejen yang sama boleh berada dalam modus berbeza di ruang berbeza pada masa yang sama, dan menukar modus sesebuah ruang mengubah apa yang berlaku pada giliran seterusnya tanpa menyentuh ejen itu.

Terdapat tepat empat: chat, review, plan, orchestrate. Enum itu sendiri tidak membawa sebarang polisi. Segala yang dijamin oleh sesuatu modus diisytiharkan sekali sahaja, dalam satu profil keupayaan, yang menjadi sumber unjuran setiap lapisan penguatkuasaan:

1. Permukaan alat — alat mana yang wujud sama sekali dalam modus itu, dinyatakan sebagai peringkat kelulusan maksimum, satu senarai kebenaran, satu senarai larangan dan satu set kelas kesan yang ditolak.
2. Kata kerja output yang diperlukan — apa yang mesti dipanggil oleh larian untuk dianggap telah menyampaikan sesuatu.
3. Kelas kesan yang ditolak — apa yang ditolak terus oleh pengawal tindakan.
4. Postur worktree — sama ada worktree boleh ditulis. Ini dikuatkuasakan dengan mengeluarkan alat mutasi daripada permukaan, dan itulah yang menjadikannya bertahan pada setiap hos. Apabila hos mempunyai kotak pasir OS, postur yang sama turut mengukir peraturan tulis sistem fail — modus baca sahaja melekapkan worktree sebagai baca sahaja — tetapi itu salinan kedua jaminan tersebut, bukan yang melakukan kerja sebenar.
5. Blok gesaan sistem — prakata keupayaan yang dijana daripada senarai alat sebenar yang disediakan, serta panduan yang ditulis tangan.

Setiap lapisan penguatkuasaan memproyeksikan dirinya daripada satu profil itu, jadi permukaan alat, pengawal, postur worktree dan gesaan tidak boleh bercanggah.

Empat modus

Sembang — dipaparkan sebagai “Ejen”

Modus lalai dan satu-satunya modus tanpa kekangan tambahan: permukaan alat penuh hingga peringkat pelaksanaan, worktree boleh tulis, tiada kelas kesan yang ditolak dan tiada kontrak penyiapan. Gunakannya untuk pelaksanaan, pembetulan pepijat, soalan tentang pangkalan kod dan apa-apa sahaja yang ad hoc.

Perhatikan label: dalam komposer modus dipaparkan sebagai “Ejen”, bukan “Sembang”.

Pelan — baca sahaja, satu serahan

Modus pelan menjadikan worktree baca sahaja dan mengeluarkan alat tulis daripada permukaan sepenuhnya, jadi sekatan itu bersifat struktur dan bukan sekadar arahan. Ejen membaca, mencari dan meneliti lalu menyampaikan tepat satu perkara: panggilan submit_plan yang membawa graf kebergantungan bertaip — satu matlamat serta nod dengan kunci, tajuk, perihalan dan kunci nod yang menjadi kebergantungan setiap nod.

Pelan itu dipaparkan sebagai baris padat dalam perbualan dan membuka Plan Studio dalam tab di sisinya. Meluluskannya menyusun graf itu menjadi satu orkestrasi, menjalankan kerja yang dijana dan menukar ruang pengarangan kembali ke modus ejen.

Jika larian modus pelan tamat tanpa pernah memanggil submit_plan, gelung itu terlebih dahulu menyuntik satu dorongan yang menyatakan pelan itu tidak wujud sehingga panggilan tersebut berjaya. Dorongan itu secara jelas membenarkan jalan keluar yang jujur, “tiada pelan diperlukan di sini”, kerana modus pelan ialah tetapan ruang dan soalan biasa yang diajukan di dalamnya tidak sepatutnya memaksa pelan palsu.

Kontrak yang tidak dipenuhi bukan larian yang gagal

Larian yang tamat tanpa pelannya tetap direkodkan dengan status completed — proses itu keluar dengan bersih. Kebenarannya terbawa pada keaktifan larian (empty), keluarga ralat (silentRun) dan ringkasan yang menamakan apa yang tidak dihasilkan. Lihat Kitaran hayat penghantaran ejen.

Terdapat satu lagi jalan keluar yang berasingan: exit_plan_mode. Ia pintu kelulusan keras, bukan kata kerja output — ejen yang memanggilnya dan bukan submit_plan belum menyampaikan apa-apa. Panggilan pertama membuka kelulusan plan_exit yang berkekalan dan memulangkan pending, dan ruang itu kekal baca sahaja; panggilan berulang kekal pending dan tidak membuka pintu kedua. Hanya selepas kelulusan itu diberikan, panggilan seterusnya menukar ruang itu ke sembang. Penolakan membolehkan ejen membuka permintaan baharu untuk pelan yang disemak semula.

Untuk keluar sendiri daripada modus pelan, tukar menu lungsur komposer (atau Shift+Tab). exit_plan_mode diputuskan dengan alat MCP decide_approval. Baris “kelulusan ejen” dalam peti masuk ialah perkara lain: gesaan pengesahan bagi setiap giliran daripada ejen yang sedang berjalan.

Semakan — baca sahaja, tiada kontrak

Modus semakan adalah untuk semakan PR. Ia menjadikan worktree baca sahaja, mengehadkan permukaan alat di bawah peringkat pelaksanaan dan mengenakan senarai kebenaran terpilih bagi alat semakan, penetikan dan komunikasi. Ruang yang dibuka untuk sesuatu pull request dicipta dalam modus semakan secara automatik.

Output ejen ialah penemuan berstruktur — nod semakan — dan, apabila semakan dimuktamadkan, satu keputusan. Sesuatu nod membawa jenis (bug, suggestion, recommendation, question, atau ticket), keutamaan daripada P0 (menyekat keluaran) hingga P3 (bagus jika ada), keyakinan yang dinilai sendiri, sauh pilihan (fail serta julat baris; nota seluruh repositori tiada sauh) dan status kitaran hayat yang bergerak daripada open ke consensusReady sebaik sahaja seorang rakan — bukan sekali-kali pengarang — mengesahkannya. Penemuan yang keutamaan atau keyakinannya hilang atau di luar julat digugurkan pada sempadan bacaan dan tidak mencemarkan keputusan.

Keputusan itu ialah ship, hold, atau block dan ia hanya pernah menjadi lebih teruk akibat keputusan setiap paksi yang dilipat ke dalamnya: paksi bergerbang yang gagal memaksa block dan paksi bergerbang yang tidak dapat dijalankan memaksa sekurang-kurangnya hold. Ketiadaan bukti tidak pernah meluluskan sesuatu gerbang.

Tidak seperti pelan dan orkestrasi, semakan tidak membawa kontrak penyiapan. Penemuan terkumpul melalui add_review_node dan diterbitkan oleh finalize_review, dan kedua-duanya boleh dipanggil sifar kali secara sah — ejen pipeline yang berjalan dalam modus semakan mungkin berada di sana untuk melengkapkan tiket.

Orkestrasi — baca sahaja, mencadangkan pasukan

Modus orkestrasi menukar satu matlamat menjadi pelan seluruh pasukan. Seperti modus pelan, ia baca sahaja dan tidak boleh menulis fail; di atas permukaan penyelidikan, ia mempunyai satu kata kerja istimewa, propose_orchestration, yang mengeluarkan cadangan berstruktur: peranan, pokok sub-tiket, langkah sintesis dan belanjawan. Gesaan itu hanya menamakan alat yang ada pada permukaan, jadi model tidak membazirkan giliran untuk menceritakan pengambilan pekerja atau kerja tiket yang tidak dapat dipanggilnya.

Tiada apa-apa dalam cadangan itu dilaksanakan sehingga anda meluluskannya. Setelah diluluskan, satu proses pematerialan deterministik mengambil ejen, mencipta tiket dan projek serta menjalankan pipeline yang dijana. Meluluskan adalah untuk pengendali sahaja: tiada alat MCP untuknya, jadi ejen boleh mencadangkan tetapi tidak pernah meluluskan pelannya sendiri. Cadangan semula yang dimulakan oleh ejen dihadkan kadar oleh tempoh menunggu dua minit, jadi penjadualan semula berturut-turut ditolak dan diberitahu supaya bergabung. Lihat Orkestrasi.

Dua peraturan yang wajar diketahui

Kata kerja output bagi sesuatu modus tidak pernah boleh ditolak. submit_plan dan propose_orchestration dipakukan ke dalam permukaan alat dan diluluskan terlebih dahulu melepasi penapis alat, pintu kelulusan dan pengawal tindakan sekaligus, jadi dail autonomi setiap ruang tidak boleh membisukan serahan sesuatu modus. ask_user dalam harness dipakukan atas sebab yang sama: ia itulah cara sesuatu larian sampai kepada pengendali, jadi menggerbanginya akan menyekat mati larian yang perlu bertanya sesuatu. Ia peringkat baca, jadi setiap modus baca sahaja mengekalkannya, dan ia dikecualikan daripada pembalut kelulusan — gesaan di hadapan gesaan gagal secara tertutup tanpa pelulus yang bersambung, yang akan menafikan ejen daripada perbuatan bertanya.

Modus baca sahaja tidak menolak akses rangkaian atau rahsia. Kelas kesan yang ditolak oleh semakan, pelan dan orkestrasi ialah kelas yang mengubah dunia: pemadaman fail, penulisan di luar worktree, commit, push, penciptaan dan penerbitan PR, penulisan penyegerakan vendor, pemasangan pakej, pengeluaran proses, mutasi ruang kerja dan kawalan kepungan. Egress rangkaian dan akses rahsia kekal pada nilai lalai dengan sengaja — penyelidikan ialah keseluruhan tujuan modus baca sahaja.

Memilih dan menukar modus

Menu lungsur modus dalam komposer menawarkan tiga pilihan: Ejen (sembang), Rancang dan Orkestrakan. review tidak boleh dipilih oleh pengguna — ia ditetapkan oleh sistem apabila ruang semakan PR dicipta dan oleh langkah pipeline.

Nod pipeline yang membuka ruang boleh memakukan modus bilik itu dengan kunci extras['mode'] (chat, review, atau plan). Kunci itu padanan tepat: sebarang ejaan lain — termasuk orchestrate — diabaikan secara senyap dan bilik itu mendapat nilai lalai badan berkenaan (review pada badan cipta ruang). Langkah ejen menyertai bilik yang tidak diciptakannya dan tidak menetapkan semula kebenarannya.

Resolusi itu sendiri mudah. Penghantar membaca lajur mode ruang; penghantaran tanpa ruang — satu larian sekali sahaja, satu panggilan CLI, atau id ruang daripada ruang kerja lain, yang sememangnya tiada dalam fail pangkalan data ruang kerja ini — diselesaikan kepada chat. Menukar modus berkuat kuasa dari giliran seterusnya.

Di mana jaminan itu benar-benar berkuat kuasa

Permukaan alat sesuatu modus dibina dan dikuatkuasakan oleh harness terbina dalam. Ia satu-satunya pengangkutan yang boleh menjadikan alat tidak kelihatan dan bukan sekadar ditolak, menggerbangkan setiap panggilan sebelum ia berjalan dan memerhati kontrak penyiapan.

Pada pengangkutan Claude Code, modus bukan sembang dihantar sebagai --permission-mode plan. Claude mematuhinya secara konvensyen; alat baca, tulis dan sunting miliknya sendiri berjalan tanpa dilihat, dan perintah shell-nya hanya diperiksa oleh hook yang membaca baris perintah. Bagi pengangkutan itu, modus ialah panduan, bukan sempadan Control Center — lihat Model ejen.

Senarai kebenaran mengekang alat peringkat tulis dan ke atas. Peringkat baca harness terbina dalam masih sampai kepada alat yang tidak dinamakan mana-mana senarai; pada Claude Code, alat yang diabaikan oleh senarai kebenaran ditolak sama ada pelayan memilikinya atau tidak.

Konsep berkaitan

• Kitaran hayat penghantaran ejen: tempat modus diselesaikan dan diproyeksikan
• Model ejen: pengangkutan mana yang boleh menguatkuasakan sesuatu modus
• Guardrail: polisi kelas kesan yang menjadi input bagi praset modus
• Orkestrasi: apa yang dilakukan oleh cadangan orkestrasi yang diluluskan
• Gunakan modus pelan: panduan amali