From bb68343e79c74757cc57087c443e8bb2d50bb337 Mon Sep 17 00:00:00 2001 From: root Date: Thu, 15 Oct 2026 08:39:26 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BD=BF=E7=94=A8=E8=AA=AA=E6=98=8E?= =?UTF-8?q?=E7=A7=BB=E5=88=B0=E6=8A=80=E8=83=BD=20README=EF=BC=8C=E4=B8=A6?= =?UTF-8?q?=E5=AF=AB=E9=80=B2=E6=8A=80=E8=83=BD=20README=20=E7=AF=84?= =?UTF-8?q?=E6=9C=AC=E9=81=BF=E5=85=8D=E9=87=8D=E6=96=B0=E7=94=A2=E7=94=9F?= =?UTF-8?q?=E6=99=82=E8=A2=AB=E8=A6=86=E8=93=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 5.5 --- README.md | 22 ---------------------- hooks/skillgen.ts | 28 ++++++++++++++++++++++++++++ skills/jsc-anima/README.md | 23 ++++++++++++++++++++++- 3 files changed, 50 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 6a306a6..ff19c0e 100644 --- a/README.md +++ b/README.md @@ -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 <類型> <任務>`、`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 <章節名稱>`（下一行起貼上章節內容）：不想存檔時直接貼上，之後流程相同。 - ## 更新 ``` diff --git a/hooks/skillgen.ts b/hooks/skillgen.ts index adeb059..fd649c8 100644 --- a/hooks/skillgen.ts +++ b/hooks/skillgen.ts @@ -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 <類型> <任務>`、`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') } diff --git a/skills/jsc-anima/README.md b/skills/jsc-anima/README.md index 12aff9a..89fdacb 100644 --- a/skills/jsc-anima/README.md +++ b/skills/jsc-anima/README.md @@ -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 <類型> <任務>`、`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 不寫入任何檔案。