AnswersPublished14 sources
Susun fail projek dengan kemas—tanpa mengorbankan bukti dan ketepatan
Jadikan direktori ujian berpusat sebagai pilihan utama, tetapi kekalkan ujian Go dalam pakej apabila perlu mengakses ahli yang tidak dieksport. Bezakan metodologi umum, panduan projek, spesifikasi semasa dan rekod keputusan seni bina (ADR).
Diterbitkan olehImej dijana dengan GPT Image 2
Research answer
Key takeaways
- Jadikan direktori ujian berpusat sebagai pilihan utama, tetapi kekalkan ujian Go dalam pakej apabila perlu mengakses ahli yang tidak dieksport.
- Bezakan metodologi umum, panduan projek, spesifikasi semasa dan rekod keputusan seni bina (ADR).
- Pelan yang dibekukan masih belum selesai; ia bukan pelan siap yang sudah diarkibkan.
- Bahan sementara boleh dibersihkan, tetapi jangan padam satu satunya bukti yang masih diperlukan.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/L2Q8zxg7UqZZOsMb8CmQKOfK9IR2/images/53D2DD20E6A8C8FDDC17/74C3321FB646B5554586.png)
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"这套布局可以作为收敛方向，但需要纠正三个等同关系：所有测试不能无条件迁出业务包，规范不是全部 ADR 的摘要，冻结也不是完成归档。以下是六项建议的明确边界；涉及的新路径均为候选，尚未创建或迁移。\n\n 1.. Topic tags: general web, openai, automation, workflow, code. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fake numbers, clickbait thumbnails, icons, a
Cadangan menyusun semula fail projek ini boleh menjadi asas yang baik, tetapi ada beberapa perkara yang tidak wajar disamakan: bukan semua ujian boleh dipindahkan keluar daripada pakej kod, spesifikasi bukan ringkasan bagi semua ADR, dan pelan yang dibekukan belum tentu selesai.
Berikut ialah enam panduan dengan batas yang lebih jelas. Semua laluan baharu yang disebut di bawah ialah cadangan sahaja—belum diwujudkan atau dipindahkan.
1. Utamakan direktori ujian berpusat, dengan pengecualian yang munasabah
Jadikan ujian berpusat sebagai amalan lalai, bukan janji bahawa setiap projek mesti mengosongkan direktori kod sumber daripada fail ujian.
- Projek Python: utamakan direktori
tests/. Semasa pemindahan, semak import, penemuan ujian, fixture dan CI. Repositori semasa sudah menggunakan laluan ujian berpusat dalam konfigurasi CI. - Projek Go: ujian white-box yang perlu mengakses ahli pakej yang tidak dieksport boleh kekal dalam direktori pakej yang diuji. Ujian black-box, antara komponen dan hujung ke hujung pula lebih sesuai dipusatkan. Go menyusun semula pakej bersama fail ujian, dan menyokong ujian dalam pakej yang sama atau pakej ujian luaran.
14
- Jangan kelirukan sempadan pakej dalaman dengan lokasi ujian. Had import bagi pakej
internalditentukan oleh hubungan laluan direktori; ia bukan bermaksud sesuatu pakej hanya boleh diimport daripada direktori yang sama. Akses kepada ahli yang tidak dieksport pula bergantung pada sempadan pakej.10
Oleh itu, jangan jadikan “semua ujian Go mesti dipindahkan keluar daripada direktori kod sambil mengekalkan ujian white-box dan enkapsulasi” sebagai syarat umum. Jangan eksport keadaan dalaman atau menyalin logik perniagaan semata-mata untuk menjadikan susunan direktori nampak lebih kemas.
Yang patut dielakkan ialah pecahan kerja yang tidak berfaedah dan pengesahan berulang—bukan fail ujian berasingan yang memang diperlukan. Ujian regresi yang perlu dijalankan semula wajar dikekalkan dalam kawalan versi; probe sekali guna lebih sesuai diletakkan dalam ruang sementara.
2. Metodologi, spesifikasi dan ADR menjalankan fungsi berbeza
Pemahaman bahawa peraturan umum berbeza daripada panduan khusus projek memang hampir tepat. Namun, specs/ tidak sepatutnya ditakrifkan sebagai tempat merangkum semua ADR.
| Lapisan | Soalan yang dijawab | Asas kandungan |
|---|---|---|
| Metodologi umum | Bagaimana hendak menganalisis, mengesahkan dan menyerahkan kerja? | Ditentukan oleh penyelenggara metodologi |
Pintu masuk projek AGENTS.md |
Bagaimana hendak bekerja dalam projek ini? | Kekangan projek yang disahkan dan panduan operasi |
Spesifikasi projek specs/ |
Tingkah laku dan kontrak apakah yang perlu dipenuhi sekarang? | Keperluan pengguna, keputusan yang diterima dan pindaan yang diluluskan |
Rekod keputusan docs/adr/ |
Mengapa sesuatu pendekatan dipilih? | Pertimbangan seni bina dan pilihan alternatif |
Dokumentasi rasmi Cline mengesahkan adanya mekanisme peraturan berterusan untuk menyimpan arahan merentas sesi.4 Namun, sumber yang tersedia di sini tidak membuktikan bahawa Cline secara natif akan menulis jenis fail tertentu ke direktori spesifikasi secara automatik. Anggaplah susunan itu sebagai konvensyen projek, bukannya fungsi Cline yang dijamin.
Kandungan projek juga tidak semestinya ditulis sepenuhnya secara manual atau hanya diwujudkan selepas tekanan dinamik timbul. Proses yang lebih terkawal ialah:
- Semasa projek dimulakan, pembantu boleh mencadangkan spesifikasi berdasarkan keperluan pengguna dan bukti dalam repositori; perkara yang belum diketahui hendaklah kekal ditandakan sebagai belum diketahui.
- Sebelum menjalankan tugasan, baca spesifikasi dan keputusan yang berkaitan, kemudian jelaskan kriteria penerimaan serta pengesahan untuk tugasan itu.
- Cadangkan ADR baharu hanya apabila terdapat pertukaran kepentingan baharu yang signifikan. Jika keputusan sedia ada masih terpakai, rujuk keputusan itu dan elakkan ADR berulang untuk setiap pelan.
- Hasil pengesahan boleh menunjukkan bahawa pelaksanaan memenuhi syarat atau mendedahkan kekurangan dalam spesifikasi. Hasil pelaksanaan tidak boleh menentukan keperluan secara automatik.
- Selepas keputusan diluluskan dan spesifikasi dikemas kini, catat kekangan semasa dalam spesifikasi yang berkenaan dan pautkan ADR berkaitan. Tidak perlu menyalin keseluruhan sejarah.
Ringkasnya: spesifikasi ialah kontrak semasa, ADR merekodkan asas keputusan, dan ujian ialah semakan yang boleh dilaksanakan. Ketiga-tiganya saling berkaitan tetapi tidak saling menggantikan. Penemuan khusus projek juga tidak patut dinaikkan menjadi peraturan umum tanpa semakan.
3. Selaraskan lokasi ADR, tetapi kekalkan dasar penerimaan
Boleh jadikan docs/adr/ lokasi lalai bagi keputusan baharu. Ini ialah konvensyen penamaan projek, bukan dakwaan bahawa itulah satu-satunya piawaian industri.
Kekalkan dasar berikut:
- Rekod yang dicadangkan, diterima, ditolak atau digantikan boleh disimpan—bukan rekod yang diterima sahaja.
- Gunakan semula keputusan yang masih terpakai; jangan cipta ADR baharu bagi keputusan yang sama.
- Apabila keputusan lama digantikan, catat hubungannya tanpa menulis semula alasan asal.
- Ujian yang lulus tidak dengan sendirinya bermakna ADR sudah mendapat kelulusan.
Pemindahan ADR juga perlu mengemas kini rujukan, laluan dan kekangan kebenaran yang benar-benar digunakan. Memindahkan fail sahaja tidak mencukupi.
4. Direktori pelan boleh kekal rata, tetapi pembekuan bukan penyiapan
Susun atur rata untuk plans/ boleh digunakan. Tidak perlu mewujudkan subdirektori semata-mata kerana terdapat beberapa pelan lama. Contoh penamaan di bawah ialah cadangan:
| Tujuan | Nama fail cadangan | Maksud |
|---|---|---|
| Pelan aktif | pending_implementation_plan.md |
Satu pintu masuk lalai bagi pelan yang sedang berjalan |
| Simpan selepas selesai | plan-20261022-example-id.md |
Pelan yang selesai dan mendapat kelulusan untuk diarkibkan |
| Bekukan kerja belum selesai | plan-20261022-example-id-frozen.md |
Kerja belum selesai yang dikeluarkan daripada laluan aktif |
Pembekuan tidak memerlukan direktori baharu atau status formal tambahan dengan segera. Validator semasa sudah menyokong status jeda; status itu boleh digunakan dahulu dengan mencatat sebab dijeda, perkara yang belum selesai dan syarat untuk menyambung semula.
Bezakan tiga keadaan ini:
- Diarkibkan sebagai selesai: semua kriteria penerimaan wajib lulus dan kebenaran untuk mengarkibkan telah diberikan.
- Dibekukan sebelum selesai: dikeluarkan daripada laluan aktif, tetapi tidak boleh dilabel selesai atau menukar cadangan yang belum disahkan menjadi fakta.
- Ditinggalkan dengan jelas: nyatakan bahawa kerja tidak akan diteruskan serta kesannya. Jangan gambarkan keputusan berhenti sebagai jeda sementara. Sebarang status rasmi baharu untuk penamatan perlu melalui pindaan kontrak berasingan.
Secara lalai, baca pintu masuk pelan aktif sahaja; jangan imbas setiap fail sejarah dalam direktori yang sama. Cari sejarah secara khusus apabila pengguna meminta pelan lama atau mahu menyambung kerja. Pelan beku yang hendak disambung perlu mendapat kebenaran baharu, dibuat sebagai salinan pelaksanaan baharu yang mengekalkan pautan kepada sumber asal, dan disahkan semula. Jangan anggap kelulusan lama masih terpakai. Ini selaras dengan peraturan kitar hayat semasa.
Selain itu, menamakan semula fail hanyalah tindakan menyimpan—bukan bukti bahawa kerja lulus penerimaan. Lindungi fail daripada ditindih, kekalkan perkara yang belum selesai dan kemas kini rujukan. Jangan paksa penciptaan templat pelan kosong hanya untuk mengekalkan satu laluan tetap.
5. Padankan ujian dengan kod melalui modul dan kontrak
Elakkan syarat “satu fail kod mesti mempunyai satu fail ujian”. Satu ujian boleh meliputi beberapa komponen, manakala satu komponen mungkin memerlukan ujian unit, ujian sifat dan ujian regresi integrasi.
Sebagai permulaan:
- Susun direktori
tests/mengikut modul atau tanggungjawab. - Dalam spesifikasi yang berkaitan, senaraikan invarian utama, titik masuk ujian dan arahan pengesahan yang skopnya jelas.
- Tambah satu fail pemetaan calon, seperti
tests/test-map.yaml, hanya jika hubungan antara laluan sukar dikenal pasti.
Jika diwujudkan, fail pemetaan itu patut merekodkan hubungan yang perlu sahaja: pengecam modul atau kontrak, skop kod sumber, skop ujian dan arahan pengesahan. Jangan salin keseluruhan struktur direktori atau pantulkan status lulus ujian di dalamnya.
Pastikan laluan dan arahan kekal sah. Kewujudan fail pemetaan tidak membuktikan liputan ujian mencukupi atau ujian berjaya. Dengan cara ini, usaha mengurangkan kekusutan fail tidak menghasilkan satu lagi senarai manual yang mudah lapuk.
6. Bersihkan draf dengan cermat; lokasi fail bukan ukuran kebolehpercayaan
Boleh kumpulkan draf sekali guna, skrip sementara dan laporan penerokaan dalam .scratch/. Namun, dua anggapan perlu dielakkan: bahawa semua kandungannya bukan maklumat sumber pertama, dan bahawa semuanya boleh dipadam pada bila-bila masa.
- Ringkasan penyelidikan yang dihasilkan model ialah tafsiran sekunder; ia tidak boleh dianggap sebagai fakta dengan sendirinya.
- Output ujian asal atau rekod diagnostik sebenar boleh menjadi bukti sumber pertama walaupun diletakkan dalam direktori sementara. Kebolehpercayaannya bergantung pada sumber, persekitaran, masa dan kelengkapannya.
- Jangan padam bukti unik yang masih dirujuk oleh pelan, keputusan atau kriteria penerimaan. Sebelum pembersihan, simpan salinan asal yang diperlukan atau tarik balik kesimpulan yang bergantung padanya dengan jelas.
- Penemuan penting yang diringkaskan perlu mengekalkan lokasi bukti, skop pemakaian dan perkara yang belum diketahui. Pemadatan tidak boleh menukar andaian menjadi fakta.
Bagi laporan lama dan rajah seni bina dalam docs/, bezakan antara “dokumen semasa”, “bahan sejarah yang masih jelas nilainya” dan “bahan yang belum disahkan”. Jangan anggap semua bahan lama sebagai sampah:
- Nyatakan skop pemakaian dokumen semasa dan semak semula apabila kontrak berkaitan berubah.
- Tandakan rajah atau pendekatan lama sebagai sejarah, lapuk atau telah digantikan; jangan gunakan secara lalai sebagai asas semasa.
- Bahan proses yang tidak lagi bernilai jangka panjang dan tidak mempunyai rujukan bergantung padanya boleh dipindahkan ke ruang sementara atau dipadam selepas mendapat kelulusan.
Menyimpan fail dan memuatkannya sebagai konteks lalai ialah dua perkara berbeza. Kekalkan sejarah yang masih diperlukan, tetapi tidak perlu membaca semuanya pada setiap sesi. Untuk mengurangkan gangguan konteks, utamakan bacaan terarah dan penandaan status kesahihan, bukannya memadam bukti.
Kesimpulan
Susun atur ini boleh diterima dengan empat batas utama: pusatkan ujian tetapi benarkan pengecualian mengikut bahasa; jadikan spesifikasi sebagai kontrak semasa, bukan himpunan semua ADR; kekalkan status belum selesai bagi pelan beku; dan jangan padam satu-satunya bukti yang masih diperlukan.
Laluan pelan lalai dan laluan yang dibenarkan dalam validator, serta skop suntingan mod analisis dalam tetapan mod tersuai, masih terikat pada susun atur lama. Sebarang migrasi kemudian perlu menyelaraskan peraturan, templat, rujukan, pengesahan dan penyesuaian persekitaran—bukan sekadar menukar nama direktori lalu mengisytiharkan perubahan berkuat kuasa. Analisis ini tidak menulis, memindahkan, membekukan atau membersihkan sebarang bahan projek.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Susun fail projek dengan kemas—tanpa mengorbankan bukti dan ketepatan"?
Jadikan direktori ujian berpusat sebagai pilihan utama, tetapi kekalkan ujian Go dalam pakej apabila perlu mengakses ahli yang tidak dieksport.
What are the key points to validate first?
Jadikan direktori ujian berpusat sebagai pilihan utama, tetapi kekalkan ujian Go dalam pakej apabila perlu mengakses ahli yang tidak dieksport. Bezakan metodologi umum, panduan projek, spesifikasi semasa dan rekod keputusan seni bina (ADR).
What should I do next in practice?
Pelan yang dibekukan masih belum selesai; ia bukan pelan siap yang sudah diarkibkan.