菜单
Refresh snapshot dokumentasi GitHub (docs/awcms/github/) setelah issue/label/milestone/security alert berubah di GitHub. Gunakan sebelum audit/release, atau saat diminta menyinkronkan docs dengan state GitHub terbaru. Sesuai docs/awcms/github/README.md.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Triase dan perbaiki temuan CodeQL code scanning AWCMS (github.com/ahliweb/awcms/security/code-scanning). Gunakan saat diminta "analisis code scanning"/"perbaiki CodeQL", saat sebuah PR gagal check CodeQL, atau saat menemukan alert baru. Mendokumentasikan enam false-positive nyata yang sudah ditemukan (name-heuristic password, incompatible-types typeof/null, URL substring-sanitization di test mock, dua kasus dismiss resmi tanpa reformulasi kode, Bun.SQL tagged-template null-cast, dan build-time extension seam trivial-conditional) plus pola "unused-local-variable di test kadang menandai coverage gap", DAN satu counter-example trivial-conditional yang ternyata bug NYATA (dead-code fallback karena helper non-nullish, alert
Port sebuah modul/fitur yang sudah matang & teruji dari repo awcms-mini ke repo awcms secara atomic, adaptasi (bukan copy), sampai semua cek hijau + commit atomic. Gunakan saat diminta "port modul <X> dari mini", "terapkan fitur mini ke awcms", atau saat sebuah modul fondasi awcms-mini belum ada di awcms. Menegakkan kontrak alur mini-first (docs/awcms/alur-pengembangan-mini-first.md): rename prefix awcms_mini_→awcms_, penomoran migrasi lanjutan, drop dependensi/toolchain yang belum ada di awcms, dan verifikasi DoD.
Jalankan proses rilis AWCMS dengan Changesets. Gunakan saat diminta merilis versi, bump version, generate CHANGELOG, membuat tag vX.Y.Z, atau memeriksa changeset pending. Sesuai kebijakan SemVer doc 09.
BACAAN SAJA / HISTORIS (ADR-0034) — kontrak kesiapan ekstensi ERP base (`_shared/business-transaction-contract.ts`/`_shared/erp-reference-data-contract.ts`/`_shared/ports/period-lock-port.ts`) DAN jalur aplikasi-turunan yang skill ini asumsikan SUDAH DIHAPUS. ERP kini dibangun sebagai modul `domain` LANGSUNG di `src/modules/` (pola sama modul base lain), bukan repo turunan; file kontrak & fixture `example-erp-extension` yang dirujuk tidak lagi ada. Rujukan historis dari Issue
Audit dan perkuat backend & integrasi eksternal AWCMS (resiliensi, outbox, webhook/provider, versioning API, observability). Gunakan saat menambah/mengeraskan integrasi ke provider luar (R2, WhatsApp, email, AI, pajak), memperbaiki keandalan delivery, atau menaikkan ketahanan backend. Menegakkan ADR-0006 (provider opsional, di luar transaksi) dan pola outbox doc 16.
Scaffold modul baru pada modular monolith AWCMS. Gunakan saat membuat modul domain baru di src/modules/ (mis. warehouse-management, accounting-tax) atau saat memerlukan struktur module.ts + domain/application/infrastructure/api + README. Ikuti struktur standar doc 10 & 11.
| name | awcms-github-snapshot |
| description | Refresh snapshot dokumentasi GitHub (docs/awcms/github/) setelah issue/label/milestone/security alert berubah di GitHub. Gunakan sebelum audit/release, atau saat diminta menyinkronkan docs dengan state GitHub terbaru. Sesuai docs/awcms/github/README.md. |
Ikuti docs/awcms/github/README.md. Snapshot ini adalah salinan
faktual state GitHub (issue, label, milestone, security alert) — bukan
backlog rencana (itu tetap docs/awcms/06_github_issues_detail.md).
Recurring, sudah terjadi dua kali (epic blog_content #537-#540;
epic online public tenant routing #556-#560): PR di repo ini kadang tidak
menyertakan kata kunci Closes #NNN di body-nya, jadi merge PR tidak
otomatis menutup issue terkait — issue-nya tertinggal open di GitHub
walau kodenya sudah live di main. gh issue list --state open saja
tidak cukup untuk tahu backlog nyata (lihat memori
pr-body-missing-closes-keyword). Sebelum menjalankan refresh:
gh issue list --state open --limit 50 --json number,title
gh pr list --state merged --limit 30 --json number,title,mergedAt
Cocokkan tiap issue open dengan judul PR yang menyebut nomor issue itu
(pola judul di repo ini: ... (Issue #NNN)). Untuk setiap match yang
PR-nya sudah mergedAt terisi, tutup issue-nya manual dengan komentar
yang menyebut PR penutupnya, baru lanjut ke command refresh di bawah —
jangan biarkan refresh berjalan dengan open-issue count yang sebenarnya
sudah salah.
gh auth status
bun run github:snapshot:refresh # default repo ahliweb/awcms
scripts/github-snapshot-refresh.ts (Issue #464) meregenerasi bagian
mekanis lewat gh CLI (tidak pernah membaca/menyimpan token sendiri):
README.md, issues-open-001.md,
issues-closed-001.md, labels-milestones.md, security.md —
diganti utuh per baris.>= #433) diregenerasi penuh di antara marker
<!-- github-snapshot:NAME:start/end -->.README.md).issues-closed-001.md.labels-milestones.md.README.md (kolom Catatan
prose-heavy) — perbarui manual bila OPEN/CLOSED count berubah.Tinjau bagian-bagian ini manual setelah menjalankan script bila ada issue/label/milestone baru yang butuh konteks naratif.
Catatan (Issue #475): bila CodeQL run terbaru untuk main masih
in_progress/queued (mis. baru saja push/merge), baris "Latest CodeQL
run" di security.md sengaja tidak diperbarui — script mencetak
peringatan di console dan membiarkan nilai lama, bukan menebak status
run yang belum selesai sebagai Failure. Jalankan ulang script beberapa
menit kemudian bila baris itu perlu nilai terbaru.
flowchart LR
A[gh auth status] --> B[bun run github:snapshot:refresh]
B --> C[bun run format]
C --> D[bun run check:docs]
D --> E{Narasi manual perlu update?}
E -- Ya --> F[Edit bagian hand-written yang relevan]
E -- Tidak --> G[Commit]
F --> G
Ringkasan: file yang diperbarui, angka open/closed/label/milestone baru, dan daftar bagian manual yang perlu ditinjau (bila ada issue/label baru sejak snapshot terakhir).