Mx
Blog
Published on

Meningkatkan Kualitas Dokumentasi Teknik melalui Penulisan Artikel yang Sistematis

Authors

Meningkatkan Kualitas Dokumentasi Teknik melalui Penulisan Artikel yang Sistematis

1. Pengantar

Dalam industri teknik seperti petrokimia, minyak dan gas, EPC (Engineering, Procurement, and Construction), dan manufaktur berat, kemampuan menulis artikel teknis adalah keahlian penting yang menunjang komunikasi, dokumentasi, dan pengambilan keputusan berbasis data dan standar. Namun, menulis artikel teknis tidak hanya sekadar menyusun kata-kata—tetapi harus memenuhi kaidah rekayasa: akurat, dapat diverifikasi, dan sesuai standar internasional.

Di era AI dan otomatisasi, prompt engineering dapat dimanfaatkan untuk mempercepat proses penyusunan draf teknis. Namun, kendali kualitas tetap berada pada insinyur atau technical writer yang memahami isi teknis dan standar yang berlaku.

2. Karakteristik Artikel Teknis/Engineering

Artikel teknis yang baik harus memiliki:

  • Struktur yang logis dan sistematis
  • Isi berbasis data atau standar teknik (API, ASME, IEC, ISO, NFPA, dsb.)
  • Kejelasan metodologi dan hasil analisa
  • Referensi teknis resmi atau literatur profesional
  • Bahasa formal dan profesional dengan terminologi teknik

3. Teknik Menulis Artikel Teknik yang Efektif

  • ✅ Langkah-Langkah:
  1. Pilih topik yang spesifik dan aplikatif: contoh, analisa vibrasi, RCM strategy, atau thermal degradation pada motor LV.
  2. Tentukan tujuan penulisan: apakah ingin menjelaskan, mengevaluasi, atau merekomendasikan.
  3. Identifikasi standar teknik yang relevan.
  4. Kumpulkan data lapangan, hasil pengujian, atau referensi literatur teknik.
  5. Gunakan format penulisan profesional: sistematis, tidak opini, dan berbasis fakta/data.

4. Template Penulisan Artikel Teknik

  • 🔹 Versi Lengkap (Untuk Publikasi Teknis, Laporan Engineering):

Judul Teknis yang Spesifik

1. Ringkasan Eksekutif (jika diperlukan)

2. Latar Belakang

3. Tujuan Penulisan

4. Landasan Teori dan Standar Teknik

5. Metodologi / Analisa Teknik

6. Studi Kasus / Data Lapangan

7. Analisa dan Diskusi

8. Kesimpulan

9. Rekomendasi Teknik

10. Referensi Teknik

11. Lampiran Teknis (jika ada)

Contoh Referensi Teknik:

  • API 610 – Centrifugal Pumps for Petroleum, 11th Ed.
  • ISO 10816-3:2009 – Mechanical Vibration Evaluation.
  • 🔹 Versi Ringkas (Untuk Buletin, Laporan Pendek, atau Web):

Judul Teknis

1. Latar Belakang Singkat (2–3 kalimat)

2. Tujuan Teknik

3. Metode dan Standar (singkat)

4. Temuan Utama (bullet point)

5. Rekomendasi Teknik

6. Referensi (2–3 saja)

7. Penutup / Ringkasan 1 paragraf

Contoh Judul: > “Evaluasi Awal Getaran Tinggi Pompa API 610 Unit Urea – Pendekatan ISO 10816”

5. Penggunaan Prompt Engineering dalam Penulisan Teknik

Prompt engineering adalah teknik menyusun instruksi atau perintah spesifik untuk model AI seperti GPT agar menghasilkan keluaran teks yang akurat, terstruktur, dan relevan dengan konteks teknik. Dalam penulisan teknis, teknik ini dapat dimanfaatkan untuk mempercepat penyusunan:

  • Kerangka artikel teknik
  • Deskripsi sistem atau metode kerja
  • Analisa kegagalan peralatan
  • Studi kasus dan lesson learned
  • Draft awal dokumen teknik formal seperti TQ, NCR, RFI, ITP, MoM, dan report summary.

  • Contoh Prompt Engineering Berdasarkan Kebutuhan Teknis

  • 🔧 1. Artikel dan Laporan Teknik

“Tuliskan artikel teknis tentang penerapan IEC 61511 pada sistem SIS (Safety Instrumented System) di pabrik petrokimia, dengan struktur artikel mencakup fungsi, arsitektur, SIL rating, dan implementasi lapangan.”

“Buat artikel tentang strategi condition-based maintenance untuk motor induksi 11 kV, mengacu pada standar IEEE 841 dan IEC 60034-1.”

  • ⚙️ 2. Analisa Peralatan dan Studi Kasus

“Jelaskan mode kegagalan umum pada mechanical seal tipe cartridge yang digunakan dalam pompa proses API 610, serta metode inspeksi dan perbaikannya.”

“Tulis studi kasus kegagalan kompresor reciprocating API 618 akibat liquid slugging, serta langkah mitigasi desain dan operasional.”

  • 🧾 3. Dokumen Teknik Formal (TQ, NCR, RFI, MoM)

“Buatkan draf Technical Query (TQ) untuk meminta klarifikasi tentang ketidaksesuaian NDE method pada weld joint nozzle-vessel, antara drawing dan ITP.”

“Susun RFI untuk permintaan drawing koordinasi antara ducting HVAC dan cable tray pada ruang MCC, dengan referensi layout.”

“Buat draf NCR untuk kabel yang dipasang tidak sesuai routing yang disetujui, melanggar jarak minimal terhadap pipa bertekanan, sesuai IEC 60364.”

  • 🛡️ 4. Dokumentasi Safety dan Compliance

“Tuliskan artikel pendek tentang pentingnya Job Safety Analysis (JSA) dalam aktivitas Turn Around, dengan format: pengantar, struktur JSA, studi kasus, dan rekomendasi.”

“Buat kerangka laporan insiden arc flash pada panel 6.6 kV, disertai referensi standar NFPA 70E dan evaluasi PPE yang digunakan.”

  • 🖥️ 5. Automasi dan Instrumentasi

“Jelaskan arsitektur komunikasi Profibus dan Profinet dalam sistem DCS Siemens PCS 7, serta kelebihan dan keterbatasannya di lingkungan petrokimia.”

“Tuliskan artikel teknis tentang kalibrasi transmitter tekanan dengan HART protocol, mencakup tahapan, peralatan, dan referensi standar ISA.”

  • ✅ Tips Optimalisasi Prompt Teknik

  • Sebutkan standar teknik yang relevan (API, IEC, ISO, NFPA, IEEE).

  • Tentukan peran dan audiens (misalnya: untuk insinyur pemeliharaan, QA/QC, atau manajemen).

  • Gunakan istilah teknis dan sistem/prosedur aktual (misal: FFT, SIL, DCS, SIS, HAZOP, ITP).

  • Jelaskan format atau struktur hasil yang diharapkan (artikel, poin-poin, diagram, dll).

6. Mengenal Dokumen Teknis Pendukung (TQ, NCR, RFI, MoM)

Berikut penjelasan lengkap tentang dokumen teknik formal yang sering digunakan dalam proyek industri (terutama EPC, konstruksi, dan operasi fasilitas petrokimia), disertai definisi, tujuan, serta contoh prompt yang lebih variatif dan realistis untuk masing-masing jenis dokumen:

🔷 1. TQ – Technical Query / Technical Clarification

  • Definisi:

Dokumen formal yang digunakan untuk meminta klarifikasi teknis dari pihak pemilik proyek (owner), engineer, atau consultant terhadap spesifikasi, gambar, dokumen teknis, atau instruksi kerja yang ambigu, tidak lengkap, atau kontradiktif.

  • Tujuan:
  • Menyelaraskan interpretasi teknis.
  • Menghindari pekerjaan yang tidak sesuai spesifikasi.
  • Memastikan kesesuaian dengan standar (API, ASME, IEC, dll).
  • Contoh Prompt Variatif:

“Buatkan draf TQ terkait perbedaan spesifikasi material gasket antara datasheet (Spiral Wound) dan vendor drawing (Ring Type Joint) untuk koneksi class 300# pada pipa 8”.”

“Susun TQ untuk klarifikasi posisi instrument tapping point yang tidak sesuai dengan standard height pada vessel V-201, dengan referensi ke P&ID dan standar API 550.”

🔷 2. NCR – Non-Conformance Report

  • Definisi:

Dokumen resmi yang digunakan untuk mencatat penyimpangan pekerjaan/material terhadap standar, gambar teknik, prosedur, atau spesifikasi kontrak.

  • Tujuan:
  • Mendokumentasikan ketidaksesuaian (non-conformance).
  • Menilai dampak teknis terhadap sistem.
  • Menentukan tindakan korektif atau preventif (repair, replace, accept with deviation).
  • Contoh Prompt Variatif:

“Buatkan draf NCR untuk pekerjaan pengecatan struktur baja pipe rack yang tidak sesuai dengan DFT (dry film thickness) minimum 80 µm berdasarkan SSPC SP-10.”

“Susun NCR atas temuan bahwa baut anchor baseplate pump tidak ditanam sesuai layout civil drawing, menyebabkan misalignment ±15 mm dari centerline.”

“Buatkan NCR terkait pengelasan tidak menggunakan WPS yang disetujui (WPS-11A), ditemukan saat audit dokumentasi QC.”

🔷 3. RFI – Request for Information

  • Definisi:

Permintaan informasi teknis maupun administratif tambahan, biasanya digunakan saat informasi yang dibutuhkan belum tersedia, tidak lengkap, atau terjadi gap antar-disiplin.

  • Tujuan:
  • Mendapatkan data tambahan yang dibutuhkan untuk melanjutkan pekerjaan.
  • Meminta dokumen atau drawing terbaru.
  • Menjembatani komunikasi lintas disiplin (civil, mechanical, E&I).
  • Contoh Prompt Variatif:

“Susun RFI untuk permintaan detail layout jalur grounding system di area bundwall tank farm yang tidak tercantum dalam IFC drawing.”

“Buatkan RFI untuk meminta dokumen approved vendor drawing untuk panel HVAC unit AHU-01, sebagai referensi fabrikasi kabel tray.”

“Tulis RFI untuk mengonfirmasi lokasi manhole tambahan pada jalur underground cabling area substation SSB-01.”

🔷 4. MoM – Minutes of Meeting

  • Definisi:

Dokumen ringkasan hasil rapat teknis atau koordinasi proyek yang mencatat diskusi, keputusan, dan action items yang disepakati.

  • Tujuan:
  • Mendokumentasikan hasil keputusan dan tanggung jawab.
  • Menjadi referensi formal tindak lanjut teknis.
  • Memastikan jejak komunikasi dan akuntabilitas.
  • Contoh Prompt Variatif:

“Buatkan draft MoM untuk rapat koordinasi antara tim QA/QC dan vendor terkait temuan radiografi welding joint yang gagal memenuhi acceptance criteria ASME IX.”

“Susun MoM hasil kick-off meeting pelaksanaan pre-commissioning sistem ESD, melibatkan tim commissioning, instrument, dan main contractor.”

“Tulis MoM rapat evaluasi hasil hydrotest line UREA-05, mencakup tekanan uji, hasil pengujian, dan rekomendasi perbaikan minor leak.”

7. Langkah-Langkah Menulis Artikel Teknis Efektif dengan Prompt Engineering

Penulisan artikel teknis dalam dunia rekayasa memerlukan pendekatan yang tidak hanya terstruktur tetapi juga berbasis pada akurasi, relevansi standar, dan kebutuhan spesifik industri. Di era digital saat ini, prompt engineering menjadi alat bantu yang semakin vital untuk mempercepat proses penulisan teknis, termasuk dalam menyusun kerangka artikel, menghasilkan narasi teknis, atau merancang draf dokumen formal. Namun, penggunaan AI dalam konteks teknik tetap harus dikendalikan oleh penulis yang memahami isi substansi dan standar yang berlaku.

Berikut ini disajikan panduan teknis dan mendalam tentang bagaimana menyusun prompt secara efektif untuk menghasilkan artikel teknik berkualitas tinggi, akurat, dan profesional. Panduan ini dirancang khusus untuk insinyur, technical writer, dan profesional industri yang ingin menggabungkan kecanggihan AI dengan disiplin penulisan teknik.

  • a. Tentukan Konteks Teknik dan Tujuan Secara Spesifik

Gunakan prompt yang menjelaskan aspek teknis artikel secara jelas: jenis peralatan, standar yang digunakan, lokasi aplikasi (misal: “di unit reformer plant”), serta siapa target pembacanya (engineer, manajer, auditor).

✅ Contoh: “Tuliskan artikel teknis tentang penerapan API 682 dalam pemilihan mechanical seal pada pompa sentrifugal di unit HCU, untuk pembaca level engineer.”

  • b. Gunakan Instruksi Bertahap

Pecah instruksi ke dalam tahap logis: mulai dari kerangka artikel, lalu minta AI mengembangkan masing-masing subjudul. Ini menjaga struktur dan memudahkan pengendalian isi.

✅ Contoh Tahapan: 1) Buatkan kerangka → 2) Kembangkan subjudul “Failure Mode” → 3) Tambahkan referensi standar.

  • c. Tentukan Format Hasil yang Diinginkan

Sebutkan apakah Anda ingin hasil dalam bentuk:

  • Artikel paragraf formal
  • Bullet-point
  • Format laporan teknis
  • Tabel perbandingan atau diagram alir

✅ Contoh: “Buatkan penjelasan teknis dalam format paragraf, maksimum 150 kata per bagian, tanpa bullet.”

  • d. Tentukan Perspektif Penulisan

Berikan peran pada AI agar menyesuaikan gaya teknis: misalnya sebagai maintenance engineer, QA/QC manager, atau commissioning specialist. Ini akan memengaruhi fokus dan terminologi yang digunakan.

✅ Contoh: “Tuliskan dari sudut pandang QA/QC yang mengawasi instalasi instrumen pada area E&I di proyek Turn Around.”

  • e. Berikan Contoh Output yang Diinginkan

Jika memungkinkan, berikan satu paragraf contoh atau gaya tulisan yang diharapkan. Ini membantu AI menyesuaikan tone, struktur, dan tingkat kedalaman teknis.

✅ Contoh: “Gaya teknis padat dan berbasis data, seperti artikel dalam Mechanical Engineering Journal atau API Technical Bulletin.”

  • f. Gunakan Kata Kunci Teknik Spesifik

Sertakan terminologi standar industri atau teknologi aktual, misalnya: RCM, FFT analysis, NPSH, SIL rating, SCADA, IEC 61850, dsb. Ini memastikan keluaran lebih akurat dan bernuansa teknik.

✅ Contoh: “Gunakan kata kunci: ‘failure detection’, ‘API 610’, ‘vibration signature’, dan ‘condition monitoring’.”

  • g. Eksplorasi Variasi Prompt untuk Cek Konsistensi

Gunakan prompt berbeda untuk topik yang sama dari sudut pandang berbeda atau format berbeda. Ini bisa membantu membandingkan keluaran dan memilih versi terbaik.

✅ Contoh:

  • Prompt A: Buat artikel naratif dari pengalaman insinyur.
  • Prompt B: Buat artikel dalam format studi kasus dan data.
  • h. Tegaskan Batasan dan Fokus

Jika ada ruang lingkup khusus (misal: hanya pompa API 610 OH2), atau hal yang harus dihindari (jangan bahas biaya atau vendor), nyatakan dengan tegas dalam prompt.

✅ Contoh: “Fokuskan artikel pada kerusakan bearing dan unbalance saja, tanpa membahas peralatan selain pompa sentrifugal.”

  • i. Lakukan Iterasi dan Refinement

Hasil awal mungkin belum sempurna. Evaluasi, revisi prompt, atau tambahkan instruksi tambahan. Bisa juga menggunakan hasil awal sebagai draft kasar yang kemudian dimurnikan secara manual oleh engineer.

✅ Contoh Iterasi:

  • Prompt 1: Hasil terlalu umum → Tambah spesifikasi lokasi dan data teknis.
  • Prompt 2: Hasil terlalu panjang → Tambah batasan jumlah kata per bagian.

Catatan Penyusunan Artikel ini disusun sebagai materi edukasi dan referensi umum berdasarkan berbagai sumber pustaka, praktik lapangan, serta bantuan alat penulisan. Pembaca disarankan untuk melakukan verifikasi lanjutan dan penyesuaian sesuai dengan kondisi serta kebutuhan masing-masing sistem.