From 653b619ea126ba2b4501458dfe35fea5c74b5ad3 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Mon, 24 Aug 2026 11:36:49 +0800 Subject: [PATCH] =?UTF-8?q?feat(wiki):=20wiki=20=E9=A0=81=E5=9E=8B?= =?UTF-8?q?=E5=85=81=E8=A8=B1=E6=B8=85=E5=96=AE=E6=96=B0=E5=A2=9E=20LEARN?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit What：gitea.sh 的 wiki-repo 允許型別清單、wiki 技能 SKILL.md 的頁型清單，以及 check-wiki-rules.sh 的驗證案例，同步收錄 LEARN 頁型。 Why：jsc-log 新增 LEARN wiki 頁型，若允許清單未收錄，wiki-repo LEARN 會以 unknown type（exit 2）被擋下，學習紀錄頁無法解析存放位置。 How：resolve_wiki_repo 的 case 白名單加入 LEARN，解析順序維持 JSC_WIKI_REPO_LEARN 優先、退回 JSC_WIKI_REPO、不跨型別代用；check-wiki-rules.sh 補上 LEARN 專屬變數優先與退回共用預設兩個案例；SKILL.md 允許頁型清單同步更新。 Who：jsc-gitea wiki 技能與其呼叫方（jsc-log 等）的 wiki 頁型解析功能。 Co-Authored-By: Claude Fable 5 --- skills/wiki/SKILL.md | 4 ++-- tools/check-wiki-rules.sh | 8 ++++++++ tools/gitea.sh | 4 ++-- 3 files changed, 12 insertions(+), 4 deletions(-) diff --git a/skills/wiki/SKILL.md b/skills/wiki/SKILL.md index 4f0b935..bc5792b 100644 --- a/skills/wiki/SKILL.md +++ b/skills/wiki/SKILL.md @@ -9,10 +9,10 @@ Every wiki operation in the jsc skill set goes through this skill. One entry poi ## Resolve the wiki location -Different page types can live in different `{owner}/{repo}` repos, classified by page-name prefix: `QUESTION`, `PLAN`, `ANALYZE`, `MAINTAIN`, `REPO`, `LOG`, `ERROR`. +Different page types can live in different `{owner}/{repo}` repos, classified by page-name prefix: `QUESTION`, `PLAN`, `ANALYZE`, `MAINTAIN`, `REPO`, `LOG`, `LEARN`, `ERROR`. 1. Before asking the user, inspect the current shell environment for the needed repo variables and Gitea connection variables: `JSC_WIKI_REPO_{TYPE}`, `JSC_WIKI_REPO`, `GITEA_HOST`, and `GITEA_TOKEN`. Use inherited shell values first; only ask when the needed repo cannot be resolved after that check. -2. Run `tools/gitea.sh wiki-repo {TYPE}` (TYPE = the page-name prefix). Allowed types are `QUESTION`, `PLAN`, `ANALYZE`, `MAINTAIN`, `REPO`, `LOG`, and `ERROR`. Resolution order is `JSC_WIKI_REPO_{TYPE}` first, then `JSC_WIKI_REPO`. Never borrow another type's repo. +2. Run `tools/gitea.sh wiki-repo {TYPE}` (TYPE = the page-name prefix). Allowed types are `QUESTION`, `PLAN`, `ANALYZE`, `MAINTAIN`, `REPO`, `LOG`, `LEARN`, and `ERROR`. Resolution order is `JSC_WIKI_REPO_{TYPE}` first, then `JSC_WIKI_REPO`. Never borrow another type's repo. 3. On exit 3 (neither is set after env inspection), ask the user for that page type's `{owner}/{repo}` per the `jsc-ask:ask` rules, and suggest setting `JSC_WIKI_REPO_{TYPE}` (can differ per type) or `JSC_WIKI_REPO` (shared default). ## Operations diff --git a/tools/check-wiki-rules.sh b/tools/check-wiki-rules.sh index 7f0301e..8b107fe 100755 --- a/tools/check-wiki-rules.sh +++ b/tools/check-wiki-rules.sh @@ -52,6 +52,14 @@ check_repo ANALYZE 'ANALYZE falls back to shared only' 'shared/wiki' \ JSC_WIKI_REPO_REPO='records/REPO' \ JSC_WIKI_REPO='shared/wiki' +check_repo LEARN 'LEARN specific wins' 'lessons/LEARN' \ + JSC_WIKI_REPO_LEARN='lessons/LEARN' \ + JSC_WIKI_REPO='shared/wiki' + +check_repo LEARN 'LEARN falls back to shared only' 'shared/wiki' \ + JSC_WIKI_REPO_LOG='records/LOG' \ + JSC_WIKI_REPO='shared/wiki' + check_repo ERROR 'ERROR uses its own repo' 'errors/wiki' \ JSC_WIKI_REPO_ERROR='errors/wiki' \ JSC_WIKI_REPO='shared/wiki' diff --git a/tools/gitea.sh b/tools/gitea.sh index 66cbaf8..d88206f 100755 --- a/tools/gitea.sh +++ b/tools/gitea.sh @@ -7,7 +7,7 @@ # gitea.sh clone-url / # 印出 clone URL # gitea.sh hash-id # 產生 8 碼大寫 SHA-1 hash；首碼為 0-9/A/B/C 時改成 Hxxxxxxx # gitea.sh wiki-repo # 解析頁面類型的 wiki 位置： -# TYPE = QUESTION|PLAN|ANALYZE|MAINTAIN|REPO|LOG|ERROR（即頁名前綴） +# TYPE = QUESTION|PLAN|ANALYZE|MAINTAIN|REPO|LOG|LEARN|ERROR（即頁名前綴） # 依序取 JSC_WIKI_REPO_{TYPE} > JSC_WIKI_REPO；不得跨類型代用；都未設定 exit 3 # gitea.sh wiki-list / # 列出 wiki 頁名 # gitea.sh wiki-get / # 印出 wiki 頁 markdown；不存在時 exit 4 @@ -27,7 +27,7 @@ script_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) resolve_wiki_repo() { # TYPE -> JSC_WIKI_REPO_{TYPE} -> JSC_WIKI_REPO type=$(printf '%s' "${1:?TYPE required}" | tr a-z A-Z) case "$type" in - QUESTION|PLAN|ANALYZE|MAINTAIN|REPO|LOG|ERROR) ;; + QUESTION|PLAN|ANALYZE|MAINTAIN|REPO|LOG|LEARN|ERROR) ;; *) echo "unknown wiki type: $type" >&2; exit 2 ;; esac eval "v=\${JSC_WIKI_REPO_${type}:-}"