SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Dikemas kini 2026-10-26

Mengapa Ejen Pengekodan Mengabaikan Arahan Anda

Arahan anda menyuruh ejen berhenti, tetapi ia terus bekerja. Ketahui empat punca sebenar dan diagnosis yang boleh dijalankan sebelum menulis semula peraturan.

Mengapa ejen pengekodan mengabaikan arahan anda

Ejen pengekodan mengabaikan arahan anda disebabkan oleh empat perkara, dan tiada satu pun daripadanya adalah kerana anda terlalu sopan. Peraturan tersebut tidak pernah berada dalam tetingkap konteks. Peraturan itu terlalu samar untuk menyemak sesuatu tindakan. Sesuatu yang lain dalam konteks bercanggah dengannya, biasanya kod yang baru sahaja dibaca oleh ejen tersebut. Atau peraturan itu masih dimuatkan tetapi berada jauh di belakang giliran semasa, dan ejen tersebut bekerja berdasarkan apa yang berdekatan.

Setiap punca mempunyai penyelesaiannya sendiri, jadi tugas pertama adalah membezakannya. Huruf besar dan perkataan IMPORTANT bukanlah satu diagnosis. Mekanisme di bawah menggunakan Claude Code sebagai contoh kerja, kerana tingkah laku pemuatan dan pemadatannya didokumenkan secara terperinci setakat Oktober 2026. Alat lain berbeza dari segi perincian tetapi berkelakuan sama secara garis besar.

Dua istilah terlebih dahulu. Tetingkap konteks ialah blok teks yang dilihat oleh model pada giliran tertentu: gesaan sistem, fail arahan anda, perbualan, dan setiap fail yang telah dibaca oleh ejen. Harness ialah program di sekeliling model, perkara yang membaca fail daripada cakera dan menyusun blok tersebut. Hampir setiap aduan dalam catatan ini sebenarnya adalah aduan tentang harness, bukan model.

Fail arahan anda ialah mesej, bukan tetapan

Fail arahan bukan konfigurasi. Tiada apa-apa dalam runtime membaca CLAUDE.md lalu menguatkuasakannya. Harness membaca fail itu daripada cakera dan menampal teksnya ke dalam perbualan. Dalam Claude Code, kandungan itu dihantar sebagai mesej pengguna yang diletakkan selepas system prompt. Oleh itu, model melihat peraturan anda seperti melihat apa-apa teks lain yang anda taip.

Kesan yang sukar diterima ialah peraturan anda bersaing dengan setiap teks lain dalam tetingkap itu pada kedudukan yang sama. Sesuatu peraturan ialah dakwaan. Fail yang baru dibuka oleh ejen ialah bukti. Apabila kedua-duanya bercanggah, bukti sering mengatasi peraturan. Tiada ralat dibangkitkan kerana dari sudut pandangan model, tiada apa-apa yang gagal.

Dokumentasi rasmi menyatakan perkara ini dengan jelas: fail arahan dianggap sebagai konteks, bukan konfigurasi yang dikuatkuasakan. Untuk menyekat sesuatu tindakan tanpa mengira keputusan model, anda memerlukan hook, bukan ayat arahan. Ingat perkara itu. Kebanyakan pembaikan pada penghujung catatan ini ialah penerapan prinsip tersebut pada kes tertentu.

Fail arahan yang dimuatkan, dan bila ia dimuatkan

Claude Code menyemak direktori dari direktori tempat anda memulakannya ke atas. Setiap CLAUDE.md dan CLAUDE.local.md dari root sistem fail sehingga ke direktori kerja anda dimuatkan sepenuhnya semasa pelancaran. Fail-fail ini digabungkan mengikut urutan tersebut, jadi fail yang paling hampir dengan lokasi anda melancarkan arahan dibaca paling akhir, dan dalam direktori yang sama, fail .local ditambah selepas fail utama.

Fail dalam subdirektori di bawah direktori kerja anda berkelakuan berbeza. Ia tidak dimuatkan semasa pelancaran. Ia dimuatkan apabila ejen membaca fail dalam direktori tersebut. Perkara yang sama berlaku pada peraturan skop laluan dalam .claude/rules/ yang membawa medan frontmatter paths:: ia memasuki konteks apabila fail yang sepadan dibaca, bukan pada setiap giliran. Sejak v2.1.309, fail yang dimuatkan dengan cara ini juga mempunyai had saiz setiap fail (40,000 aksara pada tetingkap konteks 200K), dan ejen hanya menerima bahagian permulaan fail yang panjang, jadi peraturan berhampiran penghujung fail bersarang yang besar mungkin tidak akan sampai ke dalam konteks.

Perbezaan tunggal itu menjelaskan sebahagian besar kegagalan yang dilaporkan. Anda meletakkan peraturan dalam packages/api/CLAUDE.md, anda bertanya soalan tentang API, dan ejen menjawab tanpa membuka sebarang fail di bawah packages/api/. Peraturan itu tidak diabaikan. Ia tidak pernah wujud. Jika repositori anda membahagikan panduan merentasi fail arahan setiap pakej dalam monorepo, ini adalah perkara pertama yang perlu diperiksa, setiap kali.

Satu lagi perangkap pemuatan menjejaskan repositori yang menyeragamkan penggunaan AGENTS.md. Sejak v2.1.277, Claude Code membaca AGENTS.md sebagai arahan projek anda secara lalai, tetapi hanya apabila tiada CLAUDE.md, .claude/CLAUDE.md atau CLAUDE.local.md dalam direktori kerja anda atau mana-mana direktori di atasnya (~/.claude/CLAUDE.md peribadi anda tidak dikira). Tambahkan mana-mana satu daripadanya, walaupun CLAUDE.local.md untuk nota peribadi, dan Claude Code akan membaca fail CLAUDE.md anda sebaliknya dan meninggalkan AGENTS.md sepenuhnya. Untuk memuatkan kedua-duanya, tetapkan Project instructions kepada claude-md-and-agents-md dalam /config. Pada versi sebelum v2.1.277, atau apabila anda ingin mengekalkan CLAUDE.md, jambatannya ialah CLAUDE.md yang baris pertamanya ialah @AGENTS.md, yang mengimport fail tersebut semasa pelancaran, dengan sebarang nota khusus Claude di bawahnya. Symlink juga berfungsi apabila anda tidak mempunyai apa-apa tambahan untuk disertakan. Menentukan perkara yang sepatutnya terkandung dalam fail tersebut adalah soalan berasingan, yang dibincangkan dalam memisahkan arahan ejen daripada dokumentasi manusia.

Sahkan fail telah dimuatkan sebelum anda menulis semulanya

Jangan ubah sebarang perkataan sehingga anda mempunyai bukti bahawa ejen boleh melihat fail tersebut. Terdapat dua pemeriksaan, dan pemeriksaan yang mudah dilakukan dahulu.

Jalankan /context di dalam sesi. Ia mencetak tetingkap semasa yang dipecahkan mengikut kategori, dan senarai Memory files menamakan setiap fail arahan yang dimuatkan semasa pelancaran. Fail yang tiada dalam senarai itu tidak dimuatkan semasa pelancaran, jadi apa sahaja yang anda tulis di dalamnya tidak akan memberi kesan sehingga sesuatu memuatkannya. Fail bersarang dalam subdirektori tidak akan muncul di situ kerana ia dimuatkan atas permintaan; apabila ia dimuatkan, baris Loaded dengan laluannya akan muncul dalam terminal. /memory menyenaraikan lokasi fail dan membukanya untuk disunting, termasuk fail yang belum wujud.

Untuk jawapan yang lebih tepat, log muatan tersebut. Peristiwa hook InstructionsLoaded tercetus setiap kali CLAUDE.md atau fail peraturan memasuki konteks, dan pemadannya memberitahu anda sebab muatan berlaku: session_start, nested_traversal, path_glob_match, include, atau compact. Letakkan ini dalam .claude/settings.json:

{
  "hooks": {
    "InstructionsLoaded": [
      {
        "matcher": "nested_traversal",
        "hooks": [
          {
            "type": "command",
            "command": "cat >> /tmp/instructions-loaded.log"
          }
        ]
      }
    ]
  }
}

Hook tersebut menerima muatannya sebagai JSON pada input standard, jadi cat menambah keseluruhan rekod tersebut. Pantau ia dengan tail -f /tmp/instructions-loaded.log semasa anda bekerja. Status keluar peristiwa ini diabaikan, jadi hook hanya boleh memerhati dan tidak boleh menyekat. Jika fail bersarang anda tidak pernah muncul dalam log tersebut semasa sesi yang anda jangkakan, berhenti menulis semula. Masalahnya terletak pada penempatan. Satu pengecualian: AGENTS.md yang dibaca terus oleh Claude Code tidak mencetuskan peristiwa ini, jadi cari laluannya dalam /memory sebagai gantinya. AGENTS.md yang diimport daripada CLAUDE.md mencetuskannya seperti biasa.

Kesan sesi yang panjang terhadap peraturan anda

Dua kesan berasingan berlaku di sini, dan ia memerlukan respons yang berbeza.

Jarak. Selagi proses pemadatan (compaction) tidak dijalankan, peraturan yang dinyatakan pada pusingan 1 masih berada dalam tetingkap pada pusingan 90, kini bersaing dengan 90 pusingan teks yang lebih baharu dan lebih khusus kepada perkara yang sedang anda lakukan sekarang. Sebaik sahaja pemadatan dijalankan, peraturan yang hanya anda taip ke dalam sembang mungkin tidak lagi berada dalam tetingkap tersebut: dokumentasi Claude Code sendiri memberi amaran bahawa arahan dari awal perbualan boleh hilang, yang merupakan kesan kedua di bawah. Anda tidak boleh mengkonfigurasi jarak, tetapi anda boleh mengukurnya. Jalankan tugasan yang sama dalam sesi baharu. Jika peraturan itu berkesan di sana tetapi gagal jauh di dalam sesi yang panjang, jarak atau pemadatan adalah jawapannya.

Pemadatan. Apabila tetingkap penuh, sistem akan meringkaskan perbualan setakat ini dan meneruskan daripada ringkasan tersebut. Apa yang kekal adalah apa yang dianggap penting oleh sistem peringkas, yang tidak sama dengan apa yang anda anggap penting. Claude Code mendokumentasikan hasil mengikut mekanisme, dan perbezaannya adalah besar. CLAUDE.md akar projek dan peraturan tanpa skop akan disuntik semula daripada cakera selepas pemadatan. Memori automatik disuntik semula daripada cakera. Peraturan dengan frontmatter paths: akan hilang sehingga fail yang sepadan dibaca semula. Fail CLAUDE.md bersarang dalam subdirektori akan hilang sehingga fail dalam subdirektori tersebut dibaca semula.

Susun arahan anda mengikut jadual tersebut dan tahap kerapuhan akan kelihatan. Peraturan yang hanya anda taip dalam sembang adalah perkara yang paling rapuh dalam sesi: ia hanya kekal jika ringkasan kebetulan menyimpannya. Peraturan dalam packages/api/CLAUDE.md adalah yang seterusnya, kerana ia dimuatkan sekali, diringkaskan, dan hanya kembali pada bacaan seterusnya dalam direktori tersebut. Peraturan dalam fail akar projek adalah yang paling tahan lama, kerana ia dibaca semula daripada cakera setiap kali.

Jadi, jika sesuatu arahan mesti kekal untuk keseluruhan sesi, ia perlu diletakkan dalam fail akar projek tanpa frontmatter paths:. Segala perkara lain adalah pertukaran (tradeoff) yang perlu anda buat dengan sengaja. Mengurus perkara yang kekal dalam tetingkap konteks merangkumi /compact dengan argumen fokus dan /clear antara tugasan yang tidak berkaitan, kedua-duanya mengubah kekerapan sistem peringkas menentukan peraturan anda.

Mengapa kod sekeliling mengatasi peraturan

Inilah kegagalan yang paling kerap diterangkan tetapi paling jarang didiagnosis. Fail anda menyatakan bahawa akses pangkalan data mesti melalui lapisan repositori. Agent menulis handler yang memanggil ORM (object relational mapper) secara langsung. Arahan anda bukan diabaikan kerana gaya. Arahan itu kalah berdasarkan bukti.

Peraturan menerangkan keutamaan. Kod menunjukkan satu keutamaan. Apabila agent membuka tiga fail dalam modul yang akan dieditnya dan ketiga-tiganya memanggil ORM secara langsung, konteks mengandungi satu ayat abstrak di satu pihak dan tiga contoh konkrit, terkini serta sepadan dengan tugasan di pihak yang lain. Menyalin corak setempat biasanya ialah tingkah laku yang betul. Dalam kes ini, tindakan itu salah hanya kerana anda mengetahui sesuatu yang tidak diketahui oleh konteks: fail-fail itu ialah kod legasi.

Jadi, nyatakan perkara itu dalam peraturan. Peraturan yang menyatakan bukti balasnya sendiri dapat bertahan apabila digunakan dalam repositori sebenar. Peraturan yang hanya menyatakan keutamaan umum tidak dapat berbuat demikian.

Akses pangkalan data baharu mesti melalui app/repositories/. Fail di bawah app/legacy/ masih memanggil ORM secara langsung. Itu ialah kod lama, bukan coraknya. Jangan salin kod tersebut.

Ayat kedua itulah yang menjalankan fungsi utama. Ayat itu memberitahu agent perkara yang bakal ditemuinya dan cara menafsirkannya sebelum agent menemuinya. Pembaikan yang sama terpakai pada mana-mana peraturan yang jelas bercanggah dengan repositori anda: gaya commit yang tidak dipatuhi oleh sejarah anda, susun atur ujian yang tidak digunakan oleh separuh daripada suite anda, atau konvensyen import yang hanya terpakai dalam kod baharu. Apabila kod bercanggah dengan fail, nyatakan percanggahan itu dalam fail.

Peraturan yang kabur tidak boleh disemak, maka peraturan itu tidak boleh dipatuhi

"Write clean code." "Do not over engineer." "Keep it simple." "Be careful with migrations." Tiada satu pun peraturan ini boleh diuji berdasarkan tindakan tertentu, sama ada oleh agent atau oleh anda. Agent yang diberikan peraturan yang tidak boleh disemak terhadap outputnya sendiri hanya membuat tekaan, manakala anda menilai tekaan itu berdasarkan perasaan.

Gunakan ujian ini pada setiap baris dalam fail anda. Tulis arahan shell yang akan keluar dengan kod bukan sifar apabila peraturan itu dilanggar. Jika anda tidak dapat menulis arahan tersebut, peraturan itu tidak boleh disemak. Bandingkan pasangan berikut:

  • Tidak boleh disemak: "Pastikan fungsi kecil." Boleh disemak: "Fungsi yang melebihi 60 baris memerlukan ulasan di atasnya yang menerangkan sebabnya."
  • Tidak boleh disemak: "Uji perubahan anda." Boleh disemak: "Jalankan npm test dan tampal bilangan kegagalan sebelum menandakan tugasan sebagai selesai."
  • Tidak boleh disemak: "Pastikan fail tersusun." Boleh disemak: "Pengendali HTTP berada dalam src/api/handlers/. Tiada perkara lain boleh diletakkan dalam direktori itu."
  • Tidak boleh disemak: "Format kod dengan betul." Boleh disemak: "Gunakan inden 2 ruang dalam fail .ts."

"Do not over engineer" ialah peraturan yang paling awal ditinggalkan oleh orang ramai kerana pembaikannya bukan ayat yang lebih pendek, tetapi ayat yang lebih panjang: menjelaskan perkara yang sebenarnya dimaksudkan oleh perubahan terkecil yang berfungsi memberikan agent kriteria yang boleh digunakan untuk menyemak diffnya sendiri.

Saiz ialah masalah yang sama dalam bentuk berbeza. Panduan Claude Code menyasarkan kurang daripada 200 baris bagi setiap fail arahan dan menyatakan secara langsung bahawa fail yang lebih panjang mengurangkan pematuhan. Fail 700 baris bukan arahan yang lebih tegas. Fail itu mengandungi 700 baris dakwaan dengan lebih banyak kemungkinan untuk saling bercanggah, dan kandungannya menggunakan ruang konteks anda pada setiap giliran, yang terus kelihatan dalam penggunaan token anda. Menyusun fail supaya setiap peraturan berada di bawah heading yang boleh diimbas oleh pembaca dibincangkan dalam menulis fail arahan yang boleh dilaksanakan oleh agent. Lebih baik lagi, potong bahagian yang menerangkan dan bukannya memberikan arahan: penerangan direktori tentang lokasi pengendali dan model ialah struktur yang boleh dicari oleh agent apabila diperlukan daripada peta repository yang telah dihuraikan, bukannya disimpan dalam ruang konteks pada setiap giliran.

Cara mendiagnosisnya dalam sepuluh minit

Jalankan langkah-langkah ini mengikut urutan. Melangkau terus ke langkah terakhir adalah punca mengapa ramai orang berakhir dengan fail peraturan panjang yang masih tidak berfungsi.

  1. Sahkan ia dimuatkan. Jalankan /context dan baca senarai fail Memory, atau untuk fail bersarang, cari baris Loaded miliknya di dalam terminal. Jika fail tersebut tiada, betulkan lokasinya dan berhenti. Tiada perkara lain dalam senarai ini yang terpakai buat masa ini.
  2. Uji semula dalam sesi baharu. Mulakan sesi baharu dan berikan tugasan paling kecil yang sepatutnya mencetuskan peraturan tersebut. Jika ia berjaya di sini tetapi gagal dalam sesi yang panjang, ini menunjukkan masalah pada jarak atau pemadatan (compaction). Jika ia gagal di sini juga, bermakna peraturan itu sendiri adalah masalahnya.
  3. Singkirkan persaingan. Minta perubahan yang sama dalam direktori yang kod sedia adanya sudah mematuhi peraturan tersebut. Jika pematuhan kembali berlaku, kod di sekelilingnya telah mengatasi arahan anda.
  4. Cari konflik. Dua fail yang memberikan panduan berbeza untuk kelakuan yang sama adalah kegagalan yang didokumentasikan: model mungkin memilih salah satu secara arbitrari, dan ia tidak akan memberitahu anda mengenainya.
  5. Jadikannya boleh diperiksa dan uji semula. Tulis semula peraturan dengan laluan (path) dan syarat yang konkrit. Lonjakan besar dalam pematuhan bermakna cara penulisan anda adalah puncanya.

Langkah 4 hanyalah satu arahan. Gunakan grep pada setiap sumber arahan untuk topik tersebut, bukan hanya pada fail yang sedang anda sunting:

grep -rni "migration" --include="CLAUDE.md" --include="CLAUDE.local.md" --include="AGENTS.md" .
grep -rni "migration" .claude/rules/ ~/.claude/CLAUDE.md ~/.claude/rules/ 2>/dev/null

Hasil carian dalam dua fail yang menyatakan perkara berbeza adalah pepijat anda. Padamkan salah satu. Jangan cuba meletakkan kedudukan (rank) antara keduanya dengan perkataan yang lebih tegas, kerana tiada enjin kedudukan untuk dirujuk. Pada Claude Code v2.1.283 atau lebih baharu, /doctor prompt-audit menjalankan versi carian yang lebih luas ini merentasi fail arahan, peraturan dan kemahiran anda, serta melaporkan percanggahan dengan cadangan suntingan tanpa mengubah apa-apa sehingga anda memintanya.

Pembaikan, mengikut tahap keberkesanan

Setiap langkah di bawah mempunyai keberkesanan yang lebih tinggi daripada langkah sebelumnya, namun memerlukan kos penyediaan yang lebih besar. Mulakan dari atas apabila sesuatu peraturan mudah untuk diolah semula. Beralih ke bawah sebaik sahaja sesuatu peraturan menjadi cukup penting sehingga kegagalan sekali-sekala tidak boleh diterima.

  1. Jadikan peraturan tersebut konkrit. Namakan laluan, arahan atau syarat. Tambahkan bukti penyangkal yang akan ditemui oleh ejen dalam repositori, seperti yang ditunjukkan sebelum ini. Langkah ini percuma dan menyelesaikan sebahagian besar kes yang mengejutkan.
  2. Alihkan peraturan lebih dekat dengan perkara yang dikawalnya. CLAUDE.md yang bersarang, peraturan yang dilingkupi laluan dalam .claude/rules/, atau ulasan di bahagian atas fail itu sendiri. Peraturan tersebut kemudiannya dibaca bersama-sama dengan kod yang berkaitan. Terima pertukaran ini: apa-apa yang dimuatkan dengan cara itu akan digugurkan pada pemadatan seterusnya dan kembali pada bacaan padanan seterusnya.
  3. Pindahkan penguatkuasaan ke dalam hook. Prosa sekadar meminta. Hook pula membuat keputusan. Hook berjalan sebagai kod pada peristiwa kitaran hayat yang tetap dan terpakai tanpa mengira apa yang disimpulkan oleh model.
  4. Berikan peraturan kepada alat deterministik dan padamkan prosa tersebut. Pemformatan, susunan import, panjang baris, import yang dilarang, bentuk mesej komit. ruff format, prettier --write, eslint, hook pre-commit. Pemformat sentiasa betul dan tidak menggunakan token. Ayat hanya betul pada kebanyakan masa dan menggunakan token pada setiap pusingan.

Langkah 3 secara penuh. Andaikan fail migrasi tidak boleh disunting oleh ejen. Letakkan ini dalam .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-migrations.sh"
          }
        ]
      }
    ]
  }
}

Dan ini dalam .claude/hooks/guard-migrations.sh:

#!/usr/bin/env bash
set -euo pipefail

path=$(jq -r '.tool_input.file_path // empty')

case "$path" in
  */migrations/*)
    echo "Files under migrations/ are written by hand. Stop and ask first." >&2
    exit 2
    ;;
esac

exit 0

Jalankan chmod +x .claude/hooks/guard-migrations.sh, kemudian mulakan sesi baharu dan minta ejen menyunting fail di bawah migrations/. Suntingan tersebut ditolak dan mesej anda dikembalikan sebagai alasan. Status keluar 2 pada PreToolUse menyekat panggilan alat sebelum ia dijalankan, dan teks stderr anda diserahkan kepada model sebagai mesej sekatan. ${CLAUDE_PROJECT_DIR} merujuk kepada akar projek, jadi hook berfungsi tidak kira direktori mana ejen berada. Ejen tidak perlu bersetuju dengan peraturan, mengingati peraturan, atau masih mempunyai peraturan tersebut dalam konteks. Suntingan tersebut tidak berlaku.

Untuk larangan mutlak tanpa sebarang logik di dalamnya, permissions.deny dalam tetapan anda melakukan tugas yang sama tanpa skrip untuk diselenggara, dan mod kebenaran menentukan apa yang berjalan tanpa bertanya kepada anda terlebih dahulu. Jika sesuatu arahan benar-benar perlu berada pada tahap gesaan sistem dan bukannya dalam mesej pengguna, --append-system-prompt meletakkannya di sana, walaupun ia merupakan flag pelancaran yang perlu diluluskan semula bagi setiap sesi baharu, yang lebih sesuai untuk skrip berbanding kerja interaktif.

Perkara yang tidak boleh diarahkan

Jelaskan bahagian yang menjadi tanggungjawab anda. Penempatan, frasa, konflik antara fail dan saiz fail ialah masalah pengarang yang perlu diselesaikan oleh pengarang. Selebihnya ialah tingkah laku model, dan pemilihan kata yang lebih baik tidak akan menghapuskannya.

Persetujuan bukan pematuhan. Ejen akan mengakui sesuatu peraturan, mengulanginya semula dengan betul, kemudian melanggarnya dua panggilan alat kemudian. Pengakuan itu tidak memerlukan apa-apa dan tidak meramalkan apa-apa. Jangan anggap pengakuan sebagai pembaikan dan jangan kira sebagai ujian.

Sesetengah tabiat berterusan. Menambah komen, menambah pengendalian ralat defensif, menulis ringkasan penutup dan menjalankan arahan seterusnya yang jelas. Semua ini akan muncul semula apabila terdapat peraturan yang melarangnya, tetapi pada kadar yang lebih rendah, bukan sifar. Anda boleh mengukur kadarnya sendiri: jalankan tugas yang sama sepuluh kali dalam sesi baharu dan kira pelanggaran. Jika bilangannya perlu sifar, peraturan itu perlu dikeluarkan daripada prompt. Menganggap tugas telah selesai sedangkan sebahagian daripadanya masih belum selesai ialah bentuk tabiat yang sama. Pembaikannya bersifat struktur, bukan lisan: skill unlazy menukar ayat itu kepada Depth Tree dan fail gate yang perlu dilalui ejen sebelum boleh mengisytiharkan tugas selesai.

Sesi anda sendiri menjadi contoh. Jika ejen melanggar peraturan pada giliran 12 dan anda membiarkannya, pelanggaran itu kini berada dalam konteks sebagai contoh dan jauh lebih terkini berbanding peraturan tersebut. Betulkan pelanggaran sebaik sahaja anda melihatnya. Pelanggaran yang tidak dibetulkan mengajar seluruh sesi.

Fail arahan bukan sempadan keselamatan. Fail itu membentuk tingkah laku tetapi tidak menguatkuasakannya. Apa-apa perkara yang mahal akibat kegagalan, seperti kelayakan atau arahan yang merosakkan, hendaklah dikawal melalui permission atau hook. Menjauhkan rahsia daripada capaian ejen menggunakan prinsip yang sama terhadap data: jangan minta ejen supaya tidak membaca fail; pastikan fail itu tidak boleh dibaca.

Ringkasnya: buktikan bahawa fail telah dimuatkan, jadikan peraturan boleh disemak, letakkannya bersebelahan dengan perkara yang dikawalnya, dan apabila kadar kegagalan masih penting, keluarkan peraturan itu daripada prosa. Peraturan yang tidak boleh diabaikan oleh ejen ialah peraturan yang tidak pernah diminta daripada ejen.

FAQ

Mengapa Claude Code mengabaikan CLAUDE.md saya?

Pastikan fail tersebut dimuatkan sebelum menganggap ia diabaikan. Jalankan /context dan lihat senarai Memory files; fail yang tidak tersenarai di situ tidak dimuatkan semasa pelancaran. Fail arahan dihantar sebagai mesej pengguna selepas prompt sistem dan dianggap sebagai konteks, bukannya konfigurasi yang dikuatkuasakan, jadi tiada jaminan pematuhan yang ketat. Kebanyakan kes sebenar berpunca daripada salah satu daripada empat perkara: fail tersebut berada dalam subdirektori yang tidak pernah dibaca oleh ejen, dua fail bercanggah dan model memilih salah satu secara rawak, peraturan terlalu samar untuk menyemak sesuatu tindakan, atau kod di sekeliling menunjukkan perkara yang bertentangan dengan apa yang dinyatakan oleh peraturan tersebut.

Adakah menyunting fail arahan di pertengahan sesi mengubah apa-apa?

Tidak untuk salinan yang sudah ada dalam perbualan. Fail di atas direktori kerja anda dimuatkan sepenuhnya semasa pelancaran, jadi teks yang dipegang oleh model adalah teks dari masa pelancaran. Untuk mengambil suntingan, mulakan sesi baharu, atau minta ejen membaca fail tersebut dengan alat fail biasa, yang akan memasukkan versi semasa ke dalam perbualan sebagai mesej baharu. Selepas pemadatan (compaction), fail akar projek dibaca semula dari cakera, jadi versi baharu akan tiba pada ketika itu juga.

Fail mana yang menang apabila CLAUDE.md akar dan fail bersarang bercanggah?

Tiada satu pun yang boleh dipercayai. Fail yang ditemui akan digabungkan ke dalam konteks dan bukannya mengatasi satu sama lain, disusun dari akar sistem fail sehingga ke direktori kerja anda, jadi fail yang paling hampir hanya dibaca terakhir. Tiada enjin keutamaan yang menyelesaikan percanggahan, dan dokumentasi Claude Code menyatakan bahawa peraturan yang bercanggah mungkin diselesaikan secara rawak. Tulis fail bersarang sebagai tambahan yang menamakan laluan yang dikawalnya, dan padamkan percanggahan tersebut daripada cuba mengatasinya.

Adakah arahan saya kekal selepas /compact?

Ia bergantung kepada cara ia dimuatkan. CLAUDE.md akar projek, peraturan tanpa skop dan memori automatik disuntik semula dari cakera selepas pemadatan. Peraturan dengan frontmatter paths: dan fail CLAUDE.md bersarang dalam subdirektori akan hilang sehingga fail yang sepadan dibaca semula. Apa-apa sahaja yang anda taip ke dalam sembang hanya akan kekal jika penyimpul (summariser) kebetulan menyimpannya. Jika sesuatu peraturan mesti kekal sepanjang sesi, letakkannya dalam fail akar projek tanpa frontmatter paths:.

Bilakah peraturan harus menjadi hook dan bukannya prosa?

Apabila semakan adalah deterministik dan kos kegagalan adalah lebih tinggi daripada kos menulis skrip kecil. Sekatan laluan fail, arahan yang diperlukan sebelum commit, dan panggilan alat yang dilarang semuanya layak. Hook PreToolUse yang keluar dengan status 2 akan menyekat panggilan alat secara terus dan memberikan teks stderr anda kembali kepada model sebagai alasan, jadi ia kekal sama ada peraturan itu masih ada di mana-mana dalam konteks atau tidak. Apa-apa sahaja yang boleh diputuskan oleh pemformat atau linter harus dikendalikan oleh alat tersebut dan dipadamkan sepenuhnya daripada fail arahan.

Adakah artikel ini berguna?