ai-spector 0.8.63 → 0.8.65
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 +28 -2
- package/README.vi.md +29 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -49,6 +49,25 @@ Creates:
|
|
|
49
49
|
- **Claude Code:** `CLAUDE.md` + `.claude/skills/` + `.mcp.json`
|
|
50
50
|
- Pre-commit hook (when git is available)
|
|
51
51
|
|
|
52
|
+
### Upgrade (refresh skills & rules)
|
|
53
|
+
|
|
54
|
+
After installing a newer `ai-spector` version, refresh the editor scaffold from the package. This updates skills and rules only — it does **not** touch `.ai-spector/`, your graph, or `docs/`.
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
npm install ai-spector@latest # public npm; add --registry … for Verdaccio
|
|
58
|
+
npx ai-spector sync-cursor # Cursor → .cursor/skills/, .cursor/rules/
|
|
59
|
+
npx ai-spector sync-claude # Claude Code → CLAUDE.md, .claude/skills/
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Then **reload MCP** in your editor (`.cursor/mcp.json` or `.mcp.json`).
|
|
63
|
+
|
|
64
|
+
In chat you can also say **“sync ai-spector cursor skills”** or **“sync ai-spector claude skills”**.
|
|
65
|
+
|
|
66
|
+
| Command | What it updates |
|
|
67
|
+
|---------|-----------------|
|
|
68
|
+
| `sync-cursor` | Cursor skills, routing rules, `WORKFLOW.md` under `.cursor/` |
|
|
69
|
+
| `sync-claude` | `CLAUDE.md`, Claude skills and rules under `.claude/` |
|
|
70
|
+
|
|
52
71
|
### Step 2 — Finish setup in chat
|
|
53
72
|
|
|
54
73
|
```text
|
|
@@ -180,8 +199,7 @@ Full list: `npx ai-spector --help`.
|
|
|
180
199
|
| Validate errors after edits | **“re-index the graph”** |
|
|
181
200
|
| Pre-commit hook missing | **“install ai-spector git hook”** |
|
|
182
201
|
| Agent stuck on CLI error | `.cursor/skills/ai-spector/references/cli-failures.md` |
|
|
183
|
-
|
|
184
|
-
After upgrading: reload MCP; run **`npx ai-spector sync-cursor`** (Cursor) or **`npx ai-spector sync-claude`** (Claude Code) if scaffold skills changed.
|
|
202
|
+
| Stale skills after upgrade | [Upgrade (refresh skills & rules)](#upgrade-refresh-skills--rules) — `sync-cursor` / `sync-claude`, then reload MCP |
|
|
185
203
|
|
|
186
204
|
---
|
|
187
205
|
|
|
@@ -252,4 +270,12 @@ npm version patch --no-git-tag-version # or minor | major
|
|
|
252
270
|
|
|
253
271
|
`prepublishOnly` runs `npm run build` automatically before publish — fix build errors before retrying.
|
|
254
272
|
|
|
273
|
+
Publish is implemented in **`scripts/deploy.sh`** (`npm run deploy` / `npm run deploy:npm`). Edit that script for registry URLs, auth prompts, or bump behavior.
|
|
274
|
+
|
|
275
|
+
**Update scaffold bundles** (after editing `scaffold/cursor/`):
|
|
276
|
+
|
|
277
|
+
```bash
|
|
278
|
+
npm run build:claude-scaffold # regenerate scaffold/claude/ from scaffold/cursor/
|
|
279
|
+
```
|
|
280
|
+
|
|
255
281
|
MIT — [LICENSE](LICENSE).
|
package/README.vi.md
CHANGED
|
@@ -51,6 +51,25 @@ Sau khi chạy xong sẽ có:
|
|
|
51
51
|
- **Claude Code:** `CLAUDE.md` + `.claude/skills/` + `.mcp.json`
|
|
52
52
|
- Hook git trước khi commit *(nếu project có git)*
|
|
53
53
|
|
|
54
|
+
### Nâng cấp (cập nhật skills & rules)
|
|
55
|
+
|
|
56
|
+
Sau khi cài phiên bản `ai-spector` mới, refresh scaffold từ gói. Chỉ cập nhật skills và rules — **không** ghi đè `.ai-spector/`, graph, hay `docs/`.
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
npm install ai-spector@latest # npm công khai; thêm --registry … cho Verdaccio
|
|
60
|
+
npx ai-spector sync-cursor # Cursor → .cursor/skills/, .cursor/rules/
|
|
61
|
+
npx ai-spector sync-claude # Claude Code → CLAUDE.md, .claude/skills/
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Sau đó **reload MCP** (`.cursor/mcp.json` hoặc `.mcp.json`).
|
|
65
|
+
|
|
66
|
+
Trong chat: **"sync ai-spector cursor skills"** hoặc **"sync ai-spector claude skills"**.
|
|
67
|
+
|
|
68
|
+
| Lệnh | Cập nhật |
|
|
69
|
+
|------|----------|
|
|
70
|
+
| `sync-cursor` | Skills, rules, `WORKFLOW.md` trong `.cursor/` |
|
|
71
|
+
| `sync-claude` | `CLAUDE.md`, skills và rules trong `.claude/` |
|
|
72
|
+
|
|
54
73
|
---
|
|
55
74
|
|
|
56
75
|
### Bước 2 — Hoàn tất setup trong chat
|
|
@@ -117,13 +136,12 @@ Trong chat:
|
|
|
117
136
|
|
|
118
137
|
```text
|
|
119
138
|
add Claude Code support to ai-spector
|
|
139
|
+
add Cursor support to ai-spector
|
|
120
140
|
sync ai-spector cursor skills
|
|
121
141
|
sync ai-spector claude skills
|
|
122
142
|
```
|
|
123
143
|
|
|
124
|
-
|
|
125
|
-
- **Cursor:** `npx ai-spector sync-cursor` hoặc gõ **"sync ai-spector cursor skills"** trong chat
|
|
126
|
-
- **Claude Code:** `npx ai-spector sync-claude` hoặc gõ **"sync ai-spector claude skills"** trong chat
|
|
144
|
+
Hoặc chạy `npx ai-spector sync-cursor` / `sync-claude` — xem [Nâng cấp](#nâng-cấp-cập-nhật-skills--rules) ở trên.
|
|
127
145
|
|
|
128
146
|
---
|
|
129
147
|
|
|
@@ -273,4 +291,12 @@ npm version patch --no-git-tag-version # hoặc minor | major
|
|
|
273
291
|
|
|
274
292
|
`prepublishOnly` tự chạy `npm run build` trước publish — sửa lỗi build rồi thử lại.
|
|
275
293
|
|
|
294
|
+
Script publish nằm ở **`scripts/deploy.sh`** (`npm run deploy` / `npm run deploy:npm`). Sửa file đó nếu cần đổi registry, auth, hoặc logic bump version.
|
|
295
|
+
|
|
296
|
+
**Cập nhật scaffold** (sau khi sửa `scaffold/cursor/`):
|
|
297
|
+
|
|
298
|
+
```bash
|
|
299
|
+
npm run build:claude-scaffold # tạo lại scaffold/claude/ từ scaffold/cursor/
|
|
300
|
+
```
|
|
301
|
+
|
|
276
302
|
MIT — [LICENSE](LICENSE).
|
package/package.json
CHANGED