plugins/meta
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
126 Commits 9 Branches 0 Tags
2fa8d860453e2f1f2fc7fedb2644d50c96071806
Commit Graph
29 Commits
Author SHA1 Message Date
jiantw83 b87dbb12cd feat(狀態回報): 收尾寫一筆 skill-end 事件 
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。

start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。

status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
 2026-09-02 16:01:16 +08:00
jiantw83 651ddb3a6f feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到 
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
 2026-09-02 14:27:18 +08:00
jiantw83 f13724cb79 feat(wiki): 目錄頁專用存取庫入準則，skill-check 加入優化建議流程 
What：準則的環境變數表與命名總表加入 JSC_WIKI_REPO_CONTENTS 與目錄頁專用存取庫
一節，HASH 規則改為完整 40 碼。skill-check 的 Group 3 先讀上一輪決議，建議表加上
決議與決議日期兩欄，新增步驟 8 把稽核結果寫進 SKILLSET 頁。新增 check-page-name.sh
與兩份 SKILLSET 範本。

Why：優化建議原本每輪產出後就散掉，決議為延後的項目下一輪會重新掃、重新問一次，
正是 skill-check 自己第三個面向點名的毛病。SKILLSET_CONTENTS 是 14 個目錄頁裡
唯一沒有範本的，四支技能都被要求寫它，卻沒有欄位定義可套。

How：Group 1 補進三支現成但沒人呼叫的檢查腳本——ste100-lint.sh、check-wiki-rules.sh
與新增的 check-page-name.sh。讀不到上一輪決議時只停掉 Group 3，不再中止整輪：那兩組
完全不碰 wiki，金鑰失效就會鎖死整組技能唯一的稽核路徑。另外四支 meta 技能原本把目錄頁
寫進 SKILLSET 存取庫，一併改走 CONTENTS。
 2026-09-02 11:02:48 +08:00
jiantw83 d879e634c0 feat(frontmatter-lint): 新增 SKILL.md frontmatter 解析檢查並併入例行稽核 
What：
- 新增 tools/lint-frontmatter.sh，掃一個 domain 每支 skills/*/SKILL.md 的 frontmatter，檢查分隔線成對、必要鍵齊全、未加引號的純量不含「冒號加空白」、起頭字元不是 YAML 特殊字元、加了引號的值收得起來，共五項。
- 改寫 skills/skill-check/SKILL.md 的第一組稽核，把這支腳本併進去成為第 2 步，原本的行為清單檢查、結束碼路由檢查、hook smoke 依序後移。
- 第二組留白的檢查清單項目由四項改成五項，第 3 步的合併說明、三組的完成條件、第 6 步的重驗完成條件同步改寫。

Why：
- 抓到 6 支技能的 description 是未加引號的 YAML 純量、內容含「冒號加空白」。那在 YAML 是鍵的分隔符號，整份 frontmatter 當場語法錯誤。
- Antigravity 讀到語法錯誤就靜默丟棄整支技能。磁碟上 34 支，它只認 28 支。載入器不報、CLI 不報，技能清單只是少了幾列。
- 這種缺陷唯一的發現途徑是逐檔比對磁碟數量與載入數量。人工比對 10 個 domain 每次稽核都要重做一遍，還會漏。輸入輸出固定的判定就交給程式。

How：
- 腳本用 awk 自己判定 YAML 1.2 的 plain scalar 規則，不相依 pyyaml。護欄不綁在一個不保證存在的相依上，才跑得到每一台機器。
- 單引號的跳脫是重複一次、雙引號的跳脫是反斜線，兩套規則不同，所以引號改用逐字掃描，不用正規表示式一次比對兩種。
- 結束碼分四種：0 是掃到 SKILL.md 且五項全過、1 是有不合格項目（清單走 stderr，格式 {檔案}:{鍵}:{說明}）、2 是用法錯誤、3 是什麼都沒掃。
- SKILL.md 明寫退出 3 不算通過，並把「每個 domain 的 lint-frontmatter.sh 退出 0」列進第 6 步的完成條件。

Who：
屬 CLI hook 接線修正（jsc-hooks 0.3.4）在 meta 這一側的稽核工具。
 2026-08-31 19:13:03 +08:00
jiantw83 2e237b7674 feat(behaviors): 新增技能行為清單與檢查腳本 
What：新增 references/behaviors.md，一支技能一節，共七支技能。每節五列，記下觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。新增 tools/check-behaviors.sh，比對 skills/ 與這份清單。skill-new、skill-update、skill-delete、skillset-update 加上同步更新清單的步驟。skill-check 把這支腳本併進第一組稽核。

Why：技能驗證原本沒有基準，稽核只能靠眼睛比對 SKILL.md。十個 domain 每輪都要重做一遍，還會漏掉。行為清單當基準，技能改了、清單沒跟著改，就是漂移。漂移交給程式判定才穩。

How：腳本檢查節數、節名、節序、每節一張表、五個欄位齊全、內容欄非空。退出碼 0 代表相符，1 代表不符，2 代表用法錯誤，3 代表找不到清單或找不到 skills 目錄。domain 名以 plugin.json 的 name 為準，checkout 目錄名只是退路。四支異動技能在同一個 PR 內改清單，並照退出碼分流。

Who：屬於「技能行為清單」這件需求，提供技能驗證的參考基準。
 2026-08-31 13:37:04 +08:00
jiantw83 5aa4a3da57 feat(skills): 新增技能盤點頁與共用部署驗證流程，並把技能驗證移到新行程 
技能盤點以前只回到對話裡，換一台機器就得重跑才知道裝了什麼。
現在新增技能盤點這個 wiki 頁類型，雜湊取「主機、工具名稱、登入帳號」三段。
每支 CLI 各有自己的 plugin 集合，也各有自己的 hook 接線，那是互相獨立的事實。
少了工具名稱那一段，同一台機器上五支 CLI 會算出同一個雜湊，五份盤點互相覆蓋，
讀的人還看不出被蓋掉。技能盤點新增寫入這兩頁的步驟，整步規定必須開 sub agent。
兩份樣板刻意分開：內容頁每次盤點覆寫整頁，目錄頁只更新自己那一列，
兩者的寫入語意剛好相反，合成一份遲早有人把別台機器的紀錄刪掉。

四支異動技能原本在部署完的同一個工作階段，就叫用剛做好的技能。
部署收尾自己立起重啟閘門，那支技能必被擋下，驗證做不完。
解法不是把它加進豁免清單。豁免擋得住閘門，擋不住「行程還載著舊版」這件事，
硬過關驗到的是舊版行為，等於假通過。所以把判路線、部署、驗證、失敗分流
抽成一份共用說明，驗證一律另開 CLI 行程執行，四支技能只留一行指標指過去。

新增腳本檢查工具，一次做完語法、執行權限與結束碼宣告三項檢查，
只被 source 的函式庫豁免後兩項，而且逐支記在錯誤輸出，不靜默略過。
新增部署路線判定工具，判定改動有沒有進存取庫的預設分支，
取代四支技能各抄一段、各自漂移的散文；判不出來就回報停下，不自己挑路線走。

同時把四支技能裡的中文段落抽到共用說明、指標改回英文，
修正六處相對路徑，把技能盤點的模糊描述改成查得出來的條件，
並讓 manifest 同步的每一個呼叫端逐碼分流。

七支技能改為併行執行：例行稽核從九步併成七步，技能盤點併成六步。
技能盤點不再重跑盤點腳本內部已經跑過的三支腳本，
而那三支原本兼作獨立交叉檢查，拿掉就少一層保護，
所以把少掉的是什麼、風險由誰擋住，明白寫進 Notes，不當作沒發生。
 2026-08-31 11:11:12 +08:00
jiantw83 7127999eb3 docs(skill-check): 補上成本效率稽核範圍與驗證條件。 2026-08-28 17:41:38 +08:00
jiantw83 0cf2392ae7 fix(skill-check): 納入腳本與 hook 驗證 2026-08-28 16:55:48 +08:00
jiantw83 b48665f946 feat(skill-validation): 要求 CLI Prompt 實測與修復 PR 2026-08-28 16:02:29 +08:00
jiantw83 a88bfe3d21 feat(tooling-guide): 新增技能組工具盤點指引 2026-08-28 15:33:09 +08:00
jiantw83 08a7d23a12 feat(skill-check): 加入流程效率稽核 2026-08-28 09:30:27 +08:00
jiantw83 b0ea356ff5 feat(meta): 建立 PR 收尾回報單一規範 2026-08-28 09:30:23 +08:00
jiantw83 478f670d53 feat(skillset-report): 四支異動技能收尾套用到工作階段、驗證並寫異動報告 
What：`skill-new`、`skill-update`、`skill-delete`、`skillset-update` 四支各新增一個收尾步驟，內含三個子步驟：把改動套用到目前工作階段、逐項驗證功能真的動得起來、把驗證結果附加到 wiki 的 `SKILLSET_{HASH}`。四支的 `description` 同步補上這段收尾。

Why：原本四支都以「開了 PR」作為收尾。PR 開完技能還沒進到任何 CLI，改動到底動不動得起來沒人驗過，壞了要等下一次有人踩到才知道。技能組的異動紀錄也一樣沒有落腳處：同一支技能改過幾次、每次改了什麼，只能翻 git 紀錄。

How：套用那一步分兩條路徑，依改動走到哪裡決定。PR 已經合併到 `master` 才走 `jsc-cli:deploy` 更新模式，並依提示重新啟動；PR 還停在 `develop` 或還在等審核，就改用工作樹驗證，報告標成「工作樹驗證、尚未部署」，並點名還沒合併的發佈 PR。分兩條路徑的理由是完成條件達不到：marketplace 與 `version-guard.sh` 都讀存取庫的預設分支，停在 `develop` 的改動 `deploy` 一定看不到，硬跑就卡在永遠達不到的完成條件上。驗證那一步要求逐項比對結束碼與實際輸出，不接受「跑完沒報錯」；對不上就回到套用那一步重跑，不往下走。報告一律附加一節、不覆蓋舊節，要看一支技能改過幾次就在同一頁上翻；寫不進去就把頁名與未寫入的內容交回使用者，這一步留著不結案。

Who：`jsc-meta` 的四支技能組異動技能，以及日後查技能組異動紀錄的人。
 2026-08-27 16:34:16 +08:00
jiantw83 9a0ea8e248 feat(skill-check): 稽核加入 marketplace 同步必經步驟與流程檢查四項 
What：`skills/skill-check/SKILL.md` 兩處增修。第 2 步的稽核範圍明寫要逐項涵蓋準則的流程檢查四項，四項各列一條，完成條件改成「每個 domain 的稽核結果對所有清單項目都有結論，含這四項」；新增第 5 步「同步 marketplace 正本」，四個結束碼各自寫明怎麼處理，原本的複查與開 PR 順延為第 6、7 步。

Why：`sync-marketplace.sh` 原本沒有出現在任何技能流程裡，跑不跑全憑人記得。正本在 `plugins/meta`，每個 domain 存取庫各留一份位元組完全相同的副本，稽核改完不同步，就會有存取庫註冊到過期的 plugin 清單。流程檢查四項同理：準則加了項目，稽核不點名就沒有人會查，四項等於沒加。

How：同步列為必經步驟，不是選項。呼叫時拿既有項目自己現在的值重寫一次，重寫同一筆是冪等的，所以不必先判斷哪一筆該改。四個結束碼逐一分流：3 是寫好了但有 domain 沒 clone 到本機，先跑 `sync-domains.sh` 再重跑；2 是參數個數不對；1 是缺 python3、正本讀不到或副本位元組不一致；0 才代表每份副本完全相同，而且是腳本自己驗過的。

Who：`jsc-meta:skill-check` 的例行合規稽核流程。
 2026-08-27 16:34:16 +08:00
jiantw83andClaude Opus 5 9ab5b42864 fix(meta): 補齊稽核缺失並修掉護欄失效 
What：依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。

Why：稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項；退碼誤判與查表錯誤則會讓良性狀況被當成失敗。

How：逐項對照 references/guidelines.md 的審核檢查清單修正，新增的工具都有
documented exit codes，並以真實執行驗證每條路徑。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 98bc02578d refactor(marketplace 正本): 正本與權威來源改為 plugins/meta，移除對 plugins/jsc 的相依 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
jiantw83 4454d62e82 feat(meta): 抽出技能目錄同步與引用查找為共用工具 
什麼：新增 tools/sync-skill-manifest.sh（重建 domain README 的「Skills 目錄」區塊並將三份 plugin manifest 的版本一併 bump）與 tools/find-skill-refs.sh（掃描所有 jsc domain 存取庫，列出技能名稱或 /jsc-{domain}:{name} 指令形式的引用檔案），並更新 skill-check、skill-delete、skill-new、skill-update、skillset-update 五支 SKILL.md 改為呼叫這兩支工具。skill-delete 與 skill-update 的 frontmatter description 也一併收斂在此次改動內，配合本次流程調整精簡文字。
為何：五支技能先前各自以近乎相同的內嵌文字描述「同步 README、bump 版本」的機械流程，重複維護成本高且容易漂移；skill-delete 的引用盤點步驟先前只是一段沒有工具、也沒有標明子代理人的裸 grep 指示，稽核時難以驗證涵蓋範圍。
如何：把兩段機械流程各自抽成一支冪等 shell 工具，五支技能的對應步驟改為「子代理人只做內容判斷與修改，機械式同步與版本 bump 一律呼叫工具」；skill-delete 步驟 4 改呼叫 find-skill-refs.sh 取代裸 grep 說明。
負責範圍：jsc-meta 技能組自我管理，skill-check、skill-delete、skill-new、skill-update、skillset-update 五支技能共用的機械流程去重。
 2026-08-24 14:49:23 +08:00
jiantw83 3c63989f80 fix(skill-check): 補強工具化與環境優先審核 2026-08-21 16:53:17 +00:00
jiantw83andClaude Fable 5 ef2577c011 feat(skill-check): 新增 skill-check 技能——例行稽核整個技能組是否符合準則 
What(改了什麼)：
- 新增 skills/skill-check/SKILL.md：六步流程——依 Gitea 正本 marketplace 同步全部 domain repo → 每個 domain 各派一個 sub agent 對照 guidelines 審核檢查清單稽核 → 不符項目逐項走 jsc-ask:ask 決策樹確認（套用建議修正／略過／自訂修正，每個選項標明影響範圍）→ 每個受影響 repo 各派一個 sub agent 套用修正（含 README「Skills 目錄」同步與三份 manifest 版本遞增）→ 複檢至全數通過 → 逐 repo 以 jsc-git:pr 開 PR。
- README.md「Skills 目錄」新增 skill-check 條目，並標明與 skillset-update 的分工：無變更需求走 skill-check，有變更需求走 skillset-update。

Why(為什麼改)：
- 既有 skillset-update 以「一份變更需求」為前提；準則本身演進後，技能組缺少「無變更需求時」的例行體檢入口，不符項目只能等到下次改動才被發現。
- 稽核與修正拆成獨立技能，可排入定期維護，讓整個技能組持續符合 guidelines.md。

How(怎麼改)：
- 依 guidelines.md 準則撰寫：英文 description 含觸發與不觸發時機（套用變更需求改用 skillset-update、單一技能改用 skill-update）、Gitea 操作一律走 jsc-gitea/tools/gitea.sh、提問一律走 jsc-ask:ask、需隔離的步驟標明 MUST run as a sub agent、每步標明完成條件。
- 複檢失敗時明定回到決策樹確認步驟，直到檢查清單全數通過才開 PR。

Who(影響哪個功能／使用者)：
- 負責 jsc 技能組例行維護的維護者；一般技能新增、更新、刪除的使用者不受影響（仍走 skill-new／skill-update／skill-delete）。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 09:25:59 +00:00
jiantw83andClaude Fable 5 30687d5eea feat(skillset-update): 新增 skillset-update 技能——一份變更需求批次套用到整個技能組 
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>
 2026-08-21 08:23:53 +00:00
jiantw83andClaude Fable 5 b7287239cc feat(skill-ops): 技能管理流程改以 Gitea 正本 marketplace 為準並新增深度刪除驗證 
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>
 2026-08-21 08:23:53 +00:00
jiantw83andClaude Fable 5 a2057ad3e4 feat(meta): 準則改為每個存取庫都帶統一 marketplace 副本並同步 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:37:49 +08:00
jiantw83andClaude Fable 5 7283fea040 docs(meta): translate SKILL.md into English per guidelines 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:28:37 +08:00
jiantw83andClaude Fable 5 526c6c2b93 feat(meta): 新增 ste100-sync 技能——同步上游 speak-human-tw 並釘住版本 v1.4.0 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:27:39 +08:00
jiantw83andClaude Fable 5 9e9db57f7a style(meta): 依 STE100 擬人台灣感規則改寫語感 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:16:43 +08:00
jiantw83andClaude Fable 5 5695e3fe06 feat(meta): 準則改為統一 marketplace jsc 與版本 0.0.1 起算 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:37 +08:00
jiantw83andClaude Fable 5 6be3e7fc77 feat(meta): 匯入 jsc-meta 技能組 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83andClaude Fable 5 12a90e5f58 chore(meta): 修正範本 manifest 與移除 hello 範例符合 meta 領域 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:18 +08:00
jiantw83 d759ea9208 Initial commit 2026-08-21 04:44:34 +00:00