feat: jsc-wiki 新增 book-search、book-import,領域技能可直接使用
- 新增 /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>
This commit is contained in:
co-authored by
Claude Sonnet 5.5
parent
2c853c0e16
commit
65bc192fae
@@ -1,6 +1,6 @@
|
||||
# jsc-wiki
|
||||
|
||||
讀取 [JSC 知識庫](https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace/wiki)(本 repo 的 wiki,一本書、八章),依領域提供指令。內容唯讀,第一次使用會 clone 到 `~/.cache/jsc-wiki`,之後每次先更新,離線時使用快取。
|
||||
讀取並擴充 [JSC 知識庫](https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace/wiki)(本 repo 的 wiki,一本書、八章),依領域提供指令,並可把網路上的知識整理後加入 wiki。讀取指令唯讀,第一次使用會 clone 到 `~/.cache/jsc-wiki`,之後每次先更新,離線時使用快取。
|
||||
|
||||
## 指令
|
||||
|
||||
@@ -31,6 +31,35 @@
|
||||
/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_URL`(wiki git 位址)、`JSC_WIKI_CACHE`(讀取用快取目錄)、`JSC_WIKI_WORK`(寫入用工作副本)、`JSC_WIKI_TOKEN`(推送用 token)。
|
||||
|
||||
新增一章時,`book.sh add-chapter` 只建立章節頁;對應的領域指令需自行在 `skills/` 新增(複製既有領域技能並改章號)。
|
||||
|
||||
Reference in New Issue
Block a user