釋出 jsc-gitea 0.1.9：新增五支技能的行為清單 #36

2026-08-31T08:14:06Z

jiantw83 commented

2026-08-31 08:14:06 +00:00

摘要

需求描述：盤點所有技能組，整理出所有技能的行為清單作為技能驗證的參考基準，日後技能異動都要同步更新；相依技能版本不符時不得跳過更新，改為阻擋執行。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/behaviors.md`	新增。技能行為清單，作為技能驗證的參考基準
三份 manifest	版本同步

設計重點

行為清單放在各 domain 而不是集中在 jsc-meta：技能改動與清單在同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。
五個欄位固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，由 jsc-meta/tools/check-behaviors.sh 在程式層檢查。

測試結果

jsc-meta/tools/check-behaviors.sh：退出 0，5 節對上 5 支技能，五個欄位齊全。
jsc-meta/tools/ste100-lint.sh：退出 0。
jsc-meta/tools/sync-skill-manifest.sh：退出 0，README 與三份 manifest 同步到 0.1.9。
合併進 develop 後回讀確認：版本 0.1.9、行為清單 5 節。
未跑「開新 CLI 行程送最小 Prompt」：這條 PR 合併前，CLI 載入的仍是舊的已安裝副本，跑了驗不到本次變更。

前置 Push Request

無

## 摘要 - 需求描述：盤點所有技能組，整理出所有技能的行為清單作為技能驗證的參考基準，日後技能異動都要同步更新；相依技能版本不符時不得跳過更新，改為阻擋執行。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增。技能行為清單，作為技能驗證的參考基準 | | 三份 manifest | 版本同步 | ## 設計重點 - 行為清單放在各 domain 而不是集中在 jsc-meta：技能改動與清單在同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。 - 五個欄位固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查。 ## 測試結果 - `jsc-meta/tools/check-behaviors.sh`：退出 0，5 節對上 5 支技能，五個欄位齊全。 - `jsc-meta/tools/ste100-lint.sh`：退出 0。 - `jsc-meta/tools/sync-skill-manifest.sh`：退出 0，README 與三份 manifest 同步到 0.1.9。 - 合併進 develop 後回讀確認：版本 0.1.9、行為清單 5 節。 - 未跑「開新 CLI 行程送最小 Prompt」：這條 PR 合併前，CLI 載入的仍是舊的已安裝副本，跑了驗不到本次變更。 ## 前置 Push Request - 無

jiantw83 added 4 commits 2026-08-31 08:14:07 +00:00

feat(references): 新增 jsc-gitea 技能行為清單 bedbdc227f

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 五支技能。

chore(plugin): 同步三份 manifest 版本至 0.1.9 8a07f15fde

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 版本檢查使用。

Merge pull request '盤點 5 支技能的實際行為，新增行為清單當驗證基準' (#34 ) from feat/skill-behaviors-and-version-block/behavior-list into feat/skill-behaviors-and-version-block/main 925dc59016

Merge pull request '收攏 5 支技能的行為清單，功能主幹併回 develop' (#35 ) from feat/skill-behaviors-and-version-block/main into develop 9630dcd5f6

admin approved these changes 2026-08-31 08:18:42 +00:00

admin merged commit b729aa92f3 into master

2026-08-31 08:18:45 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/gitea#36