新增 commit、pr 兩支技能的行為清單，標清兩者的邊界 #23

2026-08-31T05:39:01Z

jiantw83 commented

2026-08-31 05:39:01 +00:00

摘要

需求描述：盤點 jsc-git 技能組的所有技能，整理每支技能的行為清單，作為技能驗證的參考基準。清單放在 jsc-git 自己的 repo，技能改動與清單走同一個 PR，不會互相漂移，也不用跨 repo 開兩條 PR 互卡。日後任何技能異動都要同步更新這一份清單。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/behaviors.md`	新增檔。收錄 jsc-git 的 commit、pr 兩節，每節一張五列表，列出觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，供技能驗證比對。
`.claude-plugin/plugin.json`	本 repo 新增參考文件，版本從 `0.1.1` 升到 `0.1.2`。
`.codex-plugin/plugin.json`	同步 Codex 的 manifest 版本到 `0.1.2`，三份 manifest 保持一致。
`plugin.json`	同步根目錄的 manifest 版本到 `0.1.2`，三份 manifest 保持一致。

設計重點

每支技能固定一節，節標題用技能名稱 commit、pr，欄位順序固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。格式由 jsc-meta/tools/check-behaviors.sh 在程式層檢查。
「觸發時機」同時寫該叫用與不該叫用的情形，把 jsc-git:commit 和 jsc-git:pr 的邊界標清楚：只提交叫 commit、要推送或開 PR 叫 pr。
「外部呼叫」逐一列出腳本、git 指令、gitea.sh 子命令與被叫用的技能，讓驗證時看得出實際依賴，包含 jsc-hooks/hooks/comment-scope.sh sweep 與 jsc-gitea/tools/gitea.sh 的 pr-of-branch、pr-create、pr-edit、pr-depend、comment-reply。
「可驗證跡象」寫成外部觀察得到的結果，例如 git log --oneline 的標題格式、git ls-remote --heads origin 查得到的目標分支 ref、Gitea 上的 PR 與意見回覆，並明講兩支技能都不寫 wiki 頁。
清單只描述現有行為，不改任何技能檔，因此三份 manifest 只做版本號同步。

測試結果

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

前置 Push Request

無

## 摘要 - 需求描述：盤點 jsc-git 技能組的所有技能，整理每支技能的行為清單，作為技能驗證的參考基準。清單放在 jsc-git 自己的 repo，技能改動與清單走同一個 PR，不會互相漂移，也不用跨 repo 開兩條 PR 互卡。日後任何技能異動都要同步更新這一份清單。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增檔。收錄 jsc-git 的 commit、pr 兩節，每節一張五列表，列出觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，供技能驗證比對。 | | `.claude-plugin/plugin.json` | 本 repo 新增參考文件，版本從 `0.1.1` 升到 `0.1.2`。 | | `.codex-plugin/plugin.json` | 同步 Codex 的 manifest 版本到 `0.1.2`，三份 manifest 保持一致。 | | `plugin.json` | 同步根目錄的 manifest 版本到 `0.1.2`，三份 manifest 保持一致。 | ## 設計重點 - 每支技能固定一節，節標題用技能名稱 `commit`、`pr`，欄位順序固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。格式由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查。 - 「觸發時機」同時寫該叫用與不該叫用的情形，把 `jsc-git:commit` 和 `jsc-git:pr` 的邊界標清楚：只提交叫 commit、要推送或開 PR 叫 pr。 - 「外部呼叫」逐一列出腳本、`git` 指令、`gitea.sh` 子命令與被叫用的技能，讓驗證時看得出實際依賴，包含 `jsc-hooks/hooks/comment-scope.sh sweep` 與 `jsc-gitea/tools/gitea.sh` 的 `pr-of-branch`、`pr-create`、`pr-edit`、`pr-depend`、`comment-reply`。 - 「可驗證跡象」寫成外部觀察得到的結果，例如 `git log --oneline` 的標題格式、`git ls-remote --heads origin` 查得到的目標分支 ref、Gitea 上的 PR 與意見回覆，並明講兩支技能都不寫 wiki 頁。 - 清單只描述現有行為，不改任何技能檔，因此三份 manifest 只做版本號同步。 ## 測試結果 - 本次只新增參考文件與同步版本號，沒有可執行的測試。 - `jsc-hooks/hooks/comment-scope.sh sweep` 在此工作區跑過，退出碼 0。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-31 05:39:01 +00:00

feat(behaviors): 新增 jsc-git 技能行為清單 1c85d079ee

What：新增 `references/behaviors.md`。檔內收錄 jsc-git 的 commit、pr 兩節，每節一張五列表，欄位為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。

Why：技能驗證原本沒有共同的比對基準，只能回頭讀 SKILL.md 逐段推敲。清單放在 jsc-git 自己的 repo，技能改動與清單走同一個 PR，不會互相漂移，也不用跨 repo 開兩條 PR 互卡。

How：逐支技能盤點行為並寫成固定格式。節標題用技能名稱、欄位順序固定，格式由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查。觸發時機同時寫該叫用與不該叫用的情形，把 commit 與 pr 的邊界標清楚。外部呼叫逐一列出腳本、`git` 指令、`gitea.sh` 子命令與被叫用的技能。可驗證跡象寫成外部觀察得到的結果，並明講兩支技能都不寫 wiki 頁。

Who：jsc-git 的 commit、pr 兩支技能，供技能驗證使用。日後任何技能異動都要在同一個 PR 內同步更新這一頁。

chore(plugin): 三份 manifest 版本同步至 0.1.2 fbfae7ed38

What：把 `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 的 `version` 從 `0.1.1` 改成 `0.1.2`。

Why：本 repo 新增 `references/behaviors.md`，內容有變就要出新版。三份 manifest 分別給 Claude、Codex 與根目錄讀取，版本必須一致，否則版本檢查會判定不相符。

How：只動 `version` 一個欄位，三份檔案改成相同的 0.1.2。描述、技能路徑、`jsc.requires` 的相依範圍都不動。

Who：jsc-git 這個 plugin 的版本標示，供各 CLI 的 plugin 版本檢查使用。

jiantw83 changed title from ~~feat/skill-behaviors-and-version-block/behavior-list~~ to 新增 commit、pr 兩支技能的行為清單，標清兩者的邊界

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

jiantw83 referenced this pull request

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

把 commit、pr 兩支技能的行為清單收攏進 develop #24

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

#24 把 commit、pr 兩支技能的行為清單收攏進 develop

jiantw83 referenced this pull request

2026-08-31 06:39:51 +00:00

PR 標題改用繁體中文摘要，不再套用分支名 #25

jiantw83 added a new dependency 2026-08-31 06:39:59 +00:00

#25 PR 標題改用繁體中文摘要，不再套用分支名