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
|
08a7d23a12
|
feat(skill-check): 加入流程效率稽核
|
2026-08-28 09:30:27 +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 |
|
 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 |
|