humanizer-id 2.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,22 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Hafizh Muzani
4
+ Copyright (c) 2025 Siqi Chen (adapted editorial patterns)
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining a copy
7
+ of this software and associated documentation files (the "Software"), to deal
8
+ in the Software without restriction, including without limitation the rights
9
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the Software is
11
+ furnished to do so, subject to the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be included in all
14
+ copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
+ SOFTWARE.
@@ -0,0 +1,266 @@
1
+ Metadata-Version: 2.4
2
+ Name: humanizer-id
3
+ Version: 2.3.0
4
+ Summary: Indonesian academic writing editorial engine: 592 prescriptive rules to remove AI-sounding cliches, machine-translation calques, and nonstandard forms
5
+ Author: Hafizh Muzani
6
+ License-Expression: MIT
7
+ Keywords: bahasa-indonesia,editorial,style-checker,academic-writing,nlp,lint
8
+ Classifier: Development Status :: 5 - Production/Stable
9
+ Classifier: Environment :: Console
10
+ Classifier: Intended Audience :: Education
11
+ Classifier: Intended Audience :: Science/Research
12
+ Classifier: Natural Language :: Indonesian
13
+ Classifier: Operating System :: OS Independent
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.10
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Topic :: Text Processing :: Linguistic
19
+ Requires-Python: >=3.10
20
+ Description-Content-Type: text/markdown
21
+ License-File: LICENSE
22
+ Dynamic: license-file
23
+
24
+ <div align="center">
25
+
26
+ # Humanizer ID
27
+
28
+ **Panduan penyuntingan bahasa Indonesia akademik & profesional untuk agen AI**
29
+
30
+ <code>pip install humanizer-id</code>
31
+
32
+ [Instalasi](#instalasi) · [Arsitektur](#arsitektur-skill) · [Mode Kerja](#mode-kerja) · [Sebelum & Sesudah](#sebelum--sesudah) · [Cheat Sheet](#lembar-sontekan-diksi--kalke) · [FAQ](#faq)
33
+
34
+ [![CI](https://github.com/apissaj/humanizer-id/actions/workflows/ci.yml/badge.svg)](https://github.com/apissaj/humanizer-id/actions/workflows/ci.yml)
35
+ [![PyPI](https://img.shields.io/badge/PyPI-humanizer--id-3775A9?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/humanizer-id/)
36
+ [![Release](https://img.shields.io/github/v/release/apissaj/humanizer-id?style=flat-square)](https://github.com/apissaj/humanizer-id/releases)
37
+ [![License: MIT](https://img.shields.io/badge/license-MIT-f4c430?style=flat-square)](LICENSE)
38
+
39
+ </div>
40
+
41
+ ---
42
+
43
+ **Humanizer ID** adalah buku aturan yang dibaca agen AI setiap sesi penyuntingan naskah Indonesia. Ia membersihkan kalke terjemahan mesin, nominalisasi bertumpuk, verba ringan, fragmentasi kalimat, dan pola khas keluaran LLM — lalu berhenti di situ: bukan filter gaya, tapi filter slop dengan 592 kaidah preskriptif bersumber dokumen resmi lengkap nomor halaman. Satu induk + lima sub-kaidah dimuat sesuai kebutuhan naskah, plus mesin audit deterministik ber-CLI. Integritas ilmiah mengikat: nol fabrikasi data, dan ini **bukan** alat bypass detektor AI.
44
+
45
+ ## Sebelum & Sesudah
46
+
47
+ Contoh penyuntingan abstrak penelitian teknik (studi kasus lengkap di [examples/](examples/)):
48
+
49
+ | **Sebelum: draf mentah AI** | **Sesudah: Humanizer ID** |
50
+ |:--|:--|
51
+ | *Di era digital saat ini, optimasi basis data merupakan hal yang sangat krusial. Dalam penelitian ini melakukan analisis terhadap performa indeks B-Tree yang mengalami peningkatan kecepatan sebesar 35%. Meskipun cepat, bukan berarti indeks ini tanpa cela. Tulisan ini membahas bagaimana implementasi partisi tabel memberikan pengaruh terhadap throughput transaksi yang mana sangat penting untuk sistem.* | *Optimasi basis data menjadi penentu efisiensi sistem berskala besar. Penelitian ini menganalisis performa indeks B-Tree yang mencatatkan peningkatan kecepatan hingga 35%. Kendati demikian, karakteristik beban kerja tetap memunculkan tantangan komputasi tersendiri. Pada penelitian ini dibahas implementasi partisi tabel untuk meningkatkan throughput transaksi secara berkelanjutan.* |
52
+
53
+ Yang dibersihkan: nominalisasi bertumpuk (*melakukan analisis terhadap*), kalimat tanpa subjek (*Dalam penelitian ini melakukan*), penyangkalan antisipatif (*Meskipun cepat, bukan berarti*), pronomina relatif salah (*yang mana*), personifikasi dokumen (*Tulisan ini membahas*).
54
+
55
+ ## Mengapa Naskah AI Bahasa Indonesia Terasa Kaku?
56
+
57
+ Kekakuan jarang disebabkan kesalahan tata bahasa. Penyebab utamanya:
58
+
59
+ 1. **Nominalisasi menumpuk & verba ringan** — *melakukan pengujian terhadap* alih-alih *menguji*.
60
+ 2. **Kalke (*calque*) terjemahan mesin** — model berpikir dalam Inggris lalu menerjemahkan klausa demi klausa (*respecting boundaries* menjadi *menghormati batas*).
61
+ 3. **Penyangkalan antisipatif** — *Meskipun X, bukan berarti Y...* yang menyangkal hal yang tak ditanyakan pembaca.
62
+ 4. **Fragmentasi kalimat monoton** — kalimat pendek satu klausa berderet patah-patah (*staccato*).
63
+ 5. **Monotoni pembuka antar-paragraf** — *Selain itu,... Lebih lanjut,... Oleh karena itu,...* berulang di tiap paragraf.
64
+ 6. **Transisi kopong** — *Dengan demikian, hal ini membuktikan...* tanpa premis data yang cukup.
65
+
66
+ ## Arsitektur Skill
67
+
68
+ Sejak v2.1.0 panduan editorial dipecah agar hemat konteks agen: induk dimuat dulu, sub-kaidah hanya yang relevan dengan naskah.
69
+
70
+ | Skill | Cakupan | Muat untuk |
71
+ |-------|---------|------------|
72
+ | **`SKILL.md`** (induk) | Aturan integritas ilmiah, pengecualian dokumen, 4 mode eksekusi, eliminasi penyakit AI leksikal, tabel rute, Delivery Gate | Semua naskah. Selalu dimuat |
73
+ | [skills/humanizer-id-sintaksis](skills/humanizer-id-sintaksis/SKILL.md) | 21 blok: kesejajaran, korelatif, kalimat efektif, morfofonemik verba | Naskah berkalimat cacat |
74
+ | [skills/humanizer-id-wacana-retorika](skills/humanizer-id-wacana-retorika/SKILL.md) | 18 blok: kohesi paragraf, sitasi terajut, hedging epistemik | Naskah alur lemah |
75
+ | [skills/humanizer-id-ejaan-morfologi](skills/humanizer-id-ejaan-morfologi/SKILL.md) | 17 blok: EYD V, PUEBI, peluluhan fonem, gabungan kata | Naskah ejaan/imbuhan |
76
+ | [skills/humanizer-id-diksi-istilah](skills/humanizer-id-diksi-istilah/SKILL.md) | 13 blok: pilihan kata, peristilahan PUPI, padanan lintas bidang | Naskah istilah teknis |
77
+ | [skills/humanizer-id-naskah-resmi](skills/humanizer-id-naskah-resmi/SKILL.md) | 6 blok: bahasa pewara, surat dinas, metadata jurnal | Naskah resmi/dinas |
78
+ | [jurnal/](jurnal/SKILL.md) | Modul jurnal bereputasi: IMRaD, checklist 28 poin, template abstrak/cover letter | Naskah Scopus/SINTA |
79
+
80
+ Arsip provenance sesi bedah tersimpan di [references/log-integrasi-kaidah.md](references/log-integrasi-kaidah.md) (bukan aturan operasional). Setiap entri kaidah berformat **Pola → Perbaikan → Sebab** dengan sitasi halaman sumber.
81
+
82
+ ## Mode Kerja
83
+
84
+ Humanizer ID berjalan dua cara:
85
+
86
+ - **During** — membimbing penyuntingan selagi naskah dikerjakan, ditutup laporan Delivery Gate (PASS/FAIL).
87
+ - **After** — mengaudit naskah yang sudah ada: daftar temuan bernomor, kamu setujui nomor mana yang dieksekusi, lalu laporan susulan.
88
+
89
+ ```bash
90
+ # Audit bernomor tanpa menyunting naskah
91
+ python scripts/audit.py naskah.md --report
92
+ ```
93
+
94
+ Laporan tersimpan di `humanizer/audit-001-YYYY-MM-DD.md` (nomor naik otomatis, tak pernah menimpa). Tiap temuan memuat prioritas **HIGH** (kalke/verba ringan/klise AI), **MEDIUM** (istilah tak baku), **LOW** (gaya/domain), kutipan, saran, dan catatan kaidah.
95
+
96
+ ## Instalasi
97
+
98
+ ### Paket Python (PyPI)
99
+
100
+ ```bash
101
+ pip install humanizer-id
102
+ ```
103
+
104
+ ```bash
105
+ # Audit naskah langsung
106
+ humanizer-id naskah.md
107
+
108
+ # Perbaikan otomatis (autofix) leksikal deterministik
109
+ humanizer-id naskah.md --fix # ke layar
110
+ humanizer-id naskah.md --fix --write # in-place ke berkas asli
111
+
112
+ # Preset domain spesifik
113
+ humanizer-id naskah.md --preset akademik
114
+ humanizer-id surat.md --preset dinas
115
+
116
+ # Teks demo bawaan
117
+ humanizer-id --demo
118
+ ```
119
+
120
+ Sebagai modul Python:
121
+
122
+ ```python
123
+ from humanizer_id.audit import load_default_data, audit_text
124
+
125
+ kalke, glos = load_default_data()
126
+ findings = audit_text("Naskah yang ingin diperiksa...", kalke, glos)
127
+ for f in findings:
128
+ print(f["id"], "-", f["pola"])
129
+ ```
130
+
131
+ ### AI Coding Agents
132
+
133
+ #### Hermes Agent
134
+
135
+ ```bash
136
+ mkdir -p ~/.hermes/skills/creative/humanizer-id
137
+ git clone https://github.com/apissaj/humanizer-id.git /tmp/humanizer-id
138
+ cp /tmp/humanizer-id/SKILL.md ~/.hermes/skills/creative/humanizer-id/
139
+ cp -r /tmp/humanizer-id/skills/ ~/.hermes/skills/creative/humanizer-id/skills/
140
+ cp -r /tmp/humanizer-id/scripts/ /tmp/humanizer-id/humanizer_id/ /tmp/humanizer-id/data/ ~/.hermes/skills/creative/humanizer-id/ # agar mode AFTER (--report) jalan
141
+ ```
142
+
143
+ #### Claude Code
144
+
145
+ ```bash
146
+ git clone https://github.com/apissaj/humanizer-id.git ~/.claude/skills/humanizer-id
147
+ ```
148
+
149
+ #### Google Antigravity
150
+
151
+ ```bash
152
+ # Global
153
+ git clone https://github.com/apissaj/humanizer-id.git ~/.gemini/config/skills/humanizer-id
154
+
155
+ # Per-project workspace
156
+ git clone https://github.com/apissaj/humanizer-id.git .agents/skills/humanizer-id
157
+ ```
158
+
159
+ ### Antarmuka Web (ChatGPT, Claude, Gemini)
160
+
161
+ Tanpa coding agent: salin [PROMPT.md](PROMPT.md) ke Custom Instructions (ChatGPT) atau Project System Prompt (Claude). Untuk skripsi & jurnal ilmiah (SINTA/Scopus), pakai [PROMPT-AKADEMIK.md](PROMPT-AKADEMIK.md) agar tone padat leksikal, berstruktur hipotaktis, dan impersonal murni.
162
+
163
+ ### CLI Auditor Mandiri
164
+
165
+ Tanpa dependensi eksternal (100% pustaka standar Python):
166
+
167
+ ```bash
168
+ python scripts/audit.py --demo
169
+ python scripts/audit.py path/ke/naskah.md
170
+ python scripts/audit.py naskah.md --preset akademik
171
+ ```
172
+
173
+ ## Sumber Resmi
174
+
175
+ Seluruh kaidah **bukan karangan bebas** — setiap aturan ditelusuri dari dokumen resmi dengan nomor halaman, tersimpan penuh di [references/](references/):
176
+
177
+ | Sumber | Kontribusi |
178
+ |--------|-----------|
179
+ | *Cerdas Cergas Berbahasa dan Bersastra Indonesia* Kelas XI & XII (Kemendikbudristek, 2024) | Ragam ilmiah denotatif-objektif, kalimat efektif, kaidah surat resmi (hlm. 210-215, 29-34) |
180
+ | *Bahasa Indonesia untuk Perguruan Tinggi* (Suyatno dkk., UIN Jakarta, 2017) | Enam syarat keefektifan kalimat akademik (hlm. 100-107) |
181
+ | *Tata Bahasa Baku Bahasa Indonesia* Edisi IV (Alwi dkk.) | Kesejajaran predikat, korelatif, pronomina, pelesapan konstituen |
182
+ | EYD Edisi V (SK No. 0424/I/BS.00.01/2022) & PUEBI | Peluluhan KTSP, bentuk terikat, gabungan kata |
183
+ | *Tata Istilah* (Pusat Bahasa 1978; Qodratillah 2019) | Paradigma imbuhan peristilahan, PUPI, padanan lintas bidang |
184
+ | *Bentuk dan Pilihan Kata* (Mustakim 2014, 2019) | Anti-pleonasme, diksi preskriptif, pembedaan dll./dsb./dst. |
185
+ | Seri Penyuluhan Badan Bahasa: *Kalimat*, *Paragraf* (2019) | Struktur kalimat efektif, kohesi paragraf |
186
+ | *Bahasa Indonesia untuk Pejabat Pemerintah* (Mullyana 2019); *Pedoman Surat-Menyurat* (1991) | Naskah dinas & surat resmi |
187
+ | *Bahasa Indonesia untuk Pewara* (Kurniawan dkk. 2019) | Naskah acara & penyapaan formal |
188
+ | Jurnal kebahasaan (Widyaparwa 2020, Genre UAD 2021, JPLED Unimal 2024, Ar-Rumman 2024) | Pleonasme skripsi, kontaminasi kuantor, korelatif takbaku |
189
+ | Kobak et al., *Science Advances* (2025, DOI: 10.1126/sciadv.adt3813) | Bukti frekuensi kalke verba AI: delve 28x, underscore 13,8x, showcase 10,7x |
190
+
191
+ Dataset terbuka di [data/](data/):
192
+
193
+ - [data/kalke-indonesia.json](data/kalke-indonesia.json) - 592 entri leksikon kalke, verba ringan, pola antisipatif AI, kaidah morfologi EYD V.
194
+ - [data/glosarium-lintas-bidang.json](data/glosarium-lintas-bidang.json) - 137 padanan istilah baku (Teknologi 59, Bisnis 44, Linguistik 17, Hukum 10, Jurnalistik 7).
195
+ - [data/pedoman-kampus.json](data/pedoman-kampus.json) - preset 16 perguruan tinggi + jurnal dikbud.
196
+
197
+ ## Preset Kampus
198
+
199
+ Konvensi tugas akhir/skripsi spesifik (panduan lengkap: [references/panduan-preset-kampus.md](references/panduan-preset-kampus.md)). Cara pakai: sebutkan nama kampus saat memberi naskah, misalnya *Sunting abstrak skripsi ini dengan preset ugm*.
200
+
201
+ | Preset | Perguruan Tinggi | Sitasi Bawaan | Kaidah Khusus |
202
+ |--------|------------------|---------------|---------------|
203
+ | `ui` | Universitas Indonesia | APA / IEEE | Abstrak dwibahasa; penomoran tabel per bab (Tabel 1.1) |
204
+ | `itb` | Institut Teknologi Bandung | IEEE / Harvard | Rujukan persamaan (1.1); sampul minimalis |
205
+ | `ugm` | Universitas Gadjah Mada | IEEE / APA | Format Persamaan (nomor); Simpulan vs Saran terpisah tegas |
206
+ | `its` | Institut Teknologi Sepuluh Nopember | IEEE | Tinjauan pustaka state-of-the-art 5 tahun; margin 3-2.5-3-2 cm |
207
+ | `ipb` | IPB University | Name-Year | Sub-bab tanpa titik akhir (1.1 Latar Belakang); nama ilmiah miring |
208
+ | `undip` | Universitas Diponegoro | IEEE / APA | Judul bab kapital tebal di tengah; pasif metodologi |
209
+ | `unpad` | Universitas Padjadjaran | APA / Chicago | Abstrak maks 250 kata, satu paragraf spasi tunggal |
210
+ | `unair` | Universitas Airlangga | Vancouver / APA | Sitasi bernomor biomedis vs sosial-humaniora |
211
+ | `ub` | Universitas Brawijaya | IEEE / APA | Larangan konjungsi awal kalimat; paragraf min 2 kalimat |
212
+ | `telkom` | Telkom University | IEEE | Format artikel IEEE; sitasi GitHub & dataset publik |
213
+ | `udinus` | Universitas Dian Nuswantoro | IEEE / APA | Black-box testing & pengujian pengguna; kode monospace |
214
+ | `uns` | Universitas Sebelas Maret | APA / IEEE | Bab romawi, sub-bab desimal; abstrak dwibahasa 200-250 kata |
215
+ | `unnes` | Universitas Negeri Semarang | APA 7th | Desimal tanpa titik akhir sub-bab; kutipan >40 kata indent 1.2 cm |
216
+ | `upi` | Universitas Pendidikan Indonesia | APA 7th | Analisis Data & Pembahasan terpisah dari Temuan |
217
+ | `unhas` | Universitas Hasanuddin | Harvard / Vancouver / IEEE | Nomor halaman bab di tengah bawah; wajib terjemahan kutipan asing |
218
+ | `unand` | Universitas Andalas | APA / Harvard | Abstrak satu paragraf tanpa indent; rujukan persamaan (1.1) |
219
+ | `jurnal-dikbud` | Jurnal Pendidikan & Kebudayaan Kemendikbud | Nama-tahun | Verdana 9 spasi 1; judul maks 14 kata; abstrak 150-200 kata |
220
+ | `jurnal-jipp` | Jurnal Inovasi & Perekayasa Pendidikan | Alfabetis-Kronologis | Abstrak dwibahasa 100-150 kata; 5 kata kunci; 15-20 hlm kuarto |
221
+
222
+ ## Lembar Sontekan Diksi & Kalke
223
+
224
+ Padanan cepat membersihkan tulisan AI dan birokratis:
225
+
226
+ | Pola AI / Kaku | Bentuk Luwes & Lugas | Jenis Masalah |
227
+ |---|---|---|
228
+ | melakukan pengukuran terhadap | mengukur | Verba ringan |
229
+ | melakukan analisis terhadap | menganalisis | Verba ringan |
230
+ | memberikan pengaruh terhadap | memengaruhi | Verba ringan |
231
+ | mengalami peningkatan sebesar | meningkat / naik sebesar | Nominalisasi |
232
+ | menghormati batas sistem | selaras dengan batas sistem | Kalke (respecting boundaries) |
233
+ | menghapus limbah | meniadakan / meminimalkan limbah | Kalke (eliminate waste) |
234
+ | tidak datang tanpa harga | bukan tanpa konsekuensi / kendala | Kalke (not without a price) |
235
+ | Makalah ini membahas... | Pada makalah ini dibahas... | Personifikasi dokumen |
236
+ | ...yang mana sangat penting | ...yang penting / sehingga penting | Pronomina relatif salah |
237
+ | X, bukan berarti Y | Kendati X, tantangan Y tetap... | Penyangkalan antisipatif |
238
+
239
+ ## Prinsip Integritas Ilmiah
240
+
241
+ - **Nol fabrikasi data** - tidak menambah angka, parameter uji, atau sitasi baru yang tak ada di draf asli.
242
+ - **Safeguard pasif ilmiah** - kalimat pasif pada Metodologi dan Hasil adalah konvensi resmi sains Indonesia; tidak diubah agresif.
243
+ - **Zona terlarang disunting** - instrumen tervalidasi (kuesioner/Likert), dokumen kontrak, dan paten hukum tak disentuh.
244
+ - **Bukan alat bypass deteksi** - fokus pada keterbacaan manusia; kelancaran tata bahasa bukan jaminan skor detektor AI statistik.
245
+
246
+ ## FAQ
247
+
248
+ **Apakah ini alat bypass detektor AI?**
249
+ Bukan. Humanizer ID membersihkan pola tulisan AI agar terbaca manusiawi dan profesional; ia tidak menargetkan skor detektor statistik.
250
+
251
+ **Apakah bisa dipakai offline?**
252
+ Ya. CLI auditor 100% pustaka standar Python tanpa dependensi; seluruh kaidah tersimpan lokal di data/ dan references/.
253
+
254
+ **Apa bedanya dengan sistem anti-slop umum?**
255
+ Humanizer ID khusus bahasa Indonesia: 592 kaidah preskriptif bersumber dokumen resmi dengan nomor halaman, bukan filter gaya generik.
256
+
257
+ **Apa itu sub-kaidah (skill)?**
258
+ Folder berisi SKILL.md yang memperdalam satu ranah (ejaan, sintaksis, diksi, wacana, naskah resmi). Sub-kaidah merujuk kaidah induk lewat ID (mis. TBB-021) dan tidak pernah menduplikasinya - menambah satu tak mengubah induk.
259
+
260
+ **Agen apa saja yang didukung?**
261
+ Semua agen pembaca SKILL.md: Hermes Agent, Claude Code, Google Antigravity, dan antarmuka web via PROMPT.md.
262
+
263
+ ## Lisensi
264
+
265
+ MIT: [LICENSE](LICENSE) © 2026 [Hafizh Muzani](https://github.com/apissaj)
266
+
@@ -0,0 +1,243 @@
1
+ <div align="center">
2
+
3
+ # Humanizer ID
4
+
5
+ **Panduan penyuntingan bahasa Indonesia akademik & profesional untuk agen AI**
6
+
7
+ <code>pip install humanizer-id</code>
8
+
9
+ [Instalasi](#instalasi) · [Arsitektur](#arsitektur-skill) · [Mode Kerja](#mode-kerja) · [Sebelum & Sesudah](#sebelum--sesudah) · [Cheat Sheet](#lembar-sontekan-diksi--kalke) · [FAQ](#faq)
10
+
11
+ [![CI](https://github.com/apissaj/humanizer-id/actions/workflows/ci.yml/badge.svg)](https://github.com/apissaj/humanizer-id/actions/workflows/ci.yml)
12
+ [![PyPI](https://img.shields.io/badge/PyPI-humanizer--id-3775A9?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/humanizer-id/)
13
+ [![Release](https://img.shields.io/github/v/release/apissaj/humanizer-id?style=flat-square)](https://github.com/apissaj/humanizer-id/releases)
14
+ [![License: MIT](https://img.shields.io/badge/license-MIT-f4c430?style=flat-square)](LICENSE)
15
+
16
+ </div>
17
+
18
+ ---
19
+
20
+ **Humanizer ID** adalah buku aturan yang dibaca agen AI setiap sesi penyuntingan naskah Indonesia. Ia membersihkan kalke terjemahan mesin, nominalisasi bertumpuk, verba ringan, fragmentasi kalimat, dan pola khas keluaran LLM — lalu berhenti di situ: bukan filter gaya, tapi filter slop dengan 592 kaidah preskriptif bersumber dokumen resmi lengkap nomor halaman. Satu induk + lima sub-kaidah dimuat sesuai kebutuhan naskah, plus mesin audit deterministik ber-CLI. Integritas ilmiah mengikat: nol fabrikasi data, dan ini **bukan** alat bypass detektor AI.
21
+
22
+ ## Sebelum & Sesudah
23
+
24
+ Contoh penyuntingan abstrak penelitian teknik (studi kasus lengkap di [examples/](examples/)):
25
+
26
+ | **Sebelum: draf mentah AI** | **Sesudah: Humanizer ID** |
27
+ |:--|:--|
28
+ | *Di era digital saat ini, optimasi basis data merupakan hal yang sangat krusial. Dalam penelitian ini melakukan analisis terhadap performa indeks B-Tree yang mengalami peningkatan kecepatan sebesar 35%. Meskipun cepat, bukan berarti indeks ini tanpa cela. Tulisan ini membahas bagaimana implementasi partisi tabel memberikan pengaruh terhadap throughput transaksi yang mana sangat penting untuk sistem.* | *Optimasi basis data menjadi penentu efisiensi sistem berskala besar. Penelitian ini menganalisis performa indeks B-Tree yang mencatatkan peningkatan kecepatan hingga 35%. Kendati demikian, karakteristik beban kerja tetap memunculkan tantangan komputasi tersendiri. Pada penelitian ini dibahas implementasi partisi tabel untuk meningkatkan throughput transaksi secara berkelanjutan.* |
29
+
30
+ Yang dibersihkan: nominalisasi bertumpuk (*melakukan analisis terhadap*), kalimat tanpa subjek (*Dalam penelitian ini melakukan*), penyangkalan antisipatif (*Meskipun cepat, bukan berarti*), pronomina relatif salah (*yang mana*), personifikasi dokumen (*Tulisan ini membahas*).
31
+
32
+ ## Mengapa Naskah AI Bahasa Indonesia Terasa Kaku?
33
+
34
+ Kekakuan jarang disebabkan kesalahan tata bahasa. Penyebab utamanya:
35
+
36
+ 1. **Nominalisasi menumpuk & verba ringan** — *melakukan pengujian terhadap* alih-alih *menguji*.
37
+ 2. **Kalke (*calque*) terjemahan mesin** — model berpikir dalam Inggris lalu menerjemahkan klausa demi klausa (*respecting boundaries* menjadi *menghormati batas*).
38
+ 3. **Penyangkalan antisipatif** — *Meskipun X, bukan berarti Y...* yang menyangkal hal yang tak ditanyakan pembaca.
39
+ 4. **Fragmentasi kalimat monoton** — kalimat pendek satu klausa berderet patah-patah (*staccato*).
40
+ 5. **Monotoni pembuka antar-paragraf** — *Selain itu,... Lebih lanjut,... Oleh karena itu,...* berulang di tiap paragraf.
41
+ 6. **Transisi kopong** — *Dengan demikian, hal ini membuktikan...* tanpa premis data yang cukup.
42
+
43
+ ## Arsitektur Skill
44
+
45
+ Sejak v2.1.0 panduan editorial dipecah agar hemat konteks agen: induk dimuat dulu, sub-kaidah hanya yang relevan dengan naskah.
46
+
47
+ | Skill | Cakupan | Muat untuk |
48
+ |-------|---------|------------|
49
+ | **`SKILL.md`** (induk) | Aturan integritas ilmiah, pengecualian dokumen, 4 mode eksekusi, eliminasi penyakit AI leksikal, tabel rute, Delivery Gate | Semua naskah. Selalu dimuat |
50
+ | [skills/humanizer-id-sintaksis](skills/humanizer-id-sintaksis/SKILL.md) | 21 blok: kesejajaran, korelatif, kalimat efektif, morfofonemik verba | Naskah berkalimat cacat |
51
+ | [skills/humanizer-id-wacana-retorika](skills/humanizer-id-wacana-retorika/SKILL.md) | 18 blok: kohesi paragraf, sitasi terajut, hedging epistemik | Naskah alur lemah |
52
+ | [skills/humanizer-id-ejaan-morfologi](skills/humanizer-id-ejaan-morfologi/SKILL.md) | 17 blok: EYD V, PUEBI, peluluhan fonem, gabungan kata | Naskah ejaan/imbuhan |
53
+ | [skills/humanizer-id-diksi-istilah](skills/humanizer-id-diksi-istilah/SKILL.md) | 13 blok: pilihan kata, peristilahan PUPI, padanan lintas bidang | Naskah istilah teknis |
54
+ | [skills/humanizer-id-naskah-resmi](skills/humanizer-id-naskah-resmi/SKILL.md) | 6 blok: bahasa pewara, surat dinas, metadata jurnal | Naskah resmi/dinas |
55
+ | [jurnal/](jurnal/SKILL.md) | Modul jurnal bereputasi: IMRaD, checklist 28 poin, template abstrak/cover letter | Naskah Scopus/SINTA |
56
+
57
+ Arsip provenance sesi bedah tersimpan di [references/log-integrasi-kaidah.md](references/log-integrasi-kaidah.md) (bukan aturan operasional). Setiap entri kaidah berformat **Pola → Perbaikan → Sebab** dengan sitasi halaman sumber.
58
+
59
+ ## Mode Kerja
60
+
61
+ Humanizer ID berjalan dua cara:
62
+
63
+ - **During** — membimbing penyuntingan selagi naskah dikerjakan, ditutup laporan Delivery Gate (PASS/FAIL).
64
+ - **After** — mengaudit naskah yang sudah ada: daftar temuan bernomor, kamu setujui nomor mana yang dieksekusi, lalu laporan susulan.
65
+
66
+ ```bash
67
+ # Audit bernomor tanpa menyunting naskah
68
+ python scripts/audit.py naskah.md --report
69
+ ```
70
+
71
+ Laporan tersimpan di `humanizer/audit-001-YYYY-MM-DD.md` (nomor naik otomatis, tak pernah menimpa). Tiap temuan memuat prioritas **HIGH** (kalke/verba ringan/klise AI), **MEDIUM** (istilah tak baku), **LOW** (gaya/domain), kutipan, saran, dan catatan kaidah.
72
+
73
+ ## Instalasi
74
+
75
+ ### Paket Python (PyPI)
76
+
77
+ ```bash
78
+ pip install humanizer-id
79
+ ```
80
+
81
+ ```bash
82
+ # Audit naskah langsung
83
+ humanizer-id naskah.md
84
+
85
+ # Perbaikan otomatis (autofix) leksikal deterministik
86
+ humanizer-id naskah.md --fix # ke layar
87
+ humanizer-id naskah.md --fix --write # in-place ke berkas asli
88
+
89
+ # Preset domain spesifik
90
+ humanizer-id naskah.md --preset akademik
91
+ humanizer-id surat.md --preset dinas
92
+
93
+ # Teks demo bawaan
94
+ humanizer-id --demo
95
+ ```
96
+
97
+ Sebagai modul Python:
98
+
99
+ ```python
100
+ from humanizer_id.audit import load_default_data, audit_text
101
+
102
+ kalke, glos = load_default_data()
103
+ findings = audit_text("Naskah yang ingin diperiksa...", kalke, glos)
104
+ for f in findings:
105
+ print(f["id"], "-", f["pola"])
106
+ ```
107
+
108
+ ### AI Coding Agents
109
+
110
+ #### Hermes Agent
111
+
112
+ ```bash
113
+ mkdir -p ~/.hermes/skills/creative/humanizer-id
114
+ git clone https://github.com/apissaj/humanizer-id.git /tmp/humanizer-id
115
+ cp /tmp/humanizer-id/SKILL.md ~/.hermes/skills/creative/humanizer-id/
116
+ cp -r /tmp/humanizer-id/skills/ ~/.hermes/skills/creative/humanizer-id/skills/
117
+ cp -r /tmp/humanizer-id/scripts/ /tmp/humanizer-id/humanizer_id/ /tmp/humanizer-id/data/ ~/.hermes/skills/creative/humanizer-id/ # agar mode AFTER (--report) jalan
118
+ ```
119
+
120
+ #### Claude Code
121
+
122
+ ```bash
123
+ git clone https://github.com/apissaj/humanizer-id.git ~/.claude/skills/humanizer-id
124
+ ```
125
+
126
+ #### Google Antigravity
127
+
128
+ ```bash
129
+ # Global
130
+ git clone https://github.com/apissaj/humanizer-id.git ~/.gemini/config/skills/humanizer-id
131
+
132
+ # Per-project workspace
133
+ git clone https://github.com/apissaj/humanizer-id.git .agents/skills/humanizer-id
134
+ ```
135
+
136
+ ### Antarmuka Web (ChatGPT, Claude, Gemini)
137
+
138
+ Tanpa coding agent: salin [PROMPT.md](PROMPT.md) ke Custom Instructions (ChatGPT) atau Project System Prompt (Claude). Untuk skripsi & jurnal ilmiah (SINTA/Scopus), pakai [PROMPT-AKADEMIK.md](PROMPT-AKADEMIK.md) agar tone padat leksikal, berstruktur hipotaktis, dan impersonal murni.
139
+
140
+ ### CLI Auditor Mandiri
141
+
142
+ Tanpa dependensi eksternal (100% pustaka standar Python):
143
+
144
+ ```bash
145
+ python scripts/audit.py --demo
146
+ python scripts/audit.py path/ke/naskah.md
147
+ python scripts/audit.py naskah.md --preset akademik
148
+ ```
149
+
150
+ ## Sumber Resmi
151
+
152
+ Seluruh kaidah **bukan karangan bebas** — setiap aturan ditelusuri dari dokumen resmi dengan nomor halaman, tersimpan penuh di [references/](references/):
153
+
154
+ | Sumber | Kontribusi |
155
+ |--------|-----------|
156
+ | *Cerdas Cergas Berbahasa dan Bersastra Indonesia* Kelas XI & XII (Kemendikbudristek, 2024) | Ragam ilmiah denotatif-objektif, kalimat efektif, kaidah surat resmi (hlm. 210-215, 29-34) |
157
+ | *Bahasa Indonesia untuk Perguruan Tinggi* (Suyatno dkk., UIN Jakarta, 2017) | Enam syarat keefektifan kalimat akademik (hlm. 100-107) |
158
+ | *Tata Bahasa Baku Bahasa Indonesia* Edisi IV (Alwi dkk.) | Kesejajaran predikat, korelatif, pronomina, pelesapan konstituen |
159
+ | EYD Edisi V (SK No. 0424/I/BS.00.01/2022) & PUEBI | Peluluhan KTSP, bentuk terikat, gabungan kata |
160
+ | *Tata Istilah* (Pusat Bahasa 1978; Qodratillah 2019) | Paradigma imbuhan peristilahan, PUPI, padanan lintas bidang |
161
+ | *Bentuk dan Pilihan Kata* (Mustakim 2014, 2019) | Anti-pleonasme, diksi preskriptif, pembedaan dll./dsb./dst. |
162
+ | Seri Penyuluhan Badan Bahasa: *Kalimat*, *Paragraf* (2019) | Struktur kalimat efektif, kohesi paragraf |
163
+ | *Bahasa Indonesia untuk Pejabat Pemerintah* (Mullyana 2019); *Pedoman Surat-Menyurat* (1991) | Naskah dinas & surat resmi |
164
+ | *Bahasa Indonesia untuk Pewara* (Kurniawan dkk. 2019) | Naskah acara & penyapaan formal |
165
+ | Jurnal kebahasaan (Widyaparwa 2020, Genre UAD 2021, JPLED Unimal 2024, Ar-Rumman 2024) | Pleonasme skripsi, kontaminasi kuantor, korelatif takbaku |
166
+ | Kobak et al., *Science Advances* (2025, DOI: 10.1126/sciadv.adt3813) | Bukti frekuensi kalke verba AI: delve 28x, underscore 13,8x, showcase 10,7x |
167
+
168
+ Dataset terbuka di [data/](data/):
169
+
170
+ - [data/kalke-indonesia.json](data/kalke-indonesia.json) - 592 entri leksikon kalke, verba ringan, pola antisipatif AI, kaidah morfologi EYD V.
171
+ - [data/glosarium-lintas-bidang.json](data/glosarium-lintas-bidang.json) - 137 padanan istilah baku (Teknologi 59, Bisnis 44, Linguistik 17, Hukum 10, Jurnalistik 7).
172
+ - [data/pedoman-kampus.json](data/pedoman-kampus.json) - preset 16 perguruan tinggi + jurnal dikbud.
173
+
174
+ ## Preset Kampus
175
+
176
+ Konvensi tugas akhir/skripsi spesifik (panduan lengkap: [references/panduan-preset-kampus.md](references/panduan-preset-kampus.md)). Cara pakai: sebutkan nama kampus saat memberi naskah, misalnya *Sunting abstrak skripsi ini dengan preset ugm*.
177
+
178
+ | Preset | Perguruan Tinggi | Sitasi Bawaan | Kaidah Khusus |
179
+ |--------|------------------|---------------|---------------|
180
+ | `ui` | Universitas Indonesia | APA / IEEE | Abstrak dwibahasa; penomoran tabel per bab (Tabel 1.1) |
181
+ | `itb` | Institut Teknologi Bandung | IEEE / Harvard | Rujukan persamaan (1.1); sampul minimalis |
182
+ | `ugm` | Universitas Gadjah Mada | IEEE / APA | Format Persamaan (nomor); Simpulan vs Saran terpisah tegas |
183
+ | `its` | Institut Teknologi Sepuluh Nopember | IEEE | Tinjauan pustaka state-of-the-art 5 tahun; margin 3-2.5-3-2 cm |
184
+ | `ipb` | IPB University | Name-Year | Sub-bab tanpa titik akhir (1.1 Latar Belakang); nama ilmiah miring |
185
+ | `undip` | Universitas Diponegoro | IEEE / APA | Judul bab kapital tebal di tengah; pasif metodologi |
186
+ | `unpad` | Universitas Padjadjaran | APA / Chicago | Abstrak maks 250 kata, satu paragraf spasi tunggal |
187
+ | `unair` | Universitas Airlangga | Vancouver / APA | Sitasi bernomor biomedis vs sosial-humaniora |
188
+ | `ub` | Universitas Brawijaya | IEEE / APA | Larangan konjungsi awal kalimat; paragraf min 2 kalimat |
189
+ | `telkom` | Telkom University | IEEE | Format artikel IEEE; sitasi GitHub & dataset publik |
190
+ | `udinus` | Universitas Dian Nuswantoro | IEEE / APA | Black-box testing & pengujian pengguna; kode monospace |
191
+ | `uns` | Universitas Sebelas Maret | APA / IEEE | Bab romawi, sub-bab desimal; abstrak dwibahasa 200-250 kata |
192
+ | `unnes` | Universitas Negeri Semarang | APA 7th | Desimal tanpa titik akhir sub-bab; kutipan >40 kata indent 1.2 cm |
193
+ | `upi` | Universitas Pendidikan Indonesia | APA 7th | Analisis Data & Pembahasan terpisah dari Temuan |
194
+ | `unhas` | Universitas Hasanuddin | Harvard / Vancouver / IEEE | Nomor halaman bab di tengah bawah; wajib terjemahan kutipan asing |
195
+ | `unand` | Universitas Andalas | APA / Harvard | Abstrak satu paragraf tanpa indent; rujukan persamaan (1.1) |
196
+ | `jurnal-dikbud` | Jurnal Pendidikan & Kebudayaan Kemendikbud | Nama-tahun | Verdana 9 spasi 1; judul maks 14 kata; abstrak 150-200 kata |
197
+ | `jurnal-jipp` | Jurnal Inovasi & Perekayasa Pendidikan | Alfabetis-Kronologis | Abstrak dwibahasa 100-150 kata; 5 kata kunci; 15-20 hlm kuarto |
198
+
199
+ ## Lembar Sontekan Diksi & Kalke
200
+
201
+ Padanan cepat membersihkan tulisan AI dan birokratis:
202
+
203
+ | Pola AI / Kaku | Bentuk Luwes & Lugas | Jenis Masalah |
204
+ |---|---|---|
205
+ | melakukan pengukuran terhadap | mengukur | Verba ringan |
206
+ | melakukan analisis terhadap | menganalisis | Verba ringan |
207
+ | memberikan pengaruh terhadap | memengaruhi | Verba ringan |
208
+ | mengalami peningkatan sebesar | meningkat / naik sebesar | Nominalisasi |
209
+ | menghormati batas sistem | selaras dengan batas sistem | Kalke (respecting boundaries) |
210
+ | menghapus limbah | meniadakan / meminimalkan limbah | Kalke (eliminate waste) |
211
+ | tidak datang tanpa harga | bukan tanpa konsekuensi / kendala | Kalke (not without a price) |
212
+ | Makalah ini membahas... | Pada makalah ini dibahas... | Personifikasi dokumen |
213
+ | ...yang mana sangat penting | ...yang penting / sehingga penting | Pronomina relatif salah |
214
+ | X, bukan berarti Y | Kendati X, tantangan Y tetap... | Penyangkalan antisipatif |
215
+
216
+ ## Prinsip Integritas Ilmiah
217
+
218
+ - **Nol fabrikasi data** - tidak menambah angka, parameter uji, atau sitasi baru yang tak ada di draf asli.
219
+ - **Safeguard pasif ilmiah** - kalimat pasif pada Metodologi dan Hasil adalah konvensi resmi sains Indonesia; tidak diubah agresif.
220
+ - **Zona terlarang disunting** - instrumen tervalidasi (kuesioner/Likert), dokumen kontrak, dan paten hukum tak disentuh.
221
+ - **Bukan alat bypass deteksi** - fokus pada keterbacaan manusia; kelancaran tata bahasa bukan jaminan skor detektor AI statistik.
222
+
223
+ ## FAQ
224
+
225
+ **Apakah ini alat bypass detektor AI?**
226
+ Bukan. Humanizer ID membersihkan pola tulisan AI agar terbaca manusiawi dan profesional; ia tidak menargetkan skor detektor statistik.
227
+
228
+ **Apakah bisa dipakai offline?**
229
+ Ya. CLI auditor 100% pustaka standar Python tanpa dependensi; seluruh kaidah tersimpan lokal di data/ dan references/.
230
+
231
+ **Apa bedanya dengan sistem anti-slop umum?**
232
+ Humanizer ID khusus bahasa Indonesia: 592 kaidah preskriptif bersumber dokumen resmi dengan nomor halaman, bukan filter gaya generik.
233
+
234
+ **Apa itu sub-kaidah (skill)?**
235
+ Folder berisi SKILL.md yang memperdalam satu ranah (ejaan, sintaksis, diksi, wacana, naskah resmi). Sub-kaidah merujuk kaidah induk lewat ID (mis. TBB-021) dan tidak pernah menduplikasinya - menambah satu tak mengubah induk.
236
+
237
+ **Agen apa saja yang didukung?**
238
+ Semua agen pembaca SKILL.md: Hermes Agent, Claude Code, Google Antigravity, dan antarmuka web via PROMPT.md.
239
+
240
+ ## Lisensi
241
+
242
+ MIT: [LICENSE](LICENSE) © 2026 [Hafizh Muzani](https://github.com/apissaj)
243
+
@@ -0,0 +1,7 @@
1
+ """Humanizer ID: mesin editorial bahasa Indonesia berbasis 465 kaidah preskriptif."""
2
+
3
+ __version__ = "2.3.0"
4
+
5
+ from .audit import audit_text # noqa: F401
6
+ from .engine import fix_text # noqa: F401
7
+ from .report import tulis_laporan, render_laporan, klasifikasi_prioritas # noqa: F401
@@ -0,0 +1,17 @@
1
+ """Public API: muat dataset dan audit teks."""
2
+
3
+ import json
4
+ import os
5
+
6
+ from .matchers import match_custom_rules # noqa: F401
7
+ from .engine import audit_text, _resolve_data_dir, fix_text # noqa: F401
8
+
9
+
10
+ def load_default_data():
11
+ """Muat dataset kaidah & glosarium yang dibundel dalam paket (fail-closed)."""
12
+ data_dir = _resolve_data_dir()
13
+ with open(os.path.join(data_dir, "kalke-indonesia.json"), encoding="utf-8") as f:
14
+ kalke = json.load(f)
15
+ with open(os.path.join(data_dir, "glosarium-lintas-bidang.json"), encoding="utf-8") as f:
16
+ glos = json.load(f)
17
+ return kalke, glos
@@ -0,0 +1,20 @@
1
+ """CLI entrypoint untuk perintah `humanizer-id`."""
2
+
3
+ import sys
4
+ import os
5
+
6
+ from .engine import load_data, main as engine_main
7
+
8
+
9
+ def main():
10
+ # Delegasikan seluruh argumen ke CLI engine asli (sudut perilaku identik)
11
+ # engine.main membaca sys.argv[1:] sendiri
12
+ if len(sys.argv) >= 2 and sys.argv[1] in ("-v", "--version"):
13
+ from . import __version__
14
+ print(f"humanizer-id v{__version__}")
15
+ sys.exit(0)
16
+ engine_main()
17
+
18
+
19
+ if __name__ == "__main__":
20
+ main()