rootandClaude Sonnet 5.5
65bc192fae
- 新增 /jsc-wiki:book-search：上網蒐集主題並依頁面格式整理成草稿
- 新增 /jsc-wiki:book-import：判斷領域與章節，主題存在則修改、否則新增，
重建目錄與上下頁導覽，lint 後經確認再推送到 wiki
- 寫入工具以 TypeScript 實作（scripts/book.ts，入口 book.sh）
- 領域技能補上 allowed-tools，並改用 ${CLAUDE_PLUGIN_ROOT}，修正需手動核准而無法載入的問題
- 頁面格式新增兩條規則：簡化技術中文（STE100）、繁體中文無亂碼且盡量用圖表
- 版本升至 0.0.2
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
66 lines
3.2 KiB
Markdown
66 lines
3.2 KiB
Markdown
# jsc-wiki
|
||
|
||
讀取並擴充 [JSC 知識庫](https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace/wiki)（本 repo 的 wiki，一本書、八章），依領域提供指令，並可把網路上的知識整理後加入 wiki。讀取指令唯讀，第一次使用會 clone 到 `~/.cache/jsc-wiki`，之後每次先更新，離線時使用快取。
|
||
|
||
## 指令
|
||
|
||
### `/jsc-wiki:wiki [關鍵字]`
|
||
|
||
顯示目錄；給關鍵字則跨章搜尋並讀取最相關的頁面。
|
||
|
||
```text
|
||
/jsc-wiki:wiki traefik
|
||
```
|
||
|
||
### 依領域
|
||
|
||
| 指令 | 章 | 內容 |
|
||
| --- | --- | --- |
|
||
| `/jsc-wiki:system` | 1 系統維護 | 時區、磁碟延展、憑證、busybox、Kernel Panic |
|
||
| `/jsc-wiki:network` | 2 網路與儲存 | netplan、53 埠、SMB、TGT、OpenSSH、OpenWrt、DSM |
|
||
| `/jsc-wiki:virt` | 3 虛擬化 | Proxmox VE、直通、Hyper-V、WSL |
|
||
| `/jsc-wiki:container` | 4 容器與編排 | Docker、K3s、k3d、Traefik |
|
||
| `/jsc-wiki:database` | 5 資料庫與搜尋 | PostgreSQL、SQL Server、Redis、Elasticsearch |
|
||
| `/jsc-wiki:dev` | 6 開發與持續整合 | Gitea、Runner、GitLab、ASP.NET、Django、Coder |
|
||
| `/jsc-wiki:ai` | 7 AI 工具 | ccstatusline、CLIProxyAPI、OpenClaw、OpenCode、PicoClaw |
|
||
| `/jsc-wiki:apps` | 8 應用服務 | Emby、MeTube、Vaultwarden、ezBookkeeping |
|
||
|
||
不給主題時只列出該章篇目；給主題則讀取對應頁面回答。
|
||
|
||
```text
|
||
/jsc-wiki:database 怎麼安裝 PostgreSQL 並建立使用者
|
||
```
|
||
|
||
### `/jsc-wiki:book-search <主題>`
|
||
|
||
到網路蒐集主題的知識，交叉驗證後依頁面格式整理成草稿（`~/.cache/jsc-wiki/drafts/`）。只產生草稿，不修改 wiki。
|
||
|
||
```text
|
||
/jsc-wiki:book-search Caddy 在 Ubuntu 安裝與反向代理
|
||
```
|
||
|
||
### `/jsc-wiki:book-import <草稿路徑>`
|
||
|
||
把草稿加入 wiki：判斷知識領域與章節 → 主題已存在就修改該頁，否則新增 → 套用頁面格式 → 重建目錄與上下頁導覽 → lint → 你確認後推送。
|
||
|
||
```text
|
||
/jsc-wiki:book-import ~/.cache/jsc-wiki/drafts/caddy-ubuntu-reverse-proxy.md
|
||
```
|
||
|
||
推送需要 `tea` 的預設 login（或環境變數 `JSC_WIKI_TOKEN`）。寫入工具 `scripts/book.sh` 以 TypeScript（`book.ts`）實作，需要 Node 與 git；Node 不支援直接執行 TypeScript 時，會自動用 `npx tsx` 執行。
|
||
|
||
## 頁面格式
|
||
|
||
格式規則放在 wiki 的 [頁面格式](https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace/wiki/%E9%A0%81%E9%9D%A2%E6%A0%BC%E5%BC%8F) 頁，兩個技能都會讀取它。除了固定結構（簡介、步驟、補充），另有兩條規則：
|
||
|
||
1. 簡化技術中文：參考 [ASD-STE100 skill](https://github.com/danyuchn/asd-ste100-skill)，一句一個動作、祈使句、一詞一義、不用分號。
|
||
2. 繁體中文無亂碼，盡量用圖表（Mermaid 與表格）。
|
||
|
||
`scripts/book.sh lint` 會檢查編碼與亂碼、結構、密碼與 token、STE 規則和圖表。
|
||
|
||
## 設定
|
||
|
||
環境變數可選：`JSC_WIKI_URL`（wiki git 位址）、`JSC_WIKI_CACHE`（讀取用快取目錄）、`JSC_WIKI_WORK`（寫入用工作副本）、`JSC_WIKI_TOKEN`（推送用 token）。
|
||
|
||
新增一章時，`book.sh add-chapter` 只建立章節頁；對應的領域指令需自行在 `skills/` 新增（複製既有領域技能並改章號）。
|