feat/marketplace-first-skill-ops-and-skillset-update #3

2026-08-21T08:24:03Z

jiantw83 commented

2026-08-21 08:24:03 +00:00

摘要

需求描述：依使用者規則強化 jsc-meta 技能組管理流程——（1）skill-update 與 skill-delete 改為先查 Gitea 正本 marketplace（plugins/jsc）取得權威 domain 清單，缺少的 domain repo 先 clone 再列出技能；（2）skill-new 遇到 Gitea 已有但本機缺少的 domain repo 時改為 clone 既有 repo，不再重建；（3）skill-delete 新增深度刪除驗證——由 sub agent 實地檢查每個已安裝 CLI 的技能與 hook 保存位置，確認無殘留；（4）guidelines.md 補記 gitea.sh 在 token 未設定或 401／403 時自動改用 tea 登入金鑰的備援機制；（5）新增 skillset-update 技能，把一份變更需求批次套用到整個技能組，每個受影響 domain 各派一個 sub agent、每個 repo 各開一個 PR；（6）README「Skills 目錄」同步；（7）三份 manifest 版本 0.0.1 → 0.0.2。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
skills/skill-update/SKILL.md	流程改為先查 Gitea 正本 marketplace 取得 domain 清單、補 clone 缺少的 repo 再列出技能；description 與步驟編號同步更新
skills/skill-delete/SKILL.md	同上 marketplace 先行；另新增第 7 步深度刪除驗證——sub agent 實地檢查各已安裝 CLI 的技能與 hook 保存位置，確認無殘留
skills/skill-new/SKILL.md	domain 在 Gitea 已存在但本機缺少時改為 clone 既有 repo 後續行，不再重建
skills/skillset-update/SKILL.md	新增技能：一份變更需求套用到整個技能組，逐受影響 domain 派 sub agent、逐 repo 開 PR
README.md	「Skills 目錄」同步：更新 skill-update 與 skill-delete 的流程描述，新增 skillset-update 條目
references/guidelines.md	補記 gitea.sh 的 tea 登入金鑰備援；GITEA_TOKEN 未設定時的行為改為先取 tea 金鑰、tea 也沒有才詢問使用者
plugin.json	版本 0.0.1 → 0.0.2（技能異動須同步遞增）
.claude-plugin/plugin.json	版本 0.0.1 → 0.0.2（三份 manifest 保持一致）
.codex-plugin/plugin.json	版本 0.0.1 → 0.0.2（三份 manifest 保持一致）

設計重點

技能清單以 Gitea 正本 marketplace（plugins/jsc 的 marketplace.json）為權威來源，本機掃描僅作補充，避免漏掉尚未 clone 的 domain。
補 clone 與 API 呼叫一律透過 jsc-gitea/tools/gitea.sh，不自行拼 API；每個新增步驟都標明完成條件。
skill-delete 的深度刪除驗證與 skillset-update 的逐 domain 套用皆標示 MUST run as a sub agent，隔離大量檔案盤點與跨 repo 修改。
skillset-update 與 skill-update 職責切分明確：跨多技能／多 domain 用前者，單一技能用後者，description 內明示觸發與不觸發時機。
README「Skills 目錄」與 SKILL.md 實際流程逐條對齊，三份 manifest 版本同步遞增，符合 guidelines 審核檢查清單。

測試結果

本 repo 為技能文件與 manifest 變更，無可執行測試；已逐項通過 references/guidelines.md 審核檢查清單（命名、英文 description 含觸發時機、sub agent 標示、gitea.sh、jsc-ask、README 與三份 manifest 同步）。

前置 Push Request

plugins/gitea#3（gitea.sh tea token 備援；本 PR 的準則文件引用該行為）

## 摘要 - 需求描述：依使用者規則強化 jsc-meta 技能組管理流程——（1）skill-update 與 skill-delete 改為先查 Gitea 正本 marketplace（plugins/jsc）取得權威 domain 清單，缺少的 domain repo 先 clone 再列出技能；（2）skill-new 遇到 Gitea 已有但本機缺少的 domain repo 時改為 clone 既有 repo，不再重建；（3）skill-delete 新增深度刪除驗證——由 sub agent 實地檢查每個已安裝 CLI 的技能與 hook 保存位置，確認無殘留；（4）guidelines.md 補記 gitea.sh 在 token 未設定或 401／403 時自動改用 tea 登入金鑰的備援機制；（5）新增 skillset-update 技能，把一份變更需求批次套用到整個技能組，每個受影響 domain 各派一個 sub agent、每個 repo 各開一個 PR；（6）README「Skills 目錄」同步；（7）三份 manifest 版本 0.0.1 → 0.0.2。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | skills/skill-update/SKILL.md | 流程改為先查 Gitea 正本 marketplace 取得 domain 清單、補 clone 缺少的 repo 再列出技能；description 與步驟編號同步更新 | | skills/skill-delete/SKILL.md | 同上 marketplace 先行；另新增第 7 步深度刪除驗證——sub agent 實地檢查各已安裝 CLI 的技能與 hook 保存位置，確認無殘留 | | skills/skill-new/SKILL.md | domain 在 Gitea 已存在但本機缺少時改為 clone 既有 repo 後續行，不再重建 | | skills/skillset-update/SKILL.md | 新增技能：一份變更需求套用到整個技能組，逐受影響 domain 派 sub agent、逐 repo 開 PR | | README.md | 「Skills 目錄」同步：更新 skill-update 與 skill-delete 的流程描述，新增 skillset-update 條目 | | references/guidelines.md | 補記 gitea.sh 的 tea 登入金鑰備援；GITEA_TOKEN 未設定時的行為改為先取 tea 金鑰、tea 也沒有才詢問使用者 | | plugin.json | 版本 0.0.1 → 0.0.2（技能異動須同步遞增） | | .claude-plugin/plugin.json | 版本 0.0.1 → 0.0.2（三份 manifest 保持一致） | | .codex-plugin/plugin.json | 版本 0.0.1 → 0.0.2（三份 manifest 保持一致） | ## 設計重點 - 技能清單以 Gitea 正本 marketplace（plugins/jsc 的 marketplace.json）為權威來源，本機掃描僅作補充，避免漏掉尚未 clone 的 domain。 - 補 clone 與 API 呼叫一律透過 jsc-gitea/tools/gitea.sh，不自行拼 API；每個新增步驟都標明完成條件。 - skill-delete 的深度刪除驗證與 skillset-update 的逐 domain 套用皆標示 MUST run as a sub agent，隔離大量檔案盤點與跨 repo 修改。 - skillset-update 與 skill-update 職責切分明確：跨多技能／多 domain 用前者，單一技能用後者，description 內明示觸發與不觸發時機。 - README「Skills 目錄」與 SKILL.md 實際流程逐條對齊，三份 manifest 版本同步遞增，符合 guidelines 審核檢查清單。 ## 測試結果 - 本 repo 為技能文件與 manifest 變更，無可執行測試；已逐項通過 references/guidelines.md 審核檢查清單（命名、英文 description 含觸發時機、sub agent 標示、gitea.sh、jsc-ask、README 與三份 manifest 同步）。 ## 前置 Push Request - https://gitea.jsc.idv.tw/plugins/gitea/pulls/3（gitea.sh tea token 備援；本 PR 的準則文件引用該行為）

jiantw83 added 4 commits 2026-08-21 08:24:03 +00:00

feat(skill-ops): 技能管理流程改以 Gitea 正本 marketplace 為準並新增深度刪除驗證 b7287239cc

What（改了什麼）：
- skill-update：流程改為先呼叫 gitea.sh 取得 plugins/jsc marketplace.json 的 domain 清單，缺少的 domain repo 先 clone 再列出技能；原 6 步改為 7 步，description 同步更新。
- skill-delete：同樣先查 marketplace 並補 clone 缺少的 repo；刪除後新增第 7 步「深度刪除驗證」——由 sub agent 透過 detect-clis.sh 實地檢查每個已安裝 CLI 的技能與 hook 保存位置（如 Claude 的 ~/.claude/plugins/cache/ 與 settings 內的 hook 設定），確認無殘留，有殘留就手動清除並複查。
- skill-new：domain 在 Gitea 已存在但工作目錄缺少時，改為 clone 既有 repo 後直接進入第 3 步，不再重建。

Why（為什麼改）：
- 只掃本機 jsc-*/skills 會漏掉尚未 clone 的 domain，技能清單不完整；正本 marketplace 才是權威來源。
- 刪除技能後各 CLI 的快取與 hook 設定可能殘留，僅執行原生刪除指令不足以保證乾淨。
- domain repo 已存在卻重建會蓋掉既有內容。

How（怎麼改）：
- 三個 SKILL.md 的 Flow 前段統一加入「gitea.sh api GET /repos/plugins/jsc/raw/.claude-plugin/marketplace.json 取得 domain 清單 → gitea.sh clone-url 補 clone → 重掃」步驟，並標明完成條件。
- skill-delete 新增 MUST run as a sub agent 的深度驗證步驟，涵蓋 claude / codex / copilot / antigravity / kiro 的對應保存位置。
- 後續步驟編號與回跳目標（如「回到步驟 5.2」）同步修正。

Who（影響哪個功能／使用者）：
- 使用 jsc-meta:skill-update、skill-delete、skill-new 的所有使用者；技能清單自此涵蓋全部 marketplace domain，刪除技能後保證各 CLI 無殘留。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

feat(skillset-update): 新增 skillset-update 技能——一份變更需求批次套用到整個技能組 30687d5eea

What（改了什麼）：
- 新增 skills/skillset-update/SKILL.md：五步流程——決策樹確認變更範圍 → 依 Gitea 正本 marketplace 同步全部 domain repo → 每個受影響 domain 各派一個 sub agent 套用變更（含 README「Skills 目錄」同步與三份 manifest 版本遞增）→ 逐技能過 guidelines 審核檢查清單 → 每個受影響 repo 各開一個 PR。
- README.md「Skills 目錄」新增 skillset-update 條目，並同步更新 skill-update 與 skill-delete 的流程描述（marketplace 先行、補 clone、深度刪除驗證）。

Why（為什麼改）：
- 既有 skill-update 一次只能改一個技能；跨多技能、多 domain 的規則變更（如共用流程步驟調整）需要逐 repo 重複操作，容易漏改。
- README 需與技能實際流程保持同步，此為 guidelines 審核檢查清單的必要項目。

How（怎麼改）：
- 依 guidelines.md 準則撰寫：英文 description 含觸發與不觸發時機（單一技能改用 skill-update）、Gitea 操作一律走 jsc-gitea/tools/gitea.sh、提問一律走 jsc-ask:ask、需隔離的步驟標明 MUST run as a sub agent、每步標明完成條件。
- README 條目與各技能一節的敘述對齊 SKILL.md 的實際流程。
- 註：README.md 的三處變更位於同一個 diff hunk、無法乾淨拆分，故整檔併入本群組（本群組為最後一個觸及 README 的 feature 群組）。

Who（影響哪個功能／使用者）：
- 需要對整個 jsc 技能組做橫向規則變更的維護者；單一技能更新的使用者不受影響（仍走 skill-update）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs(guidelines): 補記 gitea.sh 的 tea 登入金鑰備援機制 dd04781058

What（改了什麼）：
- 「技能設計」第 2 條補充：gitea.sh 在 token 未設定或收到 401／403 時，會自動改用 tea 的登入金鑰重試一次。
- 環境變數表 GITEA_TOKEN 的「未設定時」欄位由「詢問使用者」改為「改用 tea 登入金鑰（tea login list）；tea 也沒有才詢問使用者」。

Why（為什麼改）：
- gitea.sh 已實作 tea token 備援，但準則文件未記載；技能作者與審核者依文件行事，文件落後會導致誤判認證失敗的處理方式。

How（怎麼改）：
- 僅更新 references/guidelines.md 兩處文字，與 jsc-gitea/tools/gitea.sh 的實際行為對齊，不動任何流程或工具。

Who（影響哪個功能／使用者）：
- 所有依 guidelines.md 撰寫或審核 jsc 技能的維護者；使用 gitea.sh 的技能在 token 失效時的預期行為自此有文件依據。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

chore(manifest): jsc-meta 版本 0.0.1 → 0.0.2 24b350880c

What（改了什麼）：
- 三份 plugin manifest（plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json）的 version 由 0.0.1 遞增為 0.0.2。

Why（為什麼改）：
- 本次變更含技能流程更新（skill-update／skill-delete／skill-new）與新技能 skillset-update；依 guidelines 準則，技能異動必須同步遞增三份 manifest 的版本。

How（怎麼改）：
- 各檔僅改 version 欄位一行，其餘欄位不動，三份保持一致。

Who（影響哪個功能／使用者）：
- 透過 jsc marketplace 安裝或更新 jsc-meta 的所有 CLI 使用者；版本號變更讓各 CLI 能偵測到更新。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

jiantw83 added a new dependency 2026-08-21 08:24:11 +00:00

plugins/gitea#3 - feat/tea-token-fallback-and-chart-first-wiki

admin merged commit 3269706ad2 into develop

2026-08-21 08:26:21 +00:00

admin deleted branch feat/marketplace-first-skill-ops-and-skillset-update

2026-08-21 08:26:21 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Depends on

#3 feat/tea-token-fallback-and-chart-first-wiki

plugins/gitea

Reference: plugins/meta#3