slop-ai-indo 1.3.0 → 1.4.0
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.
- package/README.md +47 -10
- package/index.mjs +1 -0
- package/lib/banner.mjs +1 -1
- package/package.json +1 -1
- package/skills/slop-ai-indo/SKILL.md +11 -1
- package/skills/slop-ai-indo/VERSION +1 -1
- package/skills/slop-ai-indo-concise/SKILL.md +110 -0
- package/skills/slop-ai-indo-human/contrast-mcp.py +1 -1
- package/slop-ai-indo.md +11 -1
package/README.md
CHANGED
|
@@ -30,7 +30,7 @@ npx slop-ai-indo
|
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
Perintah ini secara otomatis memasang **1 paket lengkap**:
|
|
33
|
-
- `DESIGN.md`: Standar estetika human-crafted (bisa dipilih langsung saat instalasi: Enterprise SaaS, Dark Modern, Editorial, Utilitarian, atau
|
|
33
|
+
- `DESIGN.md`: Standar estetika human-crafted (bisa dipilih langsung saat instalasi: Enterprise SaaS, Dark Modern, Fintech & Transaksi, DevTools, Minimalist Monochrome, Editorial, Utilitarian, atau Bawaan).
|
|
34
34
|
- `AGENTS.md`: Aturan otomatis AI agent saat membuka proyek terkait.
|
|
35
35
|
- `slop-ai-indo.md`: Mesin filter inti (38 aturan wajib).
|
|
36
36
|
- `.agents/`: Folder konfigurasi lengkap dengan 11 modul skill terstandar (termasuk arsitektur backend, audit keamanan, testing, dan kebersihan kode).
|
|
@@ -183,6 +183,7 @@ Skill dimuat saat sesi agen dimulai, jadi bukalah sesi baru setelah melakukan pe
|
|
|
183
183
|
| **slop-ai-indo-identity** | Karakter & identitas produk: pencegahan penjiplakan layout SaaS populer, ikon generik, dan palet acak | v1.0.2 |
|
|
184
184
|
| **slop-ai-indo-backend** | Arsitektur backend & API: Clean REST URL, parameter binding, controller ramping, DTO/Resource, database lookup table, $fillable, foreign key cascade | v1.1.0 |
|
|
185
185
|
| **slop-ai-indo-test** | Pengujian otomatis & mocking: pemberantasan tes palsu, over-mocking, asersi hampa, skenario kegagalan nyata | v1.1.0 |
|
|
186
|
+
| **slop-ai-indo-concise** | Efisiensi token & komunikasi: memangkas obrolan basa-basi AI, prinsip *Say Less & Answer First* (terinspirasi Caveman), dan payload verbatim lengkap | v1.1.0 |
|
|
186
187
|
|
|
187
188
|
Pilih skill yang sesuai dengan pekerjaan:
|
|
188
189
|
- Membuat UI → `slop-ai-indo-ui`
|
|
@@ -195,9 +196,24 @@ Pilih skill yang sesuai dengan pekerjaan:
|
|
|
195
196
|
- Identitas produk & branding → `slop-ai-indo-identity`
|
|
196
197
|
- Arsitektur backend & API → `slop-ai-indo-backend`
|
|
197
198
|
- Pengujian otomatis & unit test → `slop-ai-indo-test`
|
|
199
|
+
- Komunikasi ringkas & hemat token → `slop-ai-indo-concise`
|
|
198
200
|
- Tugas campuran → pasang beberapa skill sekaligus
|
|
199
201
|
- Tanpa skill tambahan → berkas inti sendirian sudah merupakan filter yang lengkap
|
|
200
202
|
|
|
203
|
+
### Duet Penghemat Token: slop-ai-indo + Caveman
|
|
204
|
+
|
|
205
|
+
`slop-ai-indo` dirancang untuk menjaga kualitas teknis, kriya UI, dan standar keamanan. Untuk mengoptimalkan efisiensi token dan biaya API secara maksimal (30%–50%+ lebih hemat), padukan dengan [Caveman](https://github.com/juliusbrussee/caveman):
|
|
206
|
+
* **Say Less (Gaya Respon Ringkas):** Diaktifkan melalui skill `slop-ai-indo-concise` (nol basa-basi, nol pengulangan prompt, kode verbatim).
|
|
207
|
+
* **Read Less (Pemotongan Data Input):** Menggunakan kakas [Caveman CLI](https://github.com/juliusbrussee/caveman) untuk memotong ukuran log terminal, output test suite, dan kompresi konten web:
|
|
208
|
+
```bash
|
|
209
|
+
# Pasang skill Caveman global
|
|
210
|
+
npx skills add JuliusBrussee/caveman -g
|
|
211
|
+
|
|
212
|
+
# Atau jalankan proxy otomatis Caveman untuk CLI agent
|
|
213
|
+
npx @caveman-ai/cli@latest
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
|
|
201
217
|
## Rekomendasi Preset Desain (DESIGN.md)
|
|
202
218
|
|
|
203
219
|
Saat memasang ke dalam proyek (`npx slop-ai-indo`), Anda dapat memilih preset estetika human-crafted yang otomatis disalin menjadi `DESIGN.md`:
|
|
@@ -231,15 +247,36 @@ npx slop-ai-indo lint
|
|
|
231
247
|
# Memeriksa folder tertentu
|
|
232
248
|
npx slop-ai-indo lint ./src
|
|
233
249
|
|
|
250
|
+
# Hanya memeriksa aturan tingkatan Hard Gate
|
|
251
|
+
npx slop-ai-indo lint . --tier=hard-gate
|
|
252
|
+
|
|
234
253
|
# Output format JSON untuk integrasi CI/CD
|
|
235
254
|
npx slop-ai-indo lint --json
|
|
255
|
+
|
|
256
|
+
# Mode senyap (hanya kode keluar dan ringkasan jika error)
|
|
257
|
+
npx slop-ai-indo lint --quiet
|
|
236
258
|
```
|
|
237
259
|
|
|
238
|
-
Linter ini memindai berkas secara statis dan memvalidasi aturan
|
|
239
|
-
- **
|
|
240
|
-
-
|
|
241
|
-
-
|
|
242
|
-
-
|
|
260
|
+
Linter ini memindai berkas secara statis dan memvalidasi aturan anti-slop lintas 3 tingkatan gerbang:
|
|
261
|
+
- **Hard Gate (Wajib Lulus Mutlak):**
|
|
262
|
+
- Frasa klise promosi AI seperti *"unlock the power"*, *"seamless synergy"*, *"game-changing"* (`R-02`).
|
|
263
|
+
- Penggunaan tanda em dash ganda berurutan tanpa tujuan editorial (`R-02`).
|
|
264
|
+
- Metrik & statistik kepuasan fiktif rekayasa AI tanpa sumber nyata (`R-08`).
|
|
265
|
+
- Transisi global `transition: all` dan transisi geometri pembuat lag (`R-09`).
|
|
266
|
+
- Pendaran neon luar berlebihan / outer neon glow (`R-11`).
|
|
267
|
+
- Tombol balon kapsul ekstrem (`rounded-full` / 9999px) di luar avatar (`R-12`).
|
|
268
|
+
- Indikator fokus keyboard hilang (`outline: none`) tanpa cincin fokus pengganti (`R-06`).
|
|
269
|
+
- Tautan navigasi mati atau anchor kosong `href="#"` (`R-24`).
|
|
270
|
+
- Placeholder malas khas AI seperti `// TODO: implement later` atau `// rest of code` (`R-32`).
|
|
271
|
+
- Penanganan error hampa / silent catch `catch (e) {}` (`B-01`).
|
|
272
|
+
- Mass assignment model database tanpa perlindungan `$guarded = []` (`B-02`).
|
|
273
|
+
- **Purpose-Gate (Wajib Alasan Fungsional Tertulis):**
|
|
274
|
+
- Gradien biru-ke-ungu generik khas template AI (`R-01`).
|
|
275
|
+
- Ikon bintang sparkle atau magic wand tanpa fungsi nyata (`R-04`).
|
|
276
|
+
- Efek kaca menumpuk berlebihan / excessive glassmorphism (`R-10`).
|
|
277
|
+
- **Quality Locks (Kerapian & Konsistensi):**
|
|
278
|
+
- Tombol CTA generik klise AI (`R-15`).
|
|
279
|
+
- Komentar kode trivial & DocBlock boilerplate yang mengulang sintaks (`R-31`).
|
|
243
280
|
|
|
244
281
|
## Server MCP Terpadu (`slop-mcp`)
|
|
245
282
|
|
|
@@ -268,7 +305,7 @@ Tambahkan entri berikut pada konfigurasi MCP IDE Anda:
|
|
|
268
305
|
1. **`check_contrast`**: Menghitung rasio kontras WCAG 2.1 antara dua warna heksadesimal dengan vonis kepatuhan AA (normal & large text).
|
|
269
306
|
2. **`lint_snippet`**: Memeriksa potongan kode aktif secara in-memory dari AI slop sebelum ditulis ke disk.
|
|
270
307
|
3. **`lint_file`**: Menjalankan analisis statis deterministik pada path berkas atau direktori proyek.
|
|
271
|
-
4. **`validate_delivery_gate`**: Memvalidasi kelengkapan 4 blok
|
|
308
|
+
4. **`validate_delivery_gate`**: Memvalidasi kelengkapan 4 blok laporan Delivery Gate (Aturan, Smoke Test, Kontras, dan status akhir).
|
|
272
309
|
5. **`get_rule`**: Mengambil referensi detail dan solusi perbaikan dari suatu aturan anti-slop berdasarkan Rule ID.
|
|
273
310
|
|
|
274
311
|
---
|
|
@@ -287,7 +324,7 @@ npx slop-ai-indo hook
|
|
|
287
324
|
|
|
288
325
|
Fitur Pre-commit Hook:
|
|
289
326
|
- **Zero-overhead & Cepat (<100ms):** Hanya memindai berkas yang sedang di-*stage* (`git diff --cached`), tanpa overhead subprocess yang lambat.
|
|
290
|
-
- **Deteksi Pelanggaran Statis:** Otomatis memblokir commit jika kode
|
|
327
|
+
- **Deteksi Pelanggaran Statis:** Otomatis memblokir commit jika kode staged memuat pelanggaran *Hard Gate* (frasa promosi klise `R-02`, metrik fiktif `R-08`, `transition: all` `R-09`, outer neon glow `R-11`, tombol kapsul `R-12`, outline none tanpa ring `R-06`, link mati `href="#"` `R-24`, placeholder malas `R-32`, silent catch `B-01`, atau `$guarded = []` `B-02`).
|
|
291
328
|
- **Bypass Darurat:** Jika dalam kondisi darurat Anda tetap harus melakukan commit, gunakan opsi bawaan git atau environment variable:
|
|
292
329
|
```bash
|
|
293
330
|
git commit -m "emergency fix" --no-verify
|
|
@@ -328,7 +365,7 @@ jobs:
|
|
|
328
365
|
- name: Set up Node.js
|
|
329
366
|
uses: actions/setup-node@v4
|
|
330
367
|
with:
|
|
331
|
-
node-version:
|
|
368
|
+
node-version: 22
|
|
332
369
|
cache: 'npm'
|
|
333
370
|
|
|
334
371
|
- name: Run Deterministic Slop Linter
|
|
@@ -339,7 +376,7 @@ Jika linter menemukan pelanggaran aturan pada kode PR, pipeline otomatis berstat
|
|
|
339
376
|
|
|
340
377
|
## Peta Jalan (Roadmap)
|
|
341
378
|
|
|
342
|
-
**v1.
|
|
379
|
+
**v1.4.0** adalah rilis saat ini. Riwayat setiap rilis dan rencana fitur selanjutnya tercantum lengkap di [ROADMAP.md](ROADMAP.md).
|
|
343
380
|
|
|
344
381
|
## FAQ (Pertanyaan yang Sering Diajukan)
|
|
345
382
|
|
package/index.mjs
CHANGED
|
@@ -34,6 +34,7 @@ const EXTRA_SKILLS = [
|
|
|
34
34
|
{ value: 'slop-ai-indo-identity', label: 'slop-ai-indo-identity', hint: 'Identitas produk, branding unik, dan anti penjiplakan' },
|
|
35
35
|
{ value: 'slop-ai-indo-backend', label: 'slop-ai-indo-backend', hint: 'Arsitektur backend, REST API, dan query database' },
|
|
36
36
|
{ value: 'slop-ai-indo-test', label: 'slop-ai-indo-test', hint: 'Pengujian otomatis, unit test, dan anti mock palsu' },
|
|
37
|
+
{ value: 'slop-ai-indo-concise', label: 'slop-ai-indo-concise', hint: 'Komunikasi ringkas, hemat token, dan anti obrolan klise (ala Caveman)' },
|
|
37
38
|
]
|
|
38
39
|
|
|
39
40
|
function stop(message) {
|
package/lib/banner.mjs
CHANGED
package/package.json
CHANGED
|
@@ -32,6 +32,11 @@ Jika tidak ada blok penunjuk slop-ai-indo dan berkas ini sedang dibaca untuk per
|
|
|
32
32
|
- **5. `slop-ai-indo-layoutmobile` (mobile / responsif):** pilih ini untuk tata letak yang harus beradaptasi mulus di berbagai ukuran layar: breakpoint, skala, grid, overflow, area sentuh.
|
|
33
33
|
- **6. `slop-ai-indo-code` (komentar kode):** pilih ini untuk merapikan komentar kode program: menghapus komentar klise AI, menjaga komentar penting, tanpa menyentuh logika kode.
|
|
34
34
|
- **7. `slop-ai-indo-security` (audit keamanan):** pilih ini untuk audit keamanan komprehensif, tinjauan kerentanan source-first, threat modeling, verifikasi sandbox terisolasi, dan remediasi keamanan defensif.
|
|
35
|
+
- **8. `slop-ai-indo-backend` (backend & API):** pilih ini untuk arsitektur server, API controller, sanitasi query database, dan error handling.
|
|
36
|
+
- **9. `slop-ai-indo-test` (pengujian otomatis):** pilih ini untuk pengujian otomatis, validasi skenario kegagalan nyata, dan anti fake mock.
|
|
37
|
+
- **10. `slop-ai-indo-docs` (dokumentasi teknis):** pilih ini untuk dokumentasi teknis, PRD, dan spesifikasi arsitektur bebas narasi hampa.
|
|
38
|
+
- **11. `slop-ai-indo-identity` (identitas produk):** pilih ini untuk menjaga karakter produk unik dan mencegah klon buta template populer.
|
|
39
|
+
- **12. `slop-ai-indo-concise` (komunikasi & hemat token):** pilih ini untuk memangkas obrolan basa-basi AI (*Say Less & Answer First* ala Caveman) dan menghemat biaya token tanpa memotong kelengkapan kode.
|
|
35
40
|
|
|
36
41
|
Jika pengguna menolak atau mengatakan "inti saja" (*core only*), berhenti di sini dan gunakan berkas ini sendirian sebagai filter. Jangan pasang modul tambahan apa pun.
|
|
37
42
|
3. **Penyelarasan Arah Desain** (hanya jika skill UI dipilih). Periksa keberadaan berkas `DESIGN.md` atau panduan merek/gaya eksplisit. Jika tidak ada, jujurlah bahwa slop-ai-indo adalah **filter, bukan pembuat keindahan**: tanpa arah desain, output cenderung monoton. Sarankan untuk memiliki `DESIGN.md`, lalu tawarkan opsi berikut:
|
|
@@ -43,13 +48,18 @@ Jika tidak ada blok penunjuk slop-ai-indo dan berkas ini sedang dibaca untuk per
|
|
|
43
48
|
```md
|
|
44
49
|
<!-- slop-ai-indo:start -->
|
|
45
50
|
## slop-ai-indo
|
|
46
|
-
Untuk pekerjaan UI, copy teks, aksesibilitas, layout mobile, komentar kode, atau
|
|
51
|
+
Untuk pekerjaan UI, copy teks, aksesibilitas, layout mobile, komentar kode, keamanan, backend, pengujian, atau efisiensi token, baca `slop-ai-indo.md` (inti) lalu skill yang relevan:
|
|
47
52
|
- UI / visual: `skills/slop-ai-indo-ui/SKILL.md`
|
|
48
53
|
- Copy & teks: `skills/slop-ai-indo-copywriting/SKILL.md`
|
|
49
54
|
- Aksesibilitas: `skills/slop-ai-indo-human/SKILL.md`
|
|
50
55
|
- Mobile / responsif: `skills/slop-ai-indo-layoutmobile/SKILL.md`
|
|
51
56
|
- Komentar kode: `skills/slop-ai-indo-code/SKILL.md`
|
|
52
57
|
- Audit keamanan: `skills/slop-ai-indo-security/SKILL.md`
|
|
58
|
+
- Backend & API: `skills/slop-ai-indo-backend/SKILL.md`
|
|
59
|
+
- Pengujian otomatis: `skills/slop-ai-indo-test/SKILL.md`
|
|
60
|
+
- Dokumentasi teknis: `skills/slop-ai-indo-docs/SKILL.md`
|
|
61
|
+
- Identitas produk: `skills/slop-ai-indo-identity/SKILL.md`
|
|
62
|
+
- Komunikasi ringkas & efisiensi token: `skills/slop-ai-indo-concise/SKILL.md`
|
|
53
63
|
Sebelum mulai, tanyakan pengguna kapan slop-ai-indo diterapkan: selama pengerjaan, atau setelah selesai.
|
|
54
64
|
Untuk memperbarui slop-ai-indo nanti: unduh ulang `slop-ai-indo.md`, jalankan `npx slop-ai-indo`, atau jalankan `npx skills add ynrlabs/slop-ai-indo`.
|
|
55
65
|
<!-- slop-ai-indo:end -->
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.4.0
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: slop-ai-indo-concise
|
|
3
|
+
description: "Efisiensi komunikasi dan token untuk AI coding agent: memangkas conversational slop, basa-basi AI, dan preamble berlebih dengan prinsip Say Less & Answer First tanpa mengurangi keakuratan teknis."
|
|
4
|
+
allowed-tools: Read Write Edit Glob Grep
|
|
5
|
+
---
|
|
6
|
+
# slop-ai-indo-concise
|
|
7
|
+
|
|
8
|
+
> Anti Slop: Aturan untuk AI Coding Agent. Skill Komunikasi Ringkas & Efisiensi Token
|
|
9
|
+
|
|
10
|
+
> Bagian dari sistem Slop AI Indo. Dibaca bersama dengan `slop-ai-indo.md` (inti). Skill ini menyaring kebiasaan model AI yang bertele-tele (*conversational slop*), memangkas pembuka basa-basi, pengulangan prompt, dan narasi hampa yang membuang kuota token dan mempersempit *context window*. Mengadopsi prinsip efisiensi token ala **Caveman** (*Say less, answer first, payload verbatim*) yang diselaraskan dengan standar profesional Senior Software Engineer.
|
|
11
|
+
|
|
12
|
+
## Cara Menggunakan Skill Ini
|
|
13
|
+
|
|
14
|
+
- Muat bersama `slop-ai-indo.md` pada setiap sesi interaktif untuk menjaga respon agent tetap padat, cepat, dan hemat biaya token.
|
|
15
|
+
- Setiap pola memuat: **Ciri (Tell)**, **Alasan (Why)**, dan **Solusi (Fix)**.
|
|
16
|
+
- **Prinsip Utama:** *Why many token when few do trick.* Hilangkan basa-basi obrolan, namun pertahankan keutuhan dan ketepatan kode program (*Payload Verbatim*).
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Pola Conversational Slop & Solusinya
|
|
21
|
+
|
|
22
|
+
### K-01: Basa-basi Pembuka & Pujian Kosong (Sycophancy & Polite Fluff)
|
|
23
|
+
|
|
24
|
+
- **Ciri:** Mengawali respon dengan frasa sanjungan atau penegasan yang tidak berguna:
|
|
25
|
+
- *"Tentu! Saya akan dengan senang hati membantu Anda mengimplementasikan..."*
|
|
26
|
+
- *"Pertanyaan yang sangat bagus sekali!..."*
|
|
27
|
+
- *"Sebagai asisten AI, tentu saya bisa memperbaiki error tersebut..."*
|
|
28
|
+
- *"Halo! Senang bertemu dengan Anda hari ini..."*
|
|
29
|
+
- **Alasan:** Membuang 30–70 token per prompt, memperlambat proses baca pengguna, dan memberikan kesan robotik yang klise.
|
|
30
|
+
- **Solusi:** **Nol Preamble.** Hapus seluruh kalimat pembuka. Langsung mulai jawaban dari baris pertama dengan fakta teknis atau tindakan yang diambil.
|
|
31
|
+
|
|
32
|
+
### K-02: Mengulang Pertanyaan / Prompt Pengguna (Echo & Recap Slop)
|
|
33
|
+
|
|
34
|
+
- **Ciri:** Memparafrasekan atau mengulang apa yang baru saja diketik pengguna:
|
|
35
|
+
- *"Anda meminta saya untuk membuat endpoint autentikasi menggunakan JWT di Express..."*
|
|
36
|
+
- *"Berdasarkan pesan Anda di atas yang menyebutkan ada error CORS pada React..."*
|
|
37
|
+
- **Alasan:** Pengguna sudah mengetahui apa yang mereka tanyakan. Mengulang prompt hanya menghabiskan context window dan membebani memori sesi secara sia-sia.
|
|
38
|
+
- **Solusi:** DILARANG mengulang permintaan pengguna. Langsung berikan diagnosis akar masalah atau solusi kode.
|
|
39
|
+
|
|
40
|
+
### K-03: Menimbun Inti Masalah di Belakang (Burying the Lede)
|
|
41
|
+
|
|
42
|
+
- **Ciri:** Menulis 3–5 paragraf penjelasan konseptual panjang lebar sebelum memperlihatkan baris kode atau solusi yang dicari.
|
|
43
|
+
- **Alasan:** Saat menghadapi bug atau pengerjaan fitur, developer membutuhkan perbaikan instan. Membaca teori panjang sebelum melihat kode memperlambat ritme kerja.
|
|
44
|
+
- **Solusi:** **Pola Answer First.** Strukturkan setiap respon teknis dengan urutan:
|
|
45
|
+
`[Akar Masalah Singkat] -> [Solusi Kode / Perintah] -> [Alasan Teknis Singkat] -> [Langkah Verifikasi]`.
|
|
46
|
+
|
|
47
|
+
### K-04: Obrolan Mengambang di Antara Tool Call (Chatter Between Actions)
|
|
48
|
+
|
|
49
|
+
- **Ciri:** Menulis status naratif sebelum setiap pemanggilan kakas:
|
|
50
|
+
- *"Sekarang saya akan melihat file package.json untuk memeriksa dependencies..."* (lalu memanggil view_file)
|
|
51
|
+
- *"Selanjutnya saya akan menjalankan grep untuk mencari fungsi userLogin..."* (lalu memanggil grep_search)
|
|
52
|
+
- **Alasan:** Antarmuka IDE / terminal sudah menampilkan indikator pemanggilan kakas (tool invocation). Teks naratif di antaranya hanya menambah latensi respon dan biaya token.
|
|
53
|
+
- **Solusi:** Eksekusi kakas secara langsung tanpa teks pengantar, kecuali terdapat keputusan arsitektur bercabang yang memerlukan konfirmasi eksplisit dari pengguna.
|
|
54
|
+
|
|
55
|
+
### K-05: Kode Terpotong / Placeholder Akal-akalan (Lazy Code Truncation)
|
|
56
|
+
|
|
57
|
+
- **Ciri:** Menghemat token dengan cara yang salah: memotong baris kode penting menggunakan komentar placeholder:
|
|
58
|
+
- `// ... sisa implementasi tetap sama ...`
|
|
59
|
+
- `/* logika bisnis ditaruh di sini */`
|
|
60
|
+
- `// kode lainnya...`
|
|
61
|
+
- **Alasan:** Ini adalah pemotongan semu. Kode yang tidak lengkap memaksa pengguna meminta perbaikan ulang, yang akhirnya justru menghabiskan token 2× lebih banyak dan merusak alur build.
|
|
62
|
+
- **Solusi:** **Payload Verbatim.** Baris kode, perintah terminal, query SQL, konfigurasi, dan diff WAJIB lengkap, presisi, dan siap dijalankan (*drop-in replacement*). Pangkas kata-kata penjelas, JANGAN memotong kode.
|
|
63
|
+
|
|
64
|
+
### K-06: Mengabaikan Penjelasan Keamanan & Operasi Berisiko (Unsafe Brevity)
|
|
65
|
+
|
|
66
|
+
- **Ciri:** Menyingkat respon secara ekstrem saat melakukan operasi destruktif atau menangani celah keamanan kritis, sehingga pengguna tidak menyadari bahayanya.
|
|
67
|
+
- **Alasan:** Keamanan data dan integritas sistem jauh lebih penting daripada menghemat 20 token output.
|
|
68
|
+
- **Solusi:** **Safety Valve (Katup Pengaman).** Untuk tindakan yang berpotensi menyebabkan *data loss* (misal `DROP TABLE`, `rm -rf`, `git reset --hard`, migrasi destruktif) atau audit celah kritis (seperti diatur pada `slop-ai-indo-security`), agen WAJIB menghentikan mode hemat kata ekstrem, menjelaskan risiko teknis secara eksplisit, dan meminta konfirmasi.
|
|
69
|
+
|
|
70
|
+
### K-07: Tata Bahasa Primitif yang Membingungkan (Broken Syntax Slop)
|
|
71
|
+
|
|
72
|
+
- **Ciri:** Memotong kalimat hingga strukturnya menjadi bahasa manusia purba yang rancu (*broken language*), ambigu, atau multi-tafsir.
|
|
73
|
+
- **Alasan:** Efisiensi token bukan berarti merusak tata bahasa. Ketidakjelasan konteks justru memicu miskomunikasi dan kesalahan perbaikan bug.
|
|
74
|
+
- **Solusi:** Gunakan **Bahasa Teknis Terkendali (Controlled Technical Language)**:
|
|
75
|
+
- Maksimal 15–20 kata per kalimat.
|
|
76
|
+
- Gunakan kalimat aktif dan subjek yang jelas.
|
|
77
|
+
- Hindari metafora atau kiasan.
|
|
78
|
+
- Satu kalimat = satu ide teknis.
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Format Standar Respon Cepat (Quick-Reply Matrix)
|
|
83
|
+
|
|
84
|
+
Gunakan pola ringkas berikut untuk interaksi rutin:
|
|
85
|
+
|
|
86
|
+
| Situasi | Contoh Format Respon (Hemat Token & Presisi) |
|
|
87
|
+
|---------|----------------------------------------------|
|
|
88
|
+
| **Perbaikan Bug** | `Akar masalah: null pointer pada user.profile. Solusi: opsional chaining user?.profile. Kode terlampir.` |
|
|
89
|
+
| **Pertanyaan Teknis** | `Gunakan useMemo jika komputasi berat (>1ms) atau referensi objek dipassing ke dependency array. Contoh:` |
|
|
90
|
+
| **Laporan Tugas Selesai** | `Selesai: 2 file diubah (AuthService.php, User.php). Verifikasi: php artisan test lulus 12/12.` |
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## Duet Efisiensi Token: slop-ai-indo + Caveman
|
|
95
|
+
|
|
96
|
+
Skill ini memangkas token pada level **instruksi obrolan (*Say Less*)**. Jika Anda ingin memangkas konsumsi token pada level **input & context window (*Read Less*)** (memotong ukuran log terminal, output pengujian, dan respon web):
|
|
97
|
+
|
|
98
|
+
Gunakan kakas pendamping resmi **Caveman** oleh Julius Brussee:
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# Tambahkan skill Caveman global
|
|
102
|
+
npx skills add JuliusBrussee/caveman -g
|
|
103
|
+
|
|
104
|
+
# Atau jalankan proxy otomatis Caveman CLI untuk agen Anda
|
|
105
|
+
npx @caveman-ai/cli@latest
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
*Duet ideal:*
|
|
109
|
+
* **slop-ai-indo:** Menjaga kebersihan kode, arsitektur kokoh, UI presisi, dan ketiadaan komentar/obrolan sampah.
|
|
110
|
+
* **Caveman:** Memotong volume data input (log, test dump) dan memandu efisiensi token sistemik.
|
package/slop-ai-indo.md
CHANGED
|
@@ -27,6 +27,11 @@ Jika tidak ada blok penunjuk slop-ai-indo dan berkas ini sedang dibaca untuk per
|
|
|
27
27
|
- **5. `slop-ai-indo-layoutmobile` (mobile / responsif):** pilih ini untuk tata letak yang harus beradaptasi mulus di berbagai ukuran layar: breakpoint, skala, grid, overflow, area sentuh.
|
|
28
28
|
- **6. `slop-ai-indo-code` (komentar kode):** pilih ini untuk merapikan komentar kode program: menghapus komentar klise AI, menjaga komentar penting, tanpa menyentuh logika kode.
|
|
29
29
|
- **7. `slop-ai-indo-security` (audit keamanan):** pilih ini untuk audit keamanan komprehensif, tinjauan kerentanan source-first, threat modeling, verifikasi sandbox terisolasi, dan remediasi keamanan defensif.
|
|
30
|
+
- **8. `slop-ai-indo-backend` (backend & API):** pilih ini untuk arsitektur server, API controller, sanitasi query database, dan error handling.
|
|
31
|
+
- **9. `slop-ai-indo-test` (pengujian otomatis):** pilih ini untuk pengujian otomatis, validasi skenario kegagalan nyata, dan anti fake mock.
|
|
32
|
+
- **10. `slop-ai-indo-docs` (dokumentasi teknis):** pilih ini untuk dokumentasi teknis, PRD, dan spesifikasi arsitektur bebas narasi hampa.
|
|
33
|
+
- **11. `slop-ai-indo-identity` (identitas produk):** pilih ini untuk menjaga karakter produk unik dan mencegah klon buta template populer.
|
|
34
|
+
- **12. `slop-ai-indo-concise` (komunikasi & hemat token):** pilih ini untuk memangkas obrolan basa-basi AI (*Say Less & Answer First* ala Caveman) dan menghemat biaya token tanpa memotong kelengkapan kode.
|
|
30
35
|
|
|
31
36
|
Jika pengguna menolak atau mengatakan "inti saja" (*core only*), berhenti di sini dan gunakan berkas ini sendirian sebagai filter. Jangan pasang modul tambahan apa pun.
|
|
32
37
|
3. **Penyelarasan Arah Desain** (hanya jika skill UI dipilih). Periksa keberadaan berkas `DESIGN.md` atau panduan merek/gaya eksplisit. Jika tidak ada, jujurlah bahwa slop-ai-indo adalah **filter, bukan pembuat keindahan**: tanpa arah desain, output cenderung monoton. Sarankan untuk memiliki `DESIGN.md`, lalu tawarkan opsi berikut:
|
|
@@ -38,13 +43,18 @@ Jika tidak ada blok penunjuk slop-ai-indo dan berkas ini sedang dibaca untuk per
|
|
|
38
43
|
```md
|
|
39
44
|
<!-- slop-ai-indo:start -->
|
|
40
45
|
## slop-ai-indo
|
|
41
|
-
Untuk pekerjaan UI, copy teks, aksesibilitas, layout mobile, komentar kode, atau
|
|
46
|
+
Untuk pekerjaan UI, copy teks, aksesibilitas, layout mobile, komentar kode, keamanan, backend, pengujian, atau efisiensi token, baca `slop-ai-indo.md` (inti) lalu skill yang relevan:
|
|
42
47
|
- UI / visual: `skills/slop-ai-indo-ui/SKILL.md`
|
|
43
48
|
- Copy & teks: `skills/slop-ai-indo-copywriting/SKILL.md`
|
|
44
49
|
- Aksesibilitas: `skills/slop-ai-indo-human/SKILL.md`
|
|
45
50
|
- Mobile / responsif: `skills/slop-ai-indo-layoutmobile/SKILL.md`
|
|
46
51
|
- Komentar kode: `skills/slop-ai-indo-code/SKILL.md`
|
|
47
52
|
- Audit keamanan: `skills/slop-ai-indo-security/SKILL.md`
|
|
53
|
+
- Backend & API: `skills/slop-ai-indo-backend/SKILL.md`
|
|
54
|
+
- Pengujian otomatis: `skills/slop-ai-indo-test/SKILL.md`
|
|
55
|
+
- Dokumentasi teknis: `skills/slop-ai-indo-docs/SKILL.md`
|
|
56
|
+
- Identitas produk: `skills/slop-ai-indo-identity/SKILL.md`
|
|
57
|
+
- Komunikasi ringkas & efisiensi token: `skills/slop-ai-indo-concise/SKILL.md`
|
|
48
58
|
Sebelum mulai, tanyakan pengguna kapan slop-ai-indo diterapkan: selama pengerjaan, atau setelah selesai.
|
|
49
59
|
Untuk memperbarui slop-ai-indo nanti: unduh ulang `slop-ai-indo.md`, jalankan `npx slop-ai-indo`, atau jalankan `npx skills add ynrlabs/slop-ai-indo`.
|
|
50
60
|
<!-- slop-ai-indo:end -->
|