Skip to content
Back to search

MenulisCep4t

SkillWorks with Claude CodeGitHub

Engine dokumen akademik Indonesia untuk AI Agents: preset kampus (UI, ITB, UGM, ITS, UNPAD, UB, UNDIP, UNAIR, IPB, Telkom), build Typst+Pandoc, penyunting EYD V/KBBI, deteksi pola AI, cek rujukan OpenAlex/Crossref, MCP server. Gabungan dari github.com/muadzhdz/laporan-generator + github.com/nothinx/naskah-id + github.com/blader/humanizer (MIT).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/frchn-gstn--menuliscep4t/badge.svg)](/listings/frchn-gstn--menuliscep4t)

HTML

<a href="/listings/frchn-gstn--menuliscep4t"><img src="/api/listings/frchn-gstn--menuliscep4t/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "laporan-generator",
  3. "version": "3.0.0",
  4. "description": "Universal Academic Report & Thesis Generator for AI Agents",
  5. "author": {
  6. "name": "Mu'adz Hudzaifah",
  7. "email": "muadzhudzaifah511@gmail.com"
  8. },
  9. "homepage": "https://github.com/muadzhdz/laporan-generator",
  10. "repository": "https://github.com/muadzhdz/laporan-generator",
  11. "license": "MIT",
  12. "skills": [
  13. "./.agents/skills/laporan-generator"
  14. ]
  15. }
README.md · README · 479 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="Logo%20Menulis%20Cep4t.png" alt="Menulis Cep4t" width="180"/>
  3. </p>
  4. <h1 align="center">MenulisCep4t</h1>
  5. <p align="center">
  6. <b>Engine dokumen akademik + penyunting naskah Indonesia untuk AI Agents</b><br/>
  7. Otomatisasi dokumen akademik dan teknis dari Markdown ke PDF berstandar publikasi dan Microsoft Word (DOCX) dalam hitungan detik, lengkap dengan penyunting kaidah EYD V, pembuang pola tulisan AI, dan pemeriksa rujukan.<br/>
  8. Mendukung pedoman resmi format penulisan kampus Indonesia (UI, ITB, UGM, ITS, UNPAD, UB, UNDIP, UNAIR, IPB, Telkom University) dan standar internasional.
  9. </p>
  10. <p align="center">
  11. <a href="https://www.npmjs.com/package/laporan-generator"><img src="https://img.shields.io/npm/v/laporan-generator?style=for-the-badge&color=cb3837&logo=npm" alt="npm version"></a>
  12. <a href="#dukungan-model-context-protocol-mcp"><img src="https://img.shields.io/badge/MCP-Native%20Server-8A2BE2?style=for-the-badge&logo=anthropic" alt="MCP Server"></a>
  13. <a href="https://github.com/muadzhdz/laporan-generator/actions/workflows/build.yml"><img src="https://github.com/muadzhdz/laporan-generator/actions/workflows/build.yml/badge.svg" alt="Status Build"></a>
  14. <a href="#"><img src="https://img.shields.io/badge/Typst-0.13+-239DAD?style=for-the-badge&logo=typst&logoColor=white" alt="Typst"></a>
  15. <a href="#"><img src="https://img.shields.io/badge/Pandoc-3.0+-blue?style=for-the-badge&logo=markdown" alt="Pandoc"></a>
  16. <a href="#"><img src="https://img.shields.io/badge/Python-3.9+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python"></a>
  17. <a href="#"><img src="https://img.shields.io/badge/Tests-111%20Passed-success?style=for-the-badge" alt="Pengujian Lulus"></a>
  18. <a href="#"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="Lisensi"></a>
  19. </p>
  20. <p align="center">
  21. <a href="GETTING-STARTED.md">Panduan Cepat</a> &bull;
  22. <a href="docs/campus-guide.md">Panduan Preset Kampus</a> &bull;
  23. <a href="docs/syntax-cheatsheet.md">Cheatsheet Sintaks</a> &bull;
  24. <a href="docs/metadata-schema.md">Skema Metadata</a> &bull;
  25. <a href="docs/troubleshooting.md">Penyelesaian Masalah</a> &bull;
  26. <a href="CHANGELOG.md">Catatan Perubahan</a>
  27. </p>
  28. ---
  29. ## Tiga komponen dalam satu repo
  30. Repo ini adalah gabungan tiga proyek (semua MIT):
  31. | Komponen | Asal | Peran |
  32. | :--- | :--- | :--- |
  33. | **Engine dokumen & MCP** | [muadzhdz/laporan-generator](https://github.com/muadzhdz/laporan-generator) | Preset kampus, scaffolding, build Typst/Pandoc, CLI, MCP server |
  34. | **Penyunting naskah Indonesia** | [nothinx/naskah-id](https://github.com/nothinx/naskah-id) | Kaidah EYD V dan KBBI, kontrak kejujuran, `scripts/periksa.py`, `scripts/openalex.py`, `references/`, `contoh/`, `KONTRAK.md` |
  35. | **Pola tulisan AI** | [blader/humanizer](https://github.com/blader/humanizer) | 26 pola tulisan AI berbahasa Inggris di `references/pola-ai-inggris.md` |
  36. Alur kerja lengkapnya ada di `SKILL.md`: kenali sasaran → scaffolding → tulis/sunting per
  37. bab → periksa fakta → sitasi → audit dan build → serahkan. Skill terpasang ke seluruh agen
  38. lewat `npx laporan-generator sync-hosts`.
  39. Skill ini terikat `KONTRAK.md`: tidak mengarang data atau rujukan, tidak mengubah angka dan
  40. sitasi saat menyunting, menolak perjokian dan permintaan menyamarkan hasil AI dari detektor.
  41. Bukan alat lolos Turnitin atau detektor AI.
  42. ---
  43. ## Ikhtisar
  44. Laporan Generator adalah kompilator otomatisasi dokumen akademik berevolusi ganda (*dual-engine*) sekaligus kapabilitas terpadu untuk agen kecerdasan buatan (*AI Agent Skill*). Alat ini dirancang untuk menjembatani alur kerja rekayasa perangkat lunak modern dengan standar ketat format penulisan karya ilmiah perguruan tinggi.
  45. Penyusunan makalah, laporan magang/praktik kerja lapangan (PKL), laporan proyek, hingga skripsi dan tesis kerap menguras waktu akibat proses penataan format manual di pengolah kata seperti Microsoft Word. Laporan Generator menuntaskan permasalahan ini secara menyeluruh langsung dari berkas sumber Markdown modular, yang dapat dikompilasi secara paralel menjadi:
  46. 1. **PDF Kualitas Publikasi**: Tipografi presisi tinggi berbasis mesin typesetting modern Typst.
  47. 2. **Microsoft Word Standar (.docx)**: Dokumen murni berbasis OpenXML dengan penataan hierarki heading yang rapi, bidang dinamis Daftar Isi (*TOC Field Codes*), serta penomoran halaman ganda (Romawi kecil untuk bagian awal dan angka Arab untuk batang tubuh bab).
  48. Proyek ini juga memuat paket **AI Agent Skill** yang kompatibel dengan 10+ platform agen AI, memungkinkan agen cerdas menyusun draf, mengaudit sitasi, memindai pedoman kampus, dan membangun dokumen secara otonom.
  49. ---
  50. ## Sorotan Arsitektur
  51. ### Alur Kerja Pipeline Dual-Engine
  52. ```text
  53. [ Berkas Sumber Markdown ]
  54. ├── cover.md (Kata Pengantar & Lembar Depan)
  55. ├── chapters/bab*.md (BAB I s.d. BAB V)
  56. ├── metadata.yml (Preset Kampus, Penulis, Dosen, Lembar Pengesahan)
  57. └── references.bib (Basis Data Sitasi BibTeX)
  58. │
  59. ├──> [ Pipeline Mesin Typst ]
  60. │ ├── template.typ (Tata letak tipografi & margin dinamis)
  61. │ ├── ImageMagick (Normalisasi kanal alfa citra)
  62. │ └── typst compile ──> [ Laporan.pdf ]
  63. │
  64. └──> [ Pipeline Mesin Word/DOCX ]
  65. ├── Pandoc + docx.lua (Transformasi AST untuk heading BAB)
  66. ├── reference.docx (Gaya tipografi dasar TNR 12pt A4)
  67. ├── scripts/finalize-docx.py (Injeksi kode bidang TOC dinamis)
  68. └── scripts/docx-pagenum.py (Manipulasi OpenXML penomoran ganda) ──> [ Laporan.docx ]
  69. ```
  70. ### Fitur Rekayasa Unggulan
  71. * **Penomoran Halaman Ganda Otomatis**:
  72. * Bagian Awal (Kata Pengantar, Daftar Isi, Daftar Gambar/Tabel, Abstrak): Penomoran angka Romawi kecil di tengah bawah (`i, ii, iii...`), dengan nomor pada halaman cover disembunyikan secara otomatis.
  73. * Bagian Utama (BAB I hingga Penutup dan Daftar Pustaka): Penomoran angka Arab (`1, 2, 3...`) yang diatur ulang dimulai dari halaman 1.
  74. * **Daftar Isi Dinamis Microsoft Word Asli**:
  75. * Menggunakan kode bidang murni OpenXML (`w:fldSimple` / `w:instrText TOC \o "1-3" \h \z \u`).
  76. * Hierarki judul bab (`BAB I`, `1.1`, `1.1.1`) terdaftar dengan sempurna pada panel navigasi Word tanpa tumpang tindih teks atau kesalahan indentasi.
  77. * Kompatibel penuh dengan Microsoft Office 365, Word 2016-2021, LibreOffice Writer, dan WPS Office.
  78. * **Penomoran Otomatis Bab, Gambar, dan Tabel**:
  79. * Penomoran gambar, tabel, dan persamaan matematika secara otomatis mengikat pada indeks bab aktif (contoh: `Gambar 1.1`, `Tabel 2.3`, `Persamaan (3.1)`).
  80. * Variabel counter di-reset secara otomatis pada setiap batas pergantian bab.
  81. * **Keterampilan Agen AI Lintas Platform (Multi-Host AI Skill)**:
  82. * Terstruktur sesuai spesifikasi *Agent Skill Standard* lengkap dengan protokol wawancara interaktif 3 tahap di `SKILL.md`.
  83. * Dapat dideteksi dan dieksekusi langsung oleh Antigravity CLI, Claude Code, Grok, Codex/OpenAI, GitHub Copilot, Cursor, Roo-Code/Cline, OpenCode, dan Kiro-CLI.
  84. * **Peralatan Audit & Penjaminan Mutu**:
  85. * `doctor`: Audit integritas dokumen untuk mendeteksi sitasi rusak/yatim, gambar yang tidak ditemukan di disk, struktur heading yang salah, dan kesalahan skema metadata.
  86. * `stats`: Analisis komprehensif jumlah kata, karakter, perkiraan durasi membaca, estimasi total halaman, dan inventaris media.
  87. * `bundle`: Pengemasan arsip rilis zip yang bersih dari berkas sementara untuk pengumpulan ke institusi.
  88. * `preset scan`: Pemindai otomatis dokumen PDF pedoman kampus untuk mengekstrak margin dan gaya heading ke konfigurasi YAML baru.
  89. ---
  90. ## Dukungan Host AI Agent
  91. Laporan Generator mendistribusikan *skill* agen ke direktori global maupun lokal repositori:
  92. | Host AI Agent | Direktori Konfigurasi / Skill | Protokol Pemanggilan |
  93. |---|---|---|
  94. | **Antigravity CLI** | `~/.gemini/antigravity-cli/skills/laporan-generator` | Prompt interaktif / Slash command |
  95. | **Claude Code** | `~/.claude/skills/laporan-generator` | Slash command / Natural language |
  96. | **Grok** | `~/.grok/skills/laporan-generator` | Deteksi skill agen global |
  97. | **OpenCode** | `~/.config/opencode/skills/laporan-generator` | Tooling native agen |
  98. | **Kiro-CLI** | `~/.kiro/agents/laporan-generator.json` | Sub-agen kustom |
  99. | **Universal Agents** | `~/.agents/skills/laporan-generator` | Standar direktori `.agents/` |
  100. | **Cursor / Copilot** | `.github/copilot-instructions.md`, `.cursor/rules` | Konfigurasi aturan repo |
  101. Untuk menyinkronkan seluruh skill ke seluruh host yang terpasang di sistem dalam satu perintah:
  102. ```bash
  103. npx laporan-generator sync-hosts
  104. ```
  105. ---
  106. ## Dukungan Model Context Protocol (MCP)
  107. Laporan Generator v2.9.0 dilengkapi dengan **Native MCP Server** resmi yang berjalan melalui `stdio` berbasis protokol JSON-RPC 2.0 (spesifikasi 2024-11-05). Server ini memungkinkan AI Agent otonom (seperti Google Antigravity, Claude Desktop, Claude Code, dan OpenCode) untuk berinteraksi langsung dengan dokumen akademik melalui tools deterministik.
  108. ### Konfigurasi Otomatis (Direkomendasikan)
  109. Cukup jalankan satu perintah berikut untuk mendaftarkan skill sekaligus konfigurasi MCP Server ke seluruh agent di mesin Anda:
  110. ```bash
  111. npx laporan-generator sync-hosts
  112. ```
  113. Perintah di atas secara aman mendaftarkan server `laporan` tanpa merusak konfigurasi server lain yang sudah ada:
  114. * **Antigravity CLI**: `~/.gemini/config/mcp_config.json`
  115. * **Claude Desktop**: `~/.config/Claude/claude_desktop_config.json`
  116. * **Claude Code**: `~/.claude.json`
  117. * **OpenCode**: `~/.config/opencode/opencode.jsonc`
  118. ### Konfigurasi Manual
  119. Jika ingin mendaftarkan server secara manual pada klien MCP apa pun:
  120. ```json
  121. {
  122. "mcpServers": {
  123. "laporan": {
  124. "command": "npx",
  125. "args": ["-y", "laporan-generator", "mcp"]
  126. }
  127. }
  128. }
  129. ```
  130. ### 6 Native Tools MCP yang Disediakan
  131. | Tool Name | Deskripsi Fungsi | Parameter Utama |
  132. |---|---|---|
  133. | `laporan_init` | Menginisialisasi dokumen baru (skripsi/makalah) secara terprogram | `target_dir`, `preset`, `title`, `author_name`, `author_id`, `institution`, `faculty`, `department`, `year`, `daftar_gambar`, `daftar_tabel`, `force` |
  134. | `laporan_doctor` | Mengaudit integritas dependensi, berkas wajib, sitasi, dan broken media | `target_dir` |
  135. | `laporan_stats` | Menghitung statistik kata, bab, karakter, dan estimasi halaman | `target_dir` |
  136. | `laporan_presets` | Memeriksa daftar dan detail konfigurasi preset kampus resmi | `action` (`list` / `get`), `preset_name` |
  137. | `laporan_citations` | Memvalidasi integritas BibTeX dan pencarian sitasi langsung ke Crossref API | `action` (`search_doi` / `get_bibtex` / `add_citation` / `validate`), `query`, `doi`, `bibtex`, `target_dir` |
  138. | `laporan_build` | Mengompilasi dokumen ke PDF (Typst) dan/atau DOCX (Word) | `target_dir`, `format` (`all` / `pdf` / `docx`) |
  139. ---
  140. ## Alur Penggunaan Cepat
  141. ### Opsi A: Alur Otonom AI Agent via NPX (Direkomendasikan)
  142. Anda dapat membuat atau menginisialisasi dokumen baru di folder mana pun tanpa perlu melakukan kloning repositori:
  143. ```bash
  144. # 1. Daftarkan kapabilitas Laporan Generator ke seluruh agen AI Anda
  145. npx laporan-generator sync-hosts
  146. # 2. Pasang dependensi sistem yang diperlukan (Typst, Pandoc, ImageMagick)
  147. npx laporan-generator setup
  148. # 3. Inisialisasi struktur dokumen akademik lengkap di direktori saat ini
  149. npx laporan-generator init
  150. ```
  151. Setelah inisialisasi selesai, buka antarmuka obrolan AI Agent Anda (Antigravity CLI, Claude Code, atau OpenCode), lalu berikan instruksi:
  152. > *"Tolong buatkan draf Skripsi lengkap BAB 1 sampai BAB 3 dengan format ITB (preset itb-ta) berdasarkan topik sistem deteksi intrusi jaringan menggunakan eBPF."*
  153. Agen AI akan membaca `SKILL.md`, menjalankan protokol wawancara interaktif 3 tahap, menerapkan preset kampus, menyusun konten bab, memvalidasi sitasi pada `references.bib`, menjalankan audit kesehatan `doctor`, dan membangun dokumen PDF serta Word secara otomatis.
  154. ---
  155. ### Opsi B: Alur Baris Perintah (CLI) Mandiri / Manual
  156. Jika Anda ingin menulis dokumen secara manual dan mengompilasinya langsung via terminal:
  157. #### Linux / macOS:
  158. ```bash
  159. # Kloning repositori
  160. git clone https://github.com/muadzhdz/laporan-generator.git tugas-akhir
  161. cd tugas-akhir
  162. # Periksa kelengkapan dependensi dan integritas berkas
  163. ./laporan check
  164. # Bangun dokumen PDF dan DOCX
  165. ./laporan build
  166. # Buka dokumen PDF hasil kompilasi
  167. ./laporan view
  168. ```
  169. #### Windows (Native PowerShell 5.1+ / 7+ tanpa WSL):
  170. ```powershell
  171. # Kloning repositori
  172. git clone https://github.com/muadzhdz/laporan-generator.git tugas-akhir
  173. cd tugas-akhir
  174. # Periksa kelengkapan dependensi dan integritas berkas
  175. .\laporan.ps1 check
  176. # Bangun dokumen PDF dan DOCX
  177. .\laporan.ps1 build
  178. # Buka dokumen PDF hasil kompilasi
  179. .\laporan.ps1 view
  180. ```
  181. #### Lingkungan Nix Flake (Hermetik & Reproducible):
  182. ```bash
  183. # Masuk ke isolated devShell dengan versi toolchain identik
  184. nix develop
  185. # Kompilasi dokumen di dalam lingkungan devShell
  186. ./laporan build
  187. ```
  188. #### Lingkungan Docker (Tanpa Dependensi Sistem Host):
  189. ```bash
  190. docker compose run --rm laporan-generator
  191. ```
  192. ---
  193. ## Matriks Perintah CLI
  194. Seluruh perintah didukung secara konsisten di NPX, Linux/macOS Bash (`./laporan`), dan Windows PowerShell (`.\laporan.ps1`):
  195. | Perintah | NPX (`npx laporan-generator`) | Bash (`./laporan`) | PowerShell (`.\laporan.ps1`) | Keterangan Fungsi |
  196. |---|---|---|---|---|
  197. | `mcp` | Didukung | Didukung | Didukung | Menjalankan Model Context Protocol (MCP) Server untuk AI Agent |
  198. | `init` | Didukung | Didukung | Didukung | Menyalin template berkas, metadata, dan draf bab awal |
  199. | `sync-hosts` | Didukung | Didukung | Didukung | Memasang skill ke seluruh direktori agen AI yang terdeteksi |
  200. | `setup` | Didukung | Didukung | Didukung | Memasang paket sistem Typst, Pandoc, ImageMagick, dan Python |
  201. | `check` | Didukung | Didukung | Didukung | Memeriksa ketersediaan toolchain dan kelengkapan berkas |
  202. | `build` | Didukung | Didukung | Didukung | Mengompilasi berkas sumber menjadi `Laporan.pdf` dan `Laporan.docx` |
  203. | `stats` | Didukung | Didukung | Didukung | Menghitung jumlah kata, karakter, estimasi halaman, dan gambar |
  204. | `doctor` | Didukung | Didukung | Didukung | Melakukan audit integritas sitasi, gambar hilang, dan format heading |
  205. | `bundle` | Didukung | Didukung | Didukung | Mengemas proyek menjadi arsip ZIP rilis yang bersih |
  206. | `preset list` | Didukung | Didukung | Didukung | Menampilkan daftar seluruh preset format kampus resmi |
  207. | `preset apply <id>`| Didukung | Didukung | Didukung | Menerapkan konfigurasi preset kampus tertentu ke `metadata.yml` |
  208. | `preset scan <pdf>`| Didukung | Didukung | Didukung | Memindai berkas PDF pedoman kampus menjadi file preset YAML baru |
  209. | `view` | - | Didukung | Didukung | Membuka berkas `Laporan.pdf` pada PDF viewer bawaan sistem |
  210. | `watch` | - | Didukung | Didukung | Melakukan kompilasi ulang otomatis saat berkas sumber disimpan |
  211. | `clean` | - | Didukung | Didukung | Membersihkan berkas hasil build dan folder sementara |
  212. | `uninstall` | Didukung | Didukung | Didukung | Menghapus seluruh instalasi skill dari seluruh host agen AI |
  213. ---
  214. ## Preset Kampus Resmi
  215. Konfigurasi tata letak bawaan yang disesuaikan dengan pedoman penulisan resmi universitas di Indonesia:
  216. | ID Preset | Institusi / Standar | Batas Margin (Atas-Bawah-Kiri-Kanan) | Tipografi | Gaya Judul Bab | Keterangan Khusus |
  217. |---|---|---|---|---|---|
  218. | `standard` | Standar Akademik Umum | 2.0cm - 3.0cm - 2.5cm - 2.5cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Format standar makalah, proyek, dan magang |
  219. | `skripsi-4433` | Standar Skripsi Nasional | 4.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Standar jilid hardcover dengan margin kiri 4cm |
  220. | `ui-skripsi` | Universitas Indonesia (UI) | 3.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Sesuai Keputusan Rektor & Pedoman Teknis TA UI |
  221. | `itb-ta` | Institut Teknologi Bandung (ITB) | 4.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Cover minimalis tanpa dosen pembimbing luar |
  222. | `ugm-skripsi` | Universitas Gadjah Mada (UGM) | 4.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Format resmi pedoman tugas akhir & tesis UGM |
  223. | `its-skripsi` | Institut Teknologi Sepuluh Nopember (ITS) | 3.0cm - 2.5cm - 3.0cm - 2.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Format baku buku Tugas Akhir ITS |
  224. | `unpad-skripsi` | Universitas Padjadjaran (UNPAD) | 4.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Format penulisan skripsi & karya ilmiah UNPAD |
  225. | `ub-skripsi` | Universitas Brawijaya (UB) | 4.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Pedoman penulisan skripsi Universitas Brawijaya |
  226. | `undip-skripsi` | Universitas Diponegoro (UNDIP) | 4.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Pedoman akademik skripsi Universitas Diponegoro |
  227. | `unair-skripsi` | Universitas Airlangga (UNAIR) | 4.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Pedoman penulisan karya ilmiah UNAIR |
  228. | `ipb-ppki` | IPB University (PPKI) | 3.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Pedoman PPKI IPB (Indent 1cm, sub-bab tanpa titik akhir) |
  229. | `telkom-ta` | Telkom University (Tel-U) | 3.0cm - 3.0cm - 4.0cm - 3.0cm | Libertinus / TNR, 12pt | `BAB I` (Tengah) | Pedoman Buku Tugas Akhir Telkom University |
  230. ### Cara Mengaktifkan Preset
  231. ```bash
  232. ./laporan preset apply itb-ta
  233. # atau
  234. npx laporan-generator preset apply itb-ta
  235. ```
  236. ### Memindai Pedoman PDF Kampus Lain
  237. Apabila universitas Anda belum terdaftar di atas, jalankan pemindai dokumen:
  238. ```bash
  239. ./laporan preset scan /path/ke/pedoman-skripsi.pdf
  240. ```
  241. Pemindai akan menganalisis parameter margin, ukuran font, dan penomoran bab dari teks dokumen pedoman, lalu menghasilkan berkas preset berekstensi `.yml` yang siap digunakan di direktori `presets/`.
  242. ---
  243. ## Konfigurasi Dokumen (`metadata.yml`)
  244. Seluruh struktur dokumen, judul, informasi kepenulisan, tanda tangan lembar pengesahan, dan abstrak bilingual dikendalikan terpusat melalui `metadata.yml`:
  245. ```yaml
  246. title: "Analisis dan Implementasi Sistem Deteksi Intrusi Jaringan Berbasis eBPF"
  247. subtitle: "Skripsi Sarjana"
  248. preset: "itb-ta"
  249. # Kontrol Struktur Halaman Depan (Opt-In)
  250. # Default struktur bersih: Cover -> Kata Pengantar -> Daftar Isi -> Batang Tubuh -> Daftar Pustaka
  251. daftar_gambar: false # Ubah true jika dokumen memuat gambar dan membutuhkan DAFTAR GAMBAR
  252. daftar_tabel: false # Ubah true jika dokumen memuat tabel dan membutuhkan DAFTAR TABEL
  253. author:
  254. - name: "Mu'adz Hudzaifah"
  255. nim: "13522001"
  256. institution: "Institut Teknologi Bandung"
  257. faculty: "Sekolah Teknik Elektro dan Informatika"
  258. department: "Teknik Informatika"
  259. city: "Bandung"
  260. year: "2026"
  261. date: "14 September 2026"
  262. course: "Tugas Akhir II"
  263. lecturer: "Dr. Ir. Pembimbing Utama, M.T."
  264. # Lembar Pengesahan
  265. approval:
  266. city: "Bandung"
  267. date: "14 September 2026"
  268. supervisors:
  269. - name: "Dr. Ir. Pembimbing Utama, M.T."
  270. nip: "197501012000031001"
  271. role: "Pembimbing I"
  272. - name: "Dr. Eng. Pembimbing Pendamping, S.T."
  273. nip: "198002022005011002"
  274. role: "Pembimbing II"
  275. dean:
  276. name: "Prof. Dr. Dekan Fakultas, M.Sc."
  277. nip: "196803031992031003"
  278. role: "Dekan STEI"
  279. # Abstrak Bahasa Indonesia
  280. abstract_id: >
  281. Deteksi intrusi jaringan konvensional seringkali menimbulkan overhead performa yang signifikan...
  282. keywords_id: ["eBPF", "Deteksi Intrusi", "Linux Kernel", "Keamanan Jaringan"]
  283. # Abstrak Bahasa Inggris
  284. abstract_en: >
  285. Conventional network intrusion detection systems frequently introduce notable performance overhead...
  286. keywords_en: ["eBPF", "Intrusion Detection", "Linux Kernel", "Network Security"]
  287. ```
  288. > ⚠️ **SEMUA DATA DI ATAS ADALAH CONTOH ILUSTRATIF (DUMMY)** — Nama, NIM, NIP, judul, abstrak, dosen pembimbing, dan institusi **bukan data nyata**. Anda **wajib mengganti** seluruh field di `metadata.yml` dengan data Anda sendiri sebelum kompilasi. Repo ini tidak menyimpan data pribadi mahasiswa, dosen, atau skripsi asli.
  289. ---
  290. ## Struktur Direktori
  291. ```text
  292. laporan-generator/
  293. ├── bin/
  294. │ └── laporan-generator.js # Router CLI global untuk Node.js / NPX
  295. ├── lib/
  296. │ ├── init.js # Modul inisialisasi dokumen baru
  297. │ ├── setup.js # Wrapper instalasi dependensi sistem
  298. │ ├── sync-hosts.js # Distributor skill agen AI multi-host
  299. │ └── uninstall.js # Pembersih skill agen AI dari sistem
  300. ├── .agents/
  301. │ ├── skills/laporan-generator/ # Standar Universal Agent Skill
  302. │ │ ├── SKILL.md # Instruksi dan protokol wawancara agen AI
  303. │ │ ├── agents/ # Skema konfigurasi spesifik agen
  304. │ │ ├── references/ # Rujukan skema YAML dan panduan teknis
  305. │ │ ├── resources/ # Salinan berkas template dan utilitas
  306. │ │ └── scripts/ # Skrip bantu audit dan kalkulasi dokumen
  307. │ └── workflows/
  308. │ └── laporan-generator.md # Definisi perintah alur kerja slash command
  309. ├── chapters/
  310. │ ├── bab1-pendahuluan.md # Latar belakang, rumusan masalah, dan tujuan
  311. │ ├── bab2-tinjauan-pustaka.md # Landasan teori dan kajian literatur
  312. │ ├── bab3-metodologi.md # Desain arsitektur dan metodologi riset
  313. │ ├── bab4-hasil-dan-pembahasan.md # Implementasi, pengujian, dan pembahasan
  314. │ └── bab5-penutup.md # Kesimpulan dan saran pengembangan
  315. ├── docs/ # Dokumentasi teknis terperinci
  316. ├── presets/ # Koleksi preset format resmi universitas
  317. ├── scripts/
  318. │ ├── finalize-docx.py # Injeksi kode bidang TOC murni pada Word
  319. │ ├── docx-pagenum.py # Penerapan sistem nomor halaman ganda Word
  320. │ ├── make-reference-docx.py # Pembangun berkas gaya reference.docx
  321. │ ├── report-doctor.py # Pemeriksa kesehatan & integritas berkas
  322. │ ├── report-stats.py # Kalkulator statistik kata dan halaman
  323. │ ├── bundle.py # Utilitas pengemasan berkas rilis
  324. │ ├── scan-preset.py # Pemindai otomatis PDF pedoman kampus
  325. │ ├── validate-preset.py # Validator skema berkas preset YAML
  326. │ ├── setup-deps.sh # Skrip instalasi dependensi Unix
  327. │ └── setup-deps.ps1 # Skrip instalasi dependensi PowerShell Windows
  328. ├── apa.csl # Format sitasi dan daftar pustaka standar APA 7th
  329. ├── build.sh # Skrip kompilasi utama Linux/macOS
  330. ├── build-docx.sh # Skrip kompilasi khusus dokumen Word
  331. ├── cover.md # Kata Pengantar dan halaman depan
  332. ├── docx.lua # Filter Pandoc Lua untuk transformasi AST Word
  333. ├── flake.nix # Konfigurasi lingkungan kerja Nix reproducible
  334. ├── laporan # Wrapper CLI interaktif Bash
  335. ├── laporan.ps1 # Wrapper CLI native PowerShell Windows
  336. ├── Makefile # Target otomatisasi pengembang
  337. ├── metadata.yml # Konfigurasi aktif berkas dokumen
  338. ├── reference.docx # Dokumen template acuan gaya Microsoft Word
  339. ├── references.bib # Basis data pustaka format BibTeX
  340. ├── template.typ # Mesin typesetting dan tata letak Typst
  341. └── test.sh # Rangkaian pengujian otomatis (101 assertions)
  342. ```
  343. ---
  344. ## Penjaminan Mutu & Pengujian
  345. Laporan Generator dilengkapi rangkaian pengujian otomatis (*automated test suite*) yang memvalidasi pipeline Unix dan Windows, filter Lua, skrip manipulasi OpenXML, validasi preset, serta fungsionalitas CLI:
  346. ```bash
  347. # Menjalankan pengujian
  348. ./test.sh
  349. # atau
  350. npm test
  351. ```
  352. ### Cakupan Pengujian (24 Test Suite / 101 Assertions)
  353. * **Integritas Berkas**: Memverifikasi keberadaan seluruh template utama, skrip, dan skema acuan.
  354. * **Pipeline Typst**: Memvalidasi rendering ukuran font, margin dinamis, logika penomoran bab, dan reset counter gambar/tabel.
  355. * **Pipeline DOCX**: Memvalidasi transformasi AST Pandoc, filter Lua, field codes TOC OpenXML, dan nomor halaman ganda.
  356. * **Validasi Preset**: Menguji seluruh preset bawaan terhadap skema spesifikasi YAML.
  357. * **Perintah CLI**: Memverifikasi alur eksekusi `init`, `check`, `build`, `stats`, `doctor`, `bundle`, `preset`, dan `uninstall`.
  358. * **Kebersihan & Keamanan**: Memastikan tidak ada berkas sampah biner, cache Python (`.pyc`), atau berkas temporer yang tertinggal.
  359. ---
  360. ## Pusat Dokumentasi
  361. * **[Panduan Pemula (Zero to PDF)](GETTING-STARTED.md)**: Panduan langkah demi langkah dari instalasi hingga kompilasi pertama.
  362. * **[Panduan Preset Kampus](docs/campus-guide.md)**: Rincian margin, tipografi, dan format penulisan antar universitas.
  363. * **[Cheatsheet Sintaks Markdown](docs/syntax-cheatsheet.md)**: Panduan lengkap penulisan sitasi, rumus matematika, tabel, dan gambar.
  364. * **[Skema Metadata](docs/metadata-schema.md)**: Referensi lengkap seluruh parameter pada `metadata.yml`.
  365. * **[Skema Preset](docs/preset-schema.md)**: Spesifikasi format untuk membuat preset kampus baru.
  366. * **[Panduan Template Typst](docs/template-guide.md)**: Arsitektur tipografi, font Libertinus Serif, dan aturan halaman.
  367. * **[Penyelesaian Masalah (Troubleshooting)](docs/troubleshooting.md)**: Panduan penanganan kendala umum dependensi, font, dan izin sistem.
  368. * **[Panduan Kontribusi](CONTRIBUTING.md)**: Pedoman pengembangan fitur baru dan penambahan preset.
  369. * **[Catatan Perubahan (Changelog)](CHANGELOG.md)**: Riwayat pembaruan dan rilis versi.
  370. ---
  371. ## Lisensi
  372. Didistribusikan di bawah lisensi MIT. Silakan baca berkas [LICENSE](LICENSE) untuk informasi lebih lanjut.
  373. ---
  374. ## Terima Kasih
  375. Terima kasih telah menggunakan **MenulisCep4t**. Proyek ini dibangun di atas kerja keras komunitas open source:
  376. - [muadzhdz/laporan-generator](https://github.com/muadzhdz/laporan-generator) — engine dokumen, preset kampus, MCP
  377. - [nothinx/naskah-id](https://github.com/nothinx/naskah-id) — kaidah EYD V/KBBI, kontrak kejujuran, OpenAlex
  378. - [blader/humanizer](https://github.com/blader/humanizer) — 26 pola AI writing (Wikipedia-based)
  379. Semua lisensi **MIT**. Bebas dipakai, dimodifikasi, dan didistribusikan ulang.
  380. Jika proyek ini membantu Anda, ⭐ star repo ini agar lebih banyak orang menemukannya.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.