# /jsc-anima:jsc-anima

動漫助理的使用說明。先用 `/jsc-anima:{作品代號}-{角色代號}` 啟動角色，再使用下列技能。

## 技能列表

<!-- skills:start -->
<!-- skills:end -->

## 範例

```
/jsc-anima:anima-skill <技能名稱> <描述>
```

產生新技能：`/jsc-anima:anima-skill <技能名稱> <描述>`，通過驗證與實跑後自動對預設分支建立 PR。

## 角色與萃取

- `/jsc-anima:anima-extract <章節檔案路徑>`：從輕小說章節萃取作品與角色，依序確認代號與變更摘要後，寫入 `characters/<作品代號>/` 並對 jsc-anima repo 的預設分支建立 PR（不自動合併）。在任何專案目錄執行都一樣，檔案會寫進 `~/.cache/jsc-anima/repo` 的快取 clone；PR 合併並更新外掛、重開 Claude Code 後，用 `/jsc-anima:<作品代號>-<角色代號>` 啟動。
- `/jsc-anima:anima-extract paste <章節名稱>`（下一行起貼上章節內容）：不想存檔時直接貼上，之後流程相同。

## 待辦事項

啟動角色後可用 `/jsc-anima:anima-todo`（全域一份，記錄類型、時間、任務與所屬專案）：

- `add <類型> <YYYY-MM-DD> <HH:MM> <任務>`、`update <編號> …`、`list`、`done <編號>`
- 類型預設：提醒、開發、研究、維護；`type <名稱>` 新增自訂類型。
- 範例：`/jsc-anima:anima-todo add 提醒 2026-10-16 09:00 開會`
- session 開著時，到點由角色提醒（可在 /config 關閉）；輸入 `run <編號>` 確認後才執行，結果由角色告知。

## 知識庫（wiki）

啟動角色後可用：

- `/jsc-anima:anima-wiki <領域> <主題> [出處]`（下一行起為內容）：寫入 Gitea wiki，每次一個中文 commit，並更新 `Home` 目錄與 `_Sidebar`。領域與主題只能用英數與底線。
- `/jsc-anima:<領域>-<主題>`：讀取知識，指令在啟動時依 wiki 目錄註冊。

讀寫都在 wiki，本機只做 10 分鐘快取，離線時沿用快取。認證優先讀 tea 登入，其次 `GITEA_TOKEN`，token 不寫入任何檔案。