docs: 使用說明移到技能 README，並寫進技能 README 範本避免重新產生時被覆蓋

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-15 08:39:26 +00:00
parent fb04b0fa23
commit bb68343e79
3 changed files with 50 additions and 23 deletions
@@ -6,23 +6,6 @@

 動漫助理：用喜愛角色的口吻和你互動，並在輸入框上方顯示單行狀態列（角色、模型、目錄、分支、5h／7d 剩餘額度、ctx、系統資源）。

-## 知識庫（wiki）
-
-啟動角色後可用：
-
- `/jsc-anima:anima-wiki <領域> <主題> [出處]`（下一行起為內容）：寫入 Gitea wiki，每次一個中文 commit，並更新 `Home` 目錄與 `_Sidebar`。領域與主題只能用英數與底線。
- `/jsc-anima:<領域>-<主題>`：讀取知識，指令在啟動時依 wiki 目錄註冊。
-
-讀寫都在 wiki，本機只做 10 分鐘快取，離線時沿用快取。認證優先讀 tea 登入，其次 `GITEA_TOKEN`，token 不寫入任何檔案。
-
-## 待辦事項
-
-啟動角色後可用 `/jsc-anima:anima-todo`（全域一份，記錄類型、時間、任務與所屬專案）：
-
- `add <類型> <YYYY-MM-DD> <HH:MM> <任務>`、`update <編號> …`、`list`、`done <編號>`
- 類型預設：提醒、開發、研究、維護；`type <名稱>` 新增自訂類型。
- session 開著時，到點由角色提醒（可在 /config 關閉）；你輸入 `run <編號>` 確認後才執行，結果由角色告知。
-
 ## 安裝

 ```
@@ -30,11 +13,6 @@ claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-anima.git
 claude plugin install jsc-anima
 ```

-## 使用
-
- `/jsc-anima:anima-extract <章節檔案路徑>`：從輕小說章節萃取作品與角色，依序確認代號與變更摘要後，寫入 `characters/<作品代號>/` 並對預設分支建立 PR（不自動合併）。
- `/jsc-anima:anima-extract paste <章節名稱>`（下一行起貼上章節內容）：不想存檔時直接貼上，之後流程相同。
-
 ## 更新

 ```
@@ -58,6 +58,33 @@ export const parseEntries = (readme: string): SkillEntry[] => {
 export const upsertEntry = (list: SkillEntry[], e: SkillEntry): SkillEntry[] =>
  [...list.filter(x => x.skill !== e.skill), e].sort((a, b) => a.skill.localeCompare(b.skill))

+// 固定的使用說明：重新產生技能 README 時要保留，不隨技能列表被覆蓋。
+const USAGE_SECTIONS = [
+  '## 角色與萃取',
+  '',
+  '- `/jsc-anima:anima-extract <章節檔案路徑>`：從輕小說章節萃取作品與角色，依序確認代號與變更摘要後，寫入 `characters/<作品代號>/` 並對預設分支建立 PR（不自動合併）。',
+  '- `/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 不寫入任何檔案。',
+  '',
+]
+
 // 技能 README：名稱 /jsc-anima:jsc-anima、技能列表（完整可複製指令）與範例。
 export const renderGuide = (list: SkillEntry[], example?: { skill: string; input: string }): string => {
  const ex = example ?? { skill: list[0]?.skill ?? 'example', input: '' }
@@ -80,6 +107,7 @@ export const renderGuide = (list: SkillEntry[], example?: { skill: string; input
    '',
    '產生新技能：`/jsc-anima:anima-skill <技能名稱> <描述>`，通過驗證與實跑後自動對預設分支建立 PR。',
    '',
+    ...USAGE_SECTIONS,
  ].join('\n')
 }

@@ -15,4 +15,25 @@

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

-待辦事項：`/jsc-anima:anima-todo add 提醒 2026-10-16 09:00 開會`，到點由角色提醒，`run <編號>` 確認後才執行。
+## 角色與萃取
+
+- `/jsc-anima:anima-extract <章節檔案路徑>`：從輕小說章節萃取作品與角色，依序確認代號與變更摘要後，寫入 `characters/<作品代號>/` 並對預設分支建立 PR（不自動合併）。
+- `/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 不寫入任何檔案。