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

2026-08-31T05:41:02Z

jiantw83 commented

2026-08-31 05:41:02 +00:00

摘要

需求描述：盤點 jsc-gitea 底下的五支技能，整理出每支技能的行為清單，當作技能驗證的參考基準。清單放在本存放庫的 references/behaviors.md，格式由 jsc-meta/tools/check-behaviors.sh 在程式層檢查。日後技能一有異動，就在同一個 PR 內同步更新這一頁。三份 manifest 的版本一併同步到 0.1.9。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/behaviors.md`	新增 jsc-gitea 的技能行為清單。html-export、html-style、repo-sync、wiki、wiki-to-issue 各一節，每節一張五列表，列出觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。
`plugin.json`	版本從 0.1.8 改成 0.1.9，對應本次新增參考文件。
`.claude-plugin/plugin.json`	同步 Claude CLI 的 manifest 版本到 0.1.9，避免版本檢查抓到落差。
`.codex-plugin/plugin.json`	同步 Codex CLI 的 manifest 版本到 0.1.9，三份 manifest 一致。

設計重點

行為清單放在各自的網域存放庫，不集中到 meta。技能改動與清單落在同一個 PR，內容才不會漂移，也不用跨存放庫開兩條 PR 互卡。
每支技能固定五列：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。欄位固定，jsc-meta/tools/check-behaviors.sh 才驗得動。
「可驗證跡象」一律寫看得到的產物，例如檔案落點、wiki 頁名、議題網址、設定檔內容，不寫抽象描述。
稽核時修過一處：html-style 的可驗證跡象原本把設定檔格式寫成空白分隔，已改成實際的 {種類}={版型},{風格}，例如 WIKI:PLAN=report,corporate。
三份 manifest 的版本一起改，Claude 與 Codex 兩邊裝到的版本才對得上。

測試結果

本次只新增參考文件與同步版本號，沒有程式碼異動，也沒有可執行的測試。
jsc-hooks/hooks/comment-scope.sh sweep 在此工作區跑過，退出碼 0。

前置 Push Request

無

## 摘要 - 需求描述：盤點 jsc-gitea 底下的五支技能，整理出每支技能的行為清單，當作技能驗證的參考基準。清單放在本存放庫的 `references/behaviors.md`，格式由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查。日後技能一有異動，就在同一個 PR 內同步更新這一頁。三份 manifest 的版本一併同步到 0.1.9。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增 jsc-gitea 的技能行為清單。html-export、html-style、repo-sync、wiki、wiki-to-issue 各一節，每節一張五列表，列出觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。 | | `plugin.json` | 版本從 0.1.8 改成 0.1.9，對應本次新增參考文件。 | | `.claude-plugin/plugin.json` | 同步 Claude CLI 的 manifest 版本到 0.1.9，避免版本檢查抓到落差。 | | `.codex-plugin/plugin.json` | 同步 Codex CLI 的 manifest 版本到 0.1.9，三份 manifest 一致。 | ## 設計重點 - 行為清單放在各自的網域存放庫，不集中到 meta。技能改動與清單落在同一個 PR，內容才不會漂移，也不用跨存放庫開兩條 PR 互卡。 - 每支技能固定五列：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。欄位固定，`jsc-meta/tools/check-behaviors.sh` 才驗得動。 - 「可驗證跡象」一律寫看得到的產物，例如檔案落點、wiki 頁名、議題網址、設定檔內容，不寫抽象描述。 - 稽核時修過一處：`html-style` 的可驗證跡象原本把設定檔格式寫成空白分隔，已改成實際的 `{種類}={版型},{風格}`，例如 `WIKI:PLAN=report,corporate`。 - 三份 manifest 的版本一起改，Claude 與 Codex 兩邊裝到的版本才對得上。 ## 測試結果 - 本次只新增參考文件與同步版本號，沒有程式碼異動，也沒有可執行的測試。 - `jsc-hooks/hooks/comment-scope.sh sweep` 在此工作區跑過，退出碼 0。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-31 05:41:02 +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 版本檢查使用。

jiantw83 changed title from ~~feat/skill-behaviors-and-version-block/behavior-list~~ to 盤點 5 支技能的實際行為，新增行為清單當驗證基準

2026-08-31 06:36:24 +00:00

jiantw83 referenced this pull request

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

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

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

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

jiantw83 merged commit 925dc59016 into feat/skill-behaviors-and-version-block/main

2026-08-31 08:09:21 +00:00

Sign in to join this conversation.