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.
- humanizer_id-2.3.0/LICENSE +22 -0
- humanizer_id-2.3.0/PKG-INFO +266 -0
- humanizer_id-2.3.0/README.md +243 -0
- humanizer_id-2.3.0/humanizer_id/__init__.py +7 -0
- humanizer_id-2.3.0/humanizer_id/audit.py +17 -0
- humanizer_id-2.3.0/humanizer_id/cli.py +20 -0
- humanizer_id-2.3.0/humanizer_id/data/glosarium-lintas-bidang.json +774 -0
- humanizer_id-2.3.0/humanizer_id/data/kalke-indonesia.json +6943 -0
- humanizer_id-2.3.0/humanizer_id/data/pedoman-kampus.json +300 -0
- humanizer_id-2.3.0/humanizer_id/engine.py +469 -0
- humanizer_id-2.3.0/humanizer_id/matchers.py +818 -0
- humanizer_id-2.3.0/humanizer_id/report.py +139 -0
- humanizer_id-2.3.0/humanizer_id.egg-info/PKG-INFO +266 -0
- humanizer_id-2.3.0/humanizer_id.egg-info/SOURCES.txt +24 -0
- humanizer_id-2.3.0/humanizer_id.egg-info/dependency_links.txt +1 -0
- humanizer_id-2.3.0/humanizer_id.egg-info/entry_points.txt +2 -0
- humanizer_id-2.3.0/humanizer_id.egg-info/top_level.txt +1 -0
- humanizer_id-2.3.0/pyproject.toml +37 -0
- humanizer_id-2.3.0/setup.cfg +4 -0
- humanizer_id-2.3.0/tests/test_benchmark.py +130 -0
- humanizer_id-2.3.0/tests/test_fix.py +51 -0
- humanizer_id-2.3.0/tests/test_large_benchmark.py +51 -0
- humanizer_id-2.3.0/tests/test_packaging.py +63 -0
- humanizer_id-2.3.0/tests/test_regression.py +117 -0
- humanizer_id-2.3.0/tests/test_report.py +103 -0
- humanizer_id-2.3.0/tests/test_smoke.py +201 -0
|
@@ -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
|
+
[](https://github.com/apissaj/humanizer-id/actions/workflows/ci.yml)
|
|
35
|
+
[](https://pypi.org/project/humanizer-id/)
|
|
36
|
+
[](https://github.com/apissaj/humanizer-id/releases)
|
|
37
|
+
[](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
|
+
[](https://github.com/apissaj/humanizer-id/actions/workflows/ci.yml)
|
|
12
|
+
[](https://pypi.org/project/humanizer-id/)
|
|
13
|
+
[](https://github.com/apissaj/humanizer-id/releases)
|
|
14
|
+
[](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()
|