Unit 7 / 11

Ralat Penulisan dan Pengutamaan Laporan: Jelas, Rekod Boleh Dihasilkan dengan AI

Keuntungan:

  • Keupayaan untuk mengubah pemerhatian bertaburan menjadi laporan yang mengandungi tajuk yang jelas, langkah-langkah pembiakan yang menentukan, keputusan yang dijangka/sebenar dan bukti dengan sokongan kecerdasan buatan
  • Mampu mengenakan peraturan 'hanya gunakan maklumat yang saya berikan, jangan buat-buat' kepada kecerdasan buatan dan menjamin kebolehulangan dengan kawalannya sendiri
  • Mampu membezakan antara keterukan (impak teknikal) dan keutamaan (kedekatan perniagaan) dan memberikan label akhir dengan konteks perniagaan

Pepijat yang ditemui penguji hanya bernilai jika ia diperbaiki; Membetulkannya sebahagian besarnya bergantung pada kualiti laporan pepijat—rekod yang mendokumentasikan kecacatan dengan cara pembangun boleh memahami, menghasilkan semula dan membetulkannya. Laporan pepijat yang ditulis dengan buruk ("log masuk tidak berfungsi") akan menghentikan pembangun selama berjam-jam, membawa kepada surat-menyurat berulang-alik dan selalunya ditutup sebagai "tidak boleh menghasilkan semula". Laporan yang baik termasuk langkah-langkah yang jelas, keputusan yang dijangka dan sebenar, maklumat konteks dan bukti. Kecerdasan buatan (AI) sangat baik untuk mengubah pemerhatian anda yang bertaburan menjadi laporan profesional dan berstruktur. Tetapi kaveat utama terpakai di sini juga: AI tidak boleh membuat langkah yang anda tidak nampak; boleh mengisi maklumat yang hilang dengan tekaan "nampak munasabah" tetapi tidak tepat. Tugas anda adalah untuk memastikan bahawa setiap baris laporan adalah berdasarkan perkara yang anda perhatikan sebenarnya.

Anatomi laporan pepijat yang baik

Laporan yang berkesan termasuk komponen ini:

  • Tajuk: Pendek, khusus, boleh dicari. Bukan "Terdapat ralat"; "Tidak dapat mengklik butang 'Checkout' dengan lebih daripada 10 item dalam troli (Chrome)".
  • Langkah untuk menghasilkan semula: Bernombor, boleh dikesan dari awal, deterministik. Pembangun sepatutnya dapat melihat ralat selepas mengikuti langkah ini.
  • Hasil yang dijangkakan: Apa yang sepatutnya berlaku mengikut kriteria penerimaan.
  • Keputusan sebenar: Perkara yang berlaku (mesej ralat, skrin, tingkah laku).
  • Persekitaran: Penyemak imbas/peranti, versi, persekitaran (ujian/langsung), peranan pengguna, data.
  • Bukti: Tangkapan skrin, video, log, jejak ralat (jejak tindanan).
  • Keterukan dan keutamaan: Terperinci di bawah.
Petua: Sebelum menghantar laporan, tanya "jika saya memberikan langkah ini kepada orang lain, bolehkah mereka melihat ralat tanpa bantuan saya?" bertanya. Jika jawapannya "tidak", laporan itu tidak lengkap. AI boleh menjadikan laporan itu cantik, tetapi hanya anda yang boleh menjamin kebolehulangan.

Keganasan dan keutamaan: dua konsep yang keliru

Keterukan ialah kesan teknikal ralat: adakah sistem ranap, data hilang, atau salah taip? Keutamaan ialah seberapa segera ia perlu diperbaiki; adalah mengenai kesan perniagaan. Kedua-duanya tidak selalu menuju ke arah yang sama: salah mengeja nama syarikat di halaman utama ialah keterukan rendah tetapi keutamaan tinggi (reputasi). Dalam kes kelebihan yang jarang berlaku, keruntuhan mungkin mempunyai keterukan yang tinggi tetapi keutamaannya rendah. AI membantu anda membuat perbezaan ini apabila anda memberikan pemerhatian; tetapi label akhir diberikan oleh anda yang mengetahui konteks perniagaan.

keganasan

contoh

keutamaan

contoh

Kritikal (Penyekat)

Pembayaran tidak dapat diselesaikan

Segera (P1)

Kehilangan pendapatan secara langsung

Tinggi (Major)

Laporan memberikan jumlah yang salah

Tinggi (P2)

Satu kemestian untuk keluaran akan datang

Sederhana (Minor)

Rare case tepi yang jarang berlaku

Sederhana (P3)

Dalam larian pecut yang dirancang

Rendah (Remeh)

Penjajaran butang dimatikan

Rendah (P4)

Bila ada peluang

Gesaan lemah / Gesaan kuat

Lemah: "Laporkan ralat ini: pembayaran tidak berfungsi."
Kuat: "Terjemahkan pemerhatian saya di bawah ke dalam format laporan pepijat standard: tajuk, langkah pembiakan (bernombor), hasil yang dijangka, hasil sebenar, persekitaran, keterukan dan pengesyoran keutamaan (dijustifikasikan). Gunakan hanya maklumat yang saya berikan; jadikan mana-mana medan yang hilang, tandakan 'MAKLUMAT HILANG: ...'. Pemerhatian: Chrome 120, persekitaran ujian, '12 item tidak berlaku dalam troli, 'tidak berlaku apa-apa', 'tidak berlaku apa-apa' ralat fungsi dalam konsol, Tiada masalah dengan 11 produk."

Gesaan yang kuat; mengenakan format, peraturan "kesesuaian", dan penandaan maklumat yang hilang. Dengan cara ini, laporan akan tepat dan jujur.

Pengesanan ralat pendua

Dalam pasukan besar, ralat yang sama dilaporkan berulang kali. AI boleh membandingkan laporan baharu anda dengan pepijat terbuka sedia ada dan membenderakan kemungkinan pendua — ini memastikan sistem penjejakan pepijat anda (Jira, Azure DevOps, Isu GitHub) bersih. Tetapi berhati-hati: dua ralat yang kelihatan serupa di permukaan mungkin mempunyai punca yang berbeza; Bandingkan langkah pengeluaran berulang dan persekitaran kedua-dua laporan sebelum menutup cadangan "pendua" AI. "Pendua" yang ditutup secara tidak sengaja sebenarnya tiada ralat berasingan.

Daripada kesan pepijat kepada punca punca: Kuasa AI untuk membaca log

Bahagian paling teknikal dalam laporan pepijat selalunya ialah jejak pepijat (jejak tindanan — pecahan baris kod yang mana dengan rantai panggilan, mencetuskan pepijat). Log panjang dan kompleks boleh memenatkan walaupun pemaju. AI membaca log beratus-ratus baris dan meringkaskan dalam beberapa saat baris yang paling kritikal, kemungkinan hipotesis punca punca, dan titik kod di mana ralat itu dicetuskan. Ini memendekkan laporan dan memberikan pembangun titik permulaan langsung.

Ingat dua had, walaupun. Pertama, punca yang diberikan oleh AI adalah hipotesis, bukan bukti; Pembangun tidak seharusnya cuba membetulkannya tanpa mengesahkannya. Kedua, log selalunya mengandungi data peribadi (e-mel, ID pengguna, token sesi); Tutup kawasan ini sebelum meletakkan log pada kenderaan. Amalan yang baik adalah terlebih dahulu meminta AI mengatakan "senarai medan yang perlu ditutup dalam log ini" dan kemudian menganalisis log yang dibersihkan.

Petua: Daripada menampal keseluruhan log ke dalam laporan, masukkan 3-5 baris paling kritikal yang diringkaskan AI dan pautan ke log penuh. Dengan cara ini laporan kekal boleh dibaca dan pembangun yang memerlukan butiran boleh mengakses log penuh.

Empat templat yang boleh disalin

1) Dari pemerhatian kepada laporan:

Peranan anda: QA kanan. Terjemahkan pemerhatian mentah berikut ke dalam laporan pepijat standard: Tajuk / Langkah pengeluaran semula (bernombor) / Dijangka / Sebenar / Persekitaran / Nota bukti / Keterukan + Keutamaan (justified). PERATURAN: gunakan hanya maklumat yang saya berikan; tandakan medan yang hilang sebagai "MAKLUMAT HILANG:..." Pemerhatian: [nota mentah]

2) Kawalan kebolehulangan:

Baca laporan pepijat ini dari perspektif pembangun yang tidak pernah melihat pepijat. Ikut langkah dan tandai tempat yang tidak akan menghasilkan pepijat: langkah samar-samar, tiada prasyarat, tiada data ujian, keadaan langkau. Beritahu saya maklumat yang perlu saya tambah untuk setiap jurang. Laporan: [tampal laporan]

3) Penasihat keterukan/keutamaan:

Saya menerangkan ralat berikut: [ralat + konteks perniagaan]. Beri cadangan dan justifikasi secara berasingan untuk keterukan (impak teknikal) dan keutamaan (kepentingan perniagaan). Terangkan mengapa kedua-duanya mungkin berbeza. Saya akan membuat keputusan muktamad.

4) Ringkasan surih log/ralat:

Periksa jejak/log ralat di bawah. Beri saya ringkasan (1) hipotesis punca punca, (2) titik kod yang mungkin berlaku di mana ralat berlaku, (3) 3 baris paling kritikal untuk ditambahkan pada laporan. Topeng jika ada data peribadi. Log: [tampal log]

tiga kes mini

Kes 1 — Pembebasan daripada "I Couldn't Produce." Dalam satu pasukan, 30% pepijat telah ditutup sebagai "tidak boleh menghasilkan semula". Templat "semakan kebolehulangan" telah ditambahkan pada proses laporan; Sebelum setiap laporan dihantar, AI menandakan langkah dan prasyarat yang hilang. Tiga bulan kemudian, kadar "tidak dapat menghasilkan" turun daripada 30% kepada 8%. Perbezaannya ialah langkah-langkahnya tepat dari awal.

Kes 2 — Bahaya langkah palsu. Seorang penguji menyuruh AI menulis laporan dengan pemerhatian yang tidak lengkap; AI menambah langkah yang tidak pernah berlaku, seperti "pengguna menghidupkan pemberitahuan daripada halaman tetapan". Apabila pembangun mengikuti langkah itu, dia tidak dapat mencari ralat dan kehilangan masa. Pasukan itu menguatkuasakan peraturan "gunakan maklumat yang saya berikan sahaja, jangan buat-buat"; Langkah-langkah yang dibuat-buat dihapuskan.

Kes 3 — Perbezaan keterukan/keutamaan. Terdapat kesilapan taip dalam slogan syarikat di halaman utama. Penguji akan menyatakan ini sebagai "rendah"; Perunding AI mengingatkan bahawa keganasan teknikal adalah rendah tetapi keutamaan perniagaan adalah tinggi (elemen reputasi yang diterima oleh setiap pelawat). Pepijat telah dibetulkan pada hari yang sama dengan teg "keutamaan tinggi".

Kesilapan biasa

  • Tajuk yang samar-samar. Tajuk berita yang tidak boleh dicari dan tidak mendiskriminasi seperti "Tidak berfungsi".
  • Langkah tertinggal/langkau. Tidak menulis apa yang jelas dalam konteks anda; kegagalan pemaju untuk menghasilkan.
  • Membiarkan AI menciptanya. Mempunyai maklumat yang hilang diisi dengan "anggaran yang munasabah"; langkah yang salah.
  • Tidak menulis hasil yang diharapkan. Berkata "salah" tetapi tidak menyatakan apa yang betul.
  • Keganasan dan keutamaan yang mengelirukan. Menganggap kedua-duanya sebagai satu label; Salah menilai kesan perniagaan.
  • Data sensitif dalam bukti. Berkongsi data peribadi sebenar dalam tangkapan skrin/log tanpa menyembunyikannya.

Secara ringkasnya

Nilai laporan pepijat ialah pembangun boleh menghasilkan semula dan membetulkan pepijat tanpa bantuan anda. AI sangat baik dalam mengubah pemerhatian yang bertaburan menjadi laporan profesional dan berstruktur; Ia mengatur tajuk, langkah, hasil yang dijangka/sebenar, persekitaran dan bukti, dan menyediakan perundingan tentang perbezaan antara keterukan dan keutamaan. Tetapi AI boleh menggantikan maklumat yang hilang; Kuatkuasakan peraturan "hanya gunakan maklumat yang saya berikan, tandai hilang" dan jamin kebolehulangan sendiri. Topeng data peribadi sebagai bukti.

Tugasan permohonan

Ambil pepijat yang anda temui baru-baru ini dan ubah pemerhatian mentah anda menjadi laporan menggunakan corak "pemerhatian untuk melaporkan" (dengan peraturan "kesesuaian"). Kemudian lakukan "semakan kebolehulangan" dan isikan jurang yang ditanda. Berikan laporan kepada rakan sekerja dan lihat sama ada dia boleh menghasilkan ralat tanpa bantuan anda. Akhir sekali, tentukan label dengan "perunding keganasan/keutamaan" dan akhirinya mengikut budi bicara anda sendiri. Ambil perhatian tentang sebarang maklumat yang cuba dibuat oleh AI dalam proses itu.

senarai semak

  • [ ] Tajuk saya adalah khusus dan boleh dicari.
  • [ ] Langkah-langkah pembiakan adalah dari awal, deterministik dan lengkap.
  • [ ] Saya menulis keputusan yang dijangka dan sebenar secara berasingan.
  • [ ] Maklumat penetapan dan bukti lengkap; Saya menyembunyikan data peribadi.
  • [ ] Saya mengenakan peraturan "make it up, mark the missing" pada AI dan mengisi kekosongan itu sendiri.
  • [ ] Saya menilai tahap keterukan dan keutamaan secara berasingan dan membuat keputusan muktamad.