nntrivi2001
add66c25bd
sg-md-writing thành skill bảo trì tri thức dự án cho AI: - Gộp hướng dẫn viết skill/subagent/hook (từ writing-agent-context) vào. - Bảng "đặt dòng ở đâu" theo chi phí nạp: root nạp mọi phiên; rule có `paths:`, CLAUDE.md của module, skill, docs chỉ nạp khi cần. - Chế độ sync: tự sửa đúng dòng .md bị sai trong cùng thay đổi, bump Last synced, chỉ hỏi ý định code không trả lời được (bỏ cổng xác nhận từng file, phỏng vấn từng câu, kiểm tra model yếu mỗi lần). - Bỏ khẳng định sai "subagent không tự nạp CLAUDE.md" và lối viết in hoa. 21,6 KB → 9,1 KB. sg-prompt-sharpening: tự lấp chỗ thiếu từ dự án, hiện bản prompt đã làm rõ (mục tiêu, ở đâu, xong khi, giả định) rồi làm; chỉ hỏi một câu (có đề xuất) khi các cách hiểu dẫn tới việc khác nhau; không kích hoạt với yêu cầu đã đủ rõ. Eval (claude plugin eval, 2 lượt/case, có skill vs không): - sharpening 3/3 (trước 2/3), Δ +0.67 - md-writing 5/5 (trước 1/5), Δ +0.40
85 lines
4.9 KiB
Markdown
85 lines
4.9 KiB
Markdown
# Smartgift Skills
|
|
|
|
Marketplace nội bộ chứa các skill Claude Code của Smartgift. Đăng ký marketplace một lần, rồi cài plugin theo vai trò.
|
|
|
|
## Plugin
|
|
|
|
| Plugin | Dành cho | Skill | Nội dung |
|
|
|---|---|---|---|
|
|
| `sg-all` | **Mặc định — ai muốn tất cả** | `sg-md-writing` + `sg-prompt-sharpening` | Gói cả hai skill. Cài một cái là có tất cả. |
|
|
| `sg-dev` | Team dev | `sg-md-writing` | Soạn & bảo trì tri thức dự án cho AI: `CLAUDE.md` / `AGENTS.md` / `.claude/rules`, skill, subagent. Ghi đúng điều code không tự nói được (ý định, bất biến, bản đồ tái sử dụng), đặt ở chỗ chỉ nạp khi cần để tiết kiệm token; khi code đổi thì tự sửa đúng dòng `.md` bị sai trong cùng thay đổi, chỉ hỏi ý định mà code không trả lời được. |
|
|
| `sg-common` | Chung | `sg-prompt-sharpening` | Yêu cầu gõ ngắn, thiếu thông tin → tự lấp chỗ thiếu từ dự án, hiện bản prompt đã làm rõ (mục tiêu, ở đâu, xong khi nào, giả định) rồi làm luôn; chỉ hỏi một câu khi các cách hiểu dẫn tới việc khác nhau. |
|
|
| `agenthub` | Ai muốn theo dõi session Claude Code | hooks + server + CLI | Dashboard local-first [AgentHub](https://git.smartgift.io.vn/Smartgift-AI/AgentHub). Source lấy trực tiếp từ repo đó (nhánh `main`), không phải code trong repo này. |
|
|
|
|
**Khuyến nghị: cài `sg-all`.** Đã cài `sg-all` thì **KHÔNG cần** cài thêm `sg-dev` hay `sg-common` — cài trùng sẽ nạp lặp skill. Chỉ cài `sg-dev`/`sg-common` riêng nếu có lý do muốn giới hạn phạm vi. `agenthub` là plugin độc lập (không phải skill), cài kèm `sg-all`/`sg-dev`/`sg-common` không xung đột.
|
|
|
|
## Cài đặt
|
|
|
|
```bash
|
|
# 1. Đăng ký marketplace (một lần) — cần đăng nhập gitea Smartgift
|
|
claude plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/smartgift-claude-skills.git
|
|
|
|
# 2. Nếu đã cài all thì không cần cài các plugin bên dưới
|
|
claude plugin install sg-all@sg
|
|
```
|
|
|
|
Nếu chỉ muốn cài một trong số các plugin thì hãy cài bằng lệnh dưới đây (nếu đã cài `sg-all` thì không cần cài bên dưới nữa):
|
|
|
|
```bash
|
|
claude plugin install sg-dev@sg # chỉ sg-md-writing
|
|
claude plugin install sg-common@sg # chỉ sg-prompt-sharpening
|
|
```
|
|
|
|
Xem: `claude plugin list`. Gỡ: `claude plugin uninstall sg-all@sg` (hoặc `sg-dev@sg` / `sg-common@sg` / `agenthub@sg` tùy plugin đã cài).
|
|
|
|
## Dashboard AgentHub
|
|
|
|
```bash
|
|
claude plugin install agenthub@sg
|
|
```
|
|
|
|
Yêu cầu trên máy cài:
|
|
|
|
| Cần | Vì sao |
|
|
|---|---|
|
|
| **Node >= 22.5** | Server dùng `node:sqlite`, bản cài qua plugin không có `better-sqlite3` native |
|
|
| **git** | Mọi thao tác lane (worktree, đọc branch/status) |
|
|
| **tmux** | Chỉ cần nếu muốn chạy Claude Code/Codex ngay trong trình duyệt hoặc dùng `agenthub lanes shell` — dashboard gọi thẳng binary `tmux`, không có bản dự phòng. Thiếu nó thì phần theo dõi session vẫn chạy bình thường, chỉ nút **Start Run** là lỗi |
|
|
|
|
```bash
|
|
sudo apt install git tmux # Ubuntu / Debian
|
|
brew install git tmux # macOS
|
|
```
|
|
|
|
Windows không có tmux native — chạy AgentHub trong WSL2 và cài tmux ở trong đó.
|
|
Cài xong chạy `/agenthub-doctor` để kiểm tra: dòng `tmux` sẽ báo `WARN` nếu thiếu.
|
|
|
|
Chi tiết bootstrap, các lệnh `/agenthub-doctor`
|
|
`/agenthub-update` `/agenthub-open`, và cách gỡ sạch: xem
|
|
[docs/PLUGINS.md của AgentHub](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/docs/PLUGINS.md).
|
|
|
|
> [!IMPORTANT]
|
|
> **Chỉ cài AgentHub từ MỘT marketplace.** Repo AgentHub cũng tự phát hành
|
|
> marketplace riêng của nó. Cài dashboard từ cả hai nơi sẽ chạy **hai bộ hook
|
|
> ingestion song song** — mỗi event vào database hai lần, token và cost bị đếm đôi.
|
|
> Chọn một đường.
|
|
>
|
|
> `sg` chỉ có bản dashboard đầy đủ (entry `agenthub` ở trên). 10 plugin con
|
|
> (`agenthub-analytics`, `agenthub-sessions`, `agenthub-workflows`, …) chỉ có ở
|
|
> marketplace riêng của AgentHub — cần thì add marketplace đó thay vì cài ở đây.
|
|
|
|
> Plugin này trước đây ở `sg` dưới tên `ccam`, trỏ vào repo cũ `Claude-Code-Monitor`.
|
|
> Entry đã đổi tên thành `agenthub` cho khớp `plugin.json` của nó, và URL trỏ thẳng
|
|
> vào tên repo mới (không còn dựa vào redirect của Gitea).
|
|
>
|
|
> **Nếu đang cài bản cũ:** lần `claude plugin marketplace update sg` tới, `ccam@sg`
|
|
> sẽ chuyển sang `✘ failed to load` trong `claude plugin list` (đúng như dự kiến —
|
|
> entry tên `ccam` không còn tồn tại), và **dashboard ngừng nhận event** cho tới khi
|
|
> bạn chuyển sang tên mới:
|
|
>
|
|
> ```bash
|
|
> claude plugin uninstall ccam@sg
|
|
> claude plugin marketplace update sg
|
|
> claude plugin install agenthub@sg
|
|
> ```
|