prpm-dbp 0.2.1 → 0.2.2

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.
Files changed (2) hide show
  1. package/README.md +74 -4
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -31,21 +31,91 @@ Glosari itu dibina dengan mengikis dokumen kurikulum, bukan disemak seorang demi
31
31
 
32
32
  ## Pasang
33
33
 
34
- Tidak perlu pasang apa-apa untuk guna:
34
+ Ada tiga cara, ikut apa yang anda mahu.
35
+
36
+ ### 1. Cuba tanpa pasang
35
37
 
36
38
  ```bash
37
39
  npx prpm-dbp lookup sekolah
38
40
  ```
39
41
 
40
- Untuk pasang sebagai skill Claude Code:
42
+ Tiada apa yang dipasang. Sesuai untuk semakan sekali-sekala.
43
+
44
+ ### 2. Sebagai skill Claude Code (disyorkan)
41
45
 
42
46
  ```bash
43
- npx prpm-dbp install # salin ke ~/.claude/skills/prpm-dbp
44
- npx prpm-dbp install --link # symlink, untuk pembangun
47
+ npx skills add afu-it/prpm-dbp -g
48
+ ```
49
+
50
+ Ini memasang ke `~/.agents/skills/prpm-dbp` dan membuat symlink ke direktori skill agen anda, jadi Claude Code menemuinya sendiri. Ia juga direkod dalam fail kunci, yang membuatkan kemas kini kemudian menjadi satu arahan.
51
+
52
+ Tanggalkan `-g` untuk memasang ke projek semasa sahaja, bukan ke seluruh sistem.
53
+
54
+ Jika satu agen dalam senarai gagal (contohnya "PromptScript does not support global skill installation"), agen lain tetap dipasang. Untuk menyasarkan satu agen sahaja:
55
+
56
+ ```bash
57
+ npx skills add afu-it/prpm-dbp -g -a claude
58
+ ```
59
+
60
+ ### 3. Sebagai dependency projek
61
+
62
+ ```bash
63
+ npm install prpm-dbp
64
+ ```
65
+
66
+ ```js
67
+ import { lookup, loadCache, saveCache } from 'prpm-dbp'
45
68
  ```
46
69
 
47
70
  Perlu Node 18 ke atas. Tiada dependency.
48
71
 
72
+ ## Kemas kini
73
+
74
+ Jika dipasang melalui `npx skills`:
75
+
76
+ ```bash
77
+ npx skills update prpm-dbp -g -y
78
+ ```
79
+
80
+ Atau kemas kini semua skill sekali gus:
81
+
82
+ ```bash
83
+ npx skills update -g -y
84
+ ```
85
+
86
+ Jika dipasang sebagai dependency: `npm update prpm-dbp`.
87
+
88
+ Untuk `npx prpm-dbp`, tiada kemas kini diperlukan. npx mengambil versi terkini setiap kali.
89
+
90
+ Semak versi yang sedang dipasang:
91
+
92
+ ```bash
93
+ npx skills list | grep prpm-dbp
94
+ npm view prpm-dbp version
95
+ ```
96
+
97
+ ## Untuk penyelenggara
98
+
99
+ Sunting basecode, bukan salinan yang dipasang. Salinan itu ditulis ganti pada kemas kini berikutnya.
100
+
101
+ ```bash
102
+ # 1. sunting, uji
103
+ npm test
104
+
105
+ # 2. hantar
106
+ git add -A && git commit -m "..." && git push
107
+
108
+ # 3. naikkan versi dan lepaskan
109
+ npm version patch
110
+ git push origin main --follow-tags
111
+ ```
112
+
113
+ Langkah ketiga mencetuskan GitHub Actions, yang menerbitkan ke npm melalui Trusted Publishing. Tiada token disimpan, dan pakej dapat kenyataan provenance bertandatangan.
114
+
115
+ Gunakan `npm version` dan bukan menyunting `package.json` dengan tangan. Ia menghasilkan tag beranotasi; `git push --follow-tags` melangkau tag ringan secara senyap, dan pelepasan anda tidak akan berlaku.
116
+
117
+ Pengguna kemudian menarik versi baharu dengan `npx skills update`.
118
+
49
119
  ## Perintah
50
120
 
51
121
  | Perintah | Fungsi |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "prpm-dbp",
3
- "version": "0.2.1",
3
+ "version": "0.2.2",
4
4
  "description": "Semak ejaan Bahasa Melayu dan Jawi terhadap PRPM Dewan Bahasa dan Pustaka. CLI dan skill untuk AI agent.",
5
5
  "keywords": [
6
6
  "bahasa-melayu",