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

2026-08-31T06:37:13Z

jiantw83 commented

2026-08-31 06:37:13 +00:00

摘要

需求描述：本 PR 是功能主幹的收攏層。子功能 PR 先併入 feat/skill-behaviors-and-version-block/main，再由本 PR 一次併回 develop。本輪功能是盤點 html-export、html-style、repo-sync、wiki、wiki-to-issue 這 5 支技能的實際行為，新增行為清單。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
由子功能 PR 帶入	本 PR 自身不提交檔案。內容來自 plugins/gitea#34，該 PR 併入功能主幹後才會出現在這裡

設計重點

走完整階梯。子功能分支先併入功能主幹，功能主幹再併回 develop，中間不跳級。
功能主幹目前與 develop 指向同一個 commit，所以本 PR 剛開時的變更檔案數是 0。這是預期結果，不是開錯 base。plugins/gitea#34 併入功能主幹之後，內容才會浮現在本 PR。
功能主幹集中審查。同一輪功能的子功能分支併攏後，develop 只收一次。

測試結果

本 PR 不含自身提交，測試結果以子功能 PR plugins/gitea#34 為準。該 PR 跑過 comment-scope.sh sweep，結束碼 0；本輪只新增參考文件與同步版本號，沒有可執行的測試。

前置 Push Request

plugins/gitea#34：#34

## 摘要 - 需求描述：本 PR 是功能主幹的收攏層。子功能 PR 先併入 `feat/skill-behaviors-and-version-block/main`，再由本 PR 一次併回 `develop`。本輪功能是盤點 html-export、html-style、repo-sync、wiki、wiki-to-issue 這 5 支技能的實際行為，新增行為清單。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | 由子功能 PR 帶入 | 本 PR 自身不提交檔案。內容來自 plugins/gitea#34，該 PR 併入功能主幹後才會出現在這裡 | ## 設計重點 - 走完整階梯。子功能分支先併入功能主幹，功能主幹再併回 `develop`，中間不跳級。 - 功能主幹目前與 `develop` 指向同一個 commit，所以本 PR 剛開時的變更檔案數是 0。這是預期結果，不是開錯 base。plugins/gitea#34 併入功能主幹之後，內容才會浮現在本 PR。 - 功能主幹集中審查。同一輪功能的子功能分支併攏後，`develop` 只收一次。 ## 測試結果 - 本 PR 不含自身提交，測試結果以子功能 PR plugins/gitea#34 為準。該 PR 跑過 `comment-scope.sh sweep`，結束碼 0；本輪只新增參考文件與同步版本號，沒有可執行的測試。 ## 前置 Push Request - plugins/gitea#34：https://gitea.jsc.idv.tw/plugins/gitea/pulls/34

jiantw83 added a new dependency 2026-08-31 06:37:34 +00:00

#34 盤點 5 支技能的實際行為，新增行為清單當驗證基準

jiantw83 added 3 commits 2026-08-31 08:09:22 +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

jiantw83 merged commit 9630dcd5f6 into develop

2026-08-31 08:10:35 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Depends on

#34 盤點 5 支技能的實際行為，新增行為清單當驗證基準

plugins/gitea

Reference: plugins/gitea#35