| name | custom_project_skill |
| description | Mandatory context skill. Read this automatically at the beginning of any task related to [Your Project Keywords] to understand the core formulas and boundaries.
|
Custom Project Skill
Deskripsi Proyek
Referensikan file gemini.md untuk identitas mahasiswa, judul skripsi, dan institusi.
Each time a new AI session begins, the MANDATORY first step is to follow the Hybrid Context Protocol:
- Read
supportFiles/PROMPT_TEMPLATE.md for the session start sequence.
- Load
supportFiles/handoff.md to understand the latest project state and prose drafts.
- Cross-reference
papers/index.md and supportFiles/ANTI_HALLUCINATION.md for valid technical citations.
Failure to load these files will result in context drift and potential hallucinations.
โ ๏ธ Mandatory Integrity & Onboarding Check
Setiap kali sesi dimulai, AI WAJIB melakukan pengecekan integritas berikut sebelum melakukan tugas teknis apa pun:
- Placeholder Check: Periksa apakah
gemini.md masih mengandung [Nama Anda], atau scripts/sync_word.ps1 masih mengandung [PASTE_...].
- Infrastructure Check: Baca
supportFiles/ACTION_PLAN.md. Periksa apakah semua item di "Phase 0: Infrastructure" (termasuk poin 0.5 dan 0.6) sudah terceklis [x].
- Citation Guard: Sebelum menulis draf bab, AI WAJIB memverifikasi apakah referensi yang akan digunakan sudah terdaftar di
supportFiles/ANTI_HALLUCINATION.md.
Protokol Pemblokiran:
- Jika poin 1 atau 2 belum terpenuhi secara nyata (cek isi filenya!), AI DILARANG melakukan penulisan draf akademik atau eksperimen tingkat lanjut.
- AI harus segera menginterupsi dengan sapaan: "Mohon maaf, saya mendeteksi konfigurasi jalur OneDrive atau daftar referensi utama (Phase 0) belum siap. Mari kita tuntaskan konfigurasi di
sync_word.ps1 dan ANTI_HALLUCINATION.md terlebih dahulu."
Otomasi Onboarding: Jika AI mendeteksi file .docx atau .pdf baru di folder example/, AI WAJIB menawarkan untuk menjalankan scripts/extract_docx.py atau scripts/extract_pdfs.py untuk mempelajari gaya bahasa user.
๐บ๏ธ Smart Auto-Routing System (WAJIB DIIKUTI)
Ketika user TIDAK menyebut nama file tujuan secara eksplisit, AI wajib menggunakan tabel routing di bawah ini untuk menentukan ke mana konten harus ditulis atau disimpan. Jangan pernah hanya mencetak ke chat tanpa menawarkan untuk menyimpan ke file yang tepat.
Intent-to-File Routing Table
| Jika user meminta/terdeteksi... | Intent / Sifat Konten | Tulis ke file ini | Aksi setelah menulis |
|---|
| Menjelaskan Teori/Ide | Konseptual, Definisi, "Bagaimana cara kerja X?" | intelligence/konsep/ | Buat file .md & link ke [[_INDEX_KONSEP]] |
| Mengekstrak Paper | Literatur, "Apa kata paper A?", Metrik | intelligence/ringkasan_paper/ | Buat file .md & link ke [[_INDEX_PAPER]] |
| Mendefinisikan Istilah | Glosarium, "X maksudnya adalah...", Singkatan | intelligence/glosarium.md | Update tabel Glosarium & Link di catatan lain |
| Menemukan Alur/Rumus | Teknikal, "Gunakan rumus Y", "Alur risetnya Z" | intelligence/metodologi/ | Buat file .md & link ke [[_INDEX_METODE]] |
| Mencari Info Bersama | Riset web, "Tolong cari X", Snippet eksternal | intelligence/catatan_web/ | Simpan sebagai "Web Clipping" di folder web |
| Eksternal Deep Research | "pakai notebooklm", "riset mendalam ke google" | .agents/workflows/use-notebooklm.md | Panggil workflow /use-notebooklm |
| Merubah Strategi | Keputusan, "Ganti ke metode B", "Ubah dataset" | supportFiles/decisions_log.md | Catat tanggal & alasan perubahan |
๐ง Proactive Knowledge Detection (SANGAT PENTING)
Asisten tidak boleh pasif menunggu keyword. Asisten WAJIB menawarkan diri untuk menulis ke Wiki jika mendeteksi kondisi berikut:
- "New Knowledge Nugget": Jika ada penjelasan teknis atau konseptual yang panjang di chat yang belum ada di Wiki.
- Prompt: "Penjelasan mengenai [Konsep X] tadi cukup mendalam. Izinkan saya merapikannya ke dalam
[[intelligence/konsep/Konsep_X]] agar terdokumentasi di Obsidian Anda?"
- "Methodological Nuance": Jika user menjelaskan detail konfigurasi eksperimen atau alasan di balik pemilihan variabel tertentu.
- Prompt: "Logika pemilihan [Metode Y] yang Anda jelaskan sangat krusial. Saya akan mencatatnya di
[[metodologi/_INDEX_METODE]] sebagai referensi Bab 3 nanti."
- "Context Shift": Jika user mulai membahas topik baru yang berpotensi menjadi Bab atau Sub-bab baru.
- Prompt: "Sepertinya kita mulai masuk ke ranah [Topik Baru]. Apakah Anda ingin saya membuatkan folder khusus untuk topik ini di Wiki?"
- "Literature Gap": Jika asisten kehabisan referensi lokal saat drafting.
- Prompt: "Saya kekurangan literatur terkini soal ini. Anda ingin mencoba
/use-notebooklm? Saya bisa buatkan prompt pencariannya sekarang."
๐ ๏ธ Obsidian Vault Maintenance (WAJIB DIIKUTI)
Asisten wajib mengikuti kaidah Obsidian agar Wiki ini fungsional dan interaktif:
- Gunakan Wikilinks: Gunakan format
[[Nama File]] untuk semua link internal antar catatan di folder intelligence/.
- YAML Frontmatter: Setiap file baru di folder
intelligence/ wajib memiliki header YAML:
---
title: [Judul]
tags: [tag1, tag2]
last_updated: [YYYY-MM-DD]
---
- Indexing Otomatis: Setiap kali membuat catatan baru di salah satu sub-folder
intelligence/, asisten WAJIB menambahkan link ke catatan tersebut di file _INDEX.md yang relevan.
- Bahasa Indonesia: Khusus di dalam folder
intelligence/, seluruh konten penjelasan wajib menggunakan Bahasa Indonesia yang formal namun mudah dipahami.
Aturan Routing
- Sebelum menulis, konfirmasi dengan cepat: "Saya akan menyimpan ini ke
[nama file]. Lanjut?"
- Jika file belum ada, buat file baru sesuai tabel di atas โ jangan tulis di chat saja.
- MANDATORY SYNC: Setiap kali menulis draf akademik (Bab 1-5), asisten WAJIB menyimpan salinan draf/poin tersebut ke
supportFiles/handoff.md di bawah section ## Current Text Drafts. Ini krusial agar memori aktif tetap terjaga antar sesi.
- Setelah menulis konten bab apapun, selalu update
supportFiles/handoff.md bagian status bab.
- TIDAK BOLEH hanya mencetak draf di chat. Jika user tidak menolak, langsung simpan ke kedua lokasi (Fail Bab + Handoff).
- Jika trigger ambigu (tidak ada di tabel), tanyakan user: "Apakah output ini ingin disimpan ke file tertentu, atau cukup di chat saja?"
Alur Penelitian (Research Workflow)
graph TD
A["[Tahap 1: Persiapan]"] --> B["[Tahap 2: Pengumpulan Data]"]
B --> C["[Tahap 3: Analisis/Eksperimen]"]
C --> D["[Tahap 4: Hasil & Pembahasan]"]
| Komponen | Detail |
|---|
| Algoritma / Model Utama | Lihat gemini.md |
| Dataset baseline | Lihat gemini.md |
| Metode / Pendekatan | Lihat gemini.md |
| Framework | Lihat gemini.md |
| Hardware target | Lihat gemini.md |
Core Research Logic
| Feature | Mandatory Specification |
|---|
| Research Focus | Dummy System Implementation |
| Primary Methodology | Dummy Testing |
Aturan & Batasan Penting (Wajib Dipatuhi)
โ ๏ธ Constraints Utama
- โ TIDAK menggunakan metode di luar scope: [Cakupan Batasan].
- โ TIDAK menggunakan framework lain selain yang disepakati.
๐ Hybrid Language & Writing Standards
- Language Protocol:
- English (๐ฌ๐ง): All AI-facing instructions, technical definitions, and thesis prose drafts.
- Indonesian (๐ฎ๐ฉ): Summary logs, user-facing guides, and general communication.
- Prose Standards (MANDATORY):
- Typography: Strictly NO em-dash (
โ). Use LaTeX for math.
- Paragraph Structure: Follow the pattern [Topic Sentence โ Support โ Transition/Synthesis โ
[Citation]].
- No Bullet Points: Prose drafts must be in flowing paragraphs, NOT bullet lists.
- Focus: Focus on findings/methodology, not authors (e.g., "AI is used [1]" instead of "According to Smith [1]").
- Tone: Formal academic tone. Dilarang menggunakan "I", "we", or "our".
- Anti-AI Signature: Avoid overused AI transitions like "Furthermore", "In conclusion", "Moreover".
- Citations: Strictly use
[Name_Year] format during drafting (e.g., [Smith_2023]). This ensures consistency with Mendeley/Zotero and avoids numbering shift issues. Use [CITATION NEEDED] if a source is missing.
- Styling: Use italic only for foreign non-English terms (e.g., et al.).
- Quality Control (Self-Audit):
- AI wajib melakukan pengecekan mandiri menggunakan logika
scripts/prose_auditor.py sebelum menyerahkan draf akhir bab kepada user.
- Pastikan tidak ada karakter terlarang (
โ) dan semua sitasi sudah terdaftar di ANTI_HALLUCINATION.md.
Referensi Paper Utama
| Paper | Kontribusi ke Proyek |
|---|
| [Paper 1] | [Kontribusi] |
| [Paper 2] | [Kontribusi] |
Terminologi yang Benar
| โ Jangan Tulis | โ
Tulis Ini | Alasan |
|---|
| "[Kata Salah]" | "[Kata Benar]" | [Alasan koreksi] |
Pengelolaan Support Files
Update Wajib Setelah Setiap Sesi
Setelah menyelesaikan pekerjaan signifikan, AI wajib memperbarui:
handoff.md โ update status stage, pending actions, last session summarydecisions_log.md โ tambahkan keputusan baru yang dibuat dalam sesi ini
Template Update handoff.md
## Last Session Summary (YYYY-MM-DD)
- [Apa yang dikerjakan]
- [Hasil yang dicapai]
- [File yang dibuat/dimodifikasi]
โจ Academic Document Standards (MANDATORY)
Setiap kali melakukan ekspor ke format Word (.docx), asisten WAJIB menggunakan file template berikut sebagai basis (Seed Document) untuk menjaga konsistensi penomoran BAB dan Sub-bab:
- Template Path:
.agents/resources/academic_template.docx
- Aturan Pemetaan Gaya:
- BAB / Judul Bab โ Gunakan gaya
Heading 1 (Format otomatis: BAB I, BAB II, dst).
- Sub-bab (Level 1) โ Gunakan gaya
Heading 2 (Format otomatis: 1.1, 1.2, dst).
- Sub-bab (Level 2) โ Gunakan gaya
Heading 3 (Format otomatis: 1.1.1, dst).
- Isi Draf โ Gunakan gaya
Normal.
- Tabel โ Gunakan gaya tabel
Table Grid.
๐ ๏ธ Script Helper & Utilities (WAJIB TAHU)
Berikut adalah daftar skrip alat bantu yang sudah tertanam di scripts/. AI wajib menawarkan atau langsung mengeksekusi skrip ini menggunakan run_command jika konteks percakapan sesuai:
| Nama Skrip | Kapan AI harus menggunakannya? | Perintah Terminasi (Gunakan rtc atau python) |
|---|
scripts/extract_pdfs.py | Saat user punya file .pdf baru di folder papers/ dan meminta AI membacanya. Skrip ini akan mengubahnya menjadi teks di supportFiles/extracted_pdfs/ agar AI bisa membacanya tanpa modul tambahan. | python scripts/extract_pdfs.py |
docx skill | Skill otomatis (built-in) untuk membaca, mengedit, dan memanipulasi file Word .docx secara profesional. | Otomatis aktif saat membahas file .docx |
scripts/docx_surgery.py | Jika user/AI ingin melakukan "bedah" XML pada file Word (unpack/pack) untuk memperbaiki format yang rusak. | python scripts/docx_surgery.py |
scripts/extract_docx.py | Jika user meminta secara spesifik untuk mengekstrak dokumen Word ke dalam format Markdown (.md). | python scripts/extract_docx.py [file.docx] [file.md] |
scripts/sync_word.ps1 | Jika user melaporkan "Saya baru menulis di Word OneDrive saya, tolong sinkronkan." Skrip ini akan menyedot draf Word cloud ke repositori lokal secara otomatis. | powershell scripts/sync_word.ps1 |
scripts/convert_citations.py | Jika user ingin merapikan draf handoff.md yang menggunakan sitasi "[1]" menjadi format "[Author_Year]" menggunakan kamus JSON. Format wajib sebelum dipublish! | python scripts/convert_citations.py |
scripts/prose_auditor.py | Digunakan untuk audit kualitas bahasa akademik dan integritas sitasi sebelum draf dipindah ke Word. | python scripts/prose_auditor.py |
๐ Venv Awareness Protocol (Seamless Execution)
Untuk menjalankan skrip Python di atas, asisten wajib menggunakan executable Python dari virtual environment yang sudah dicatat:
- Check Config: Selalu baca file
supportFiles/.venv_config.txt untuk mendapatkan path absolut ke python.exe.
- Execution: Gunakan path tersebut secara eksplisit saat menjalankan perintah melalui
run_command (misalnya: & "C:\Users\[User_Name]\thesis_venv\Scripts\python.exe" scripts/prose_auditor.py).
- Fallback: Jika file config tidak ada, asisten harus meminta user menjalankan
.\scripts\setup_env.ps1 terlebih dahulu.
Kontak & Konteks
- Lihat
gemini.md untuk detail identitas mahasiswa, hardware, dan bahasa komunikasi.
