收攏 5 支技能的行為清單,功能主幹併回 develop #35

Merged
jiantw83 merged 3 commits from feat/skill-behaviors-and-version-block/main into develop 2026-08-31 08:10:35 +00:00
3 Commits
Author SHA1 Message Date
jiantw83 925dc59016 Merge pull request '盤點 5 支技能的實際行為,新增行為清單當驗證基準' (#34) from feat/skill-behaviors-and-version-block/behavior-list into feat/skill-behaviors-and-version-block/main 2026-08-31 08:09:20 +00:00
jiantw83 8a07f15fde chore(plugin): 同步三份 manifest 版本至 0.1.9
What:把 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest 的 version 從 0.1.8 改成 0.1.9,只動版本欄位。

Why:本次新增 references/behaviors.md,存放庫內容已經變動,版本號要跟著往前推。三份 manifest 若不同步,Claude 與 Codex 兩邊裝到的版本會對不上,版本檢查也會抓到落差。

How:三份檔案各改一行 version 字串,其餘欄位不動。plugin.json 的 skills 路徑、.claude-plugin 的 author 與 repository、.codex-plugin 的既有設定都維持原樣。jsc.requires 的相依版本這次沒有變動,不一併調整。

Who:jsc-gitea 外掛的版本標示,供 jsc-cli:deploy 安裝與 jsc-hooks/hooks/version-guard.sh 版本檢查使用。
2026-08-31 13:40:54 +08:00
jiantw83 bedbdc227f feat(references): 新增 jsc-gitea 技能行為清單
What:新增 references/behaviors.md。這一頁替 jsc-gitea 的五支技能各留一節,依序是 html-export、html-style、repo-sync、wiki、wiki-to-issue。每一節放一張五列表,欄位固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。

Why:技能驗證原本沒有共同的比對基準,每次都要回頭讀 SKILL.md 反推該有的行為。這一頁把行為寫成基準,驗證時直接比對。清單放在本存放庫而不是集中到 meta,技能改動與清單才會落在同一個 PR,內容不會漂移,也不用跨存放庫開兩條 PR 互卡。

How:逐支技能盤點,從 SKILL.md 與 skills 底下的腳本讀出實際行為。外部呼叫欄逐一列出用到的工具腳本、被呼叫的技能與 Gitea API,例如 tools/gitea-link.sh、tools/html-style.sh、tools/html-render.sh、tools/repo-sync.sh、tools/issue.sh、tools/hash-id。可驗證跡象欄一律寫看得到的產物,例如 HTML 檔落點、wiki 頁名、議題網址、設定檔內容。稽核時修正 html-style 一處,設定檔格式從空白分隔改成實際的 {種類}={版型},{風格}。表格欄位依 jsc-meta/tools/check-behaviors.sh 的程式層檢查對齊。

Who:jsc-gitea 的技能驗證參考基準,涵蓋 html-export、html-style、repo-sync、wiki、wiki-to-issue 五支技能。
2026-08-31 13:40:54 +08:00