plugins/git
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

釋出 jsc-git 0.1.3：PR 標題改用繁體中文摘要，新增技能行為清單 #26

Merged
admin merged 7 commits from develop into master 2026-08-31 08:18:38 +00:00
Conversation 1 Commits 7 Files Changed 6
+33 -10
jiantw83 commented 2026-08-31 08:14:06 +00:00
Member
Copy Link
Copy Source

摘要

  • 需求描述：盤點所有技能組，整理出所有技能的行為清單作為技能驗證的參考基準；並解掉 PR 標題規則與語言規則的衝突。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

檔案 為什麼改
references/behaviors.md 新增。commit、pr 兩支技能的行為清單，作為技能驗證的參考基準
skills/pr/SKILL.md 步驟 7 的 PR 標題改用繁體中文摘要，不再等於分支名；步驟 8 的校準改成比對內容而非分支名
README.md 同步 pr 技能的新行為
三份 manifest 版本同步到 0.1.3

設計重點

  • 原本步驟 7 規定 PR 標題等於分支名（ASCII），語言規則規定所有非程式碼輸出含 PR 標題一律繁中，兩條直接打架。依準則「強制力層級」第 1 條的優先序 hook > prompt 裁定：語言規則有 hook 強制，技能內文讓位。
  • 步驟 8 的校準一併改掉。不改的話，繁中標題每跑一次校準就被改回分支名，還會通知所有審查者。
  • 分支名本身仍維持 ASCII，那是「命名」第 5 條的硬性要求。分支名給機器判階梯用，標題給人看審查列表用，兩者本來就承擔不同任務。

測試結果

  • check-behaviors.sh 退出 0，2 節對上 2 支技能。
  • lint-scripts.sh、ste100-lint.sh 皆退出 0。
  • 新規則實地驗證：本批次 10 個存放庫共 21 條 PR 的標題全部改為繁中摘要，審查列表上看得出各條改了什麼。
  • 未跑「開新 CLI 行程送最小 Prompt」：這條 PR 合併前，CLI 載入的仍是舊的已安裝副本。

前置 Push Request

  • 無
## 摘要 - 需求描述：盤點所有技能組，整理出所有技能的行為清單作為技能驗證的參考基準；並解掉 PR 標題規則與語言規則的衝突。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增。commit、pr 兩支技能的行為清單，作為技能驗證的參考基準 | | `skills/pr/SKILL.md` | 步驟 7 的 PR 標題改用繁體中文摘要，不再等於分支名；步驟 8 的校準改成比對內容而非分支名 | | `README.md` | 同步 pr 技能的新行為 | | 三份 manifest | 版本同步到 0.1.3 | ## 設計重點 - 原本步驟 7 規定 PR 標題等於分支名（ASCII），語言規則規定所有非程式碼輸出含 PR 標題一律繁中，兩條直接打架。依準則「強制力層級」第 1 條的優先序 hook > prompt 裁定：語言規則有 hook 強制，技能內文讓位。 - 步驟 8 的校準一併改掉。不改的話，繁中標題每跑一次校準就被改回分支名，還會通知所有審查者。 - 分支名本身仍維持 ASCII，那是「命名」第 5 條的硬性要求。分支名給機器判階梯用，標題給人看審查列表用，兩者本來就承擔不同任務。 ## 測試結果 - `check-behaviors.sh` 退出 0，2 節對上 2 支技能。 - `lint-scripts.sh`、`ste100-lint.sh` 皆退出 0。 - 新規則實地驗證：本批次 10 個存放庫共 21 條 PR 的標題全部改為繁中摘要，審查列表上看得出各條改了什麼。 - 未跑「開新 CLI 行程送最小 Prompt」：這條 PR 合併前，CLI 載入的仍是舊的已安裝副本。 ## 前置 Push Request - 無
jiantw83 added 7 commits 2026-08-31 08:14:06 +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 版本檢查使用。
feat(pr-title-language): PR 標題改用繁體中文摘要 9017e4cbf5 
What：
- `jsc-git:pr` 步驟 7 的 PR 標題改成一句繁體中文摘要，不再等於分支名。
- 步驟 8 的標題校準改成只問標題還描述不描述得了 PR 目前的內容。
- 步驟 3.2 註明摘要就是 PR 標題，規則 4 補上標題與分支名互不套用。
- `references/behaviors.md` 的 pr 一節與 README 的 pr 說明同步新行為。

Why：
- 語言規則明列 PR 標題與描述一律繁體中文，且有 hook 在程式層強制，技能內文擋不住。
- 審查列表全是長串 ASCII slug，看不出這條 PR 改了什麼。
- 分支名給機器判階梯，標題給人看，兩者本來就承擔不同任務。
- 舊校準拿分支名比對標題，每跑一次就把繁中標題改回 slug，還通知所有審查者。

How：
- 步驟 7 改寫標題來源，並在完成條件加上「送出的標題不是分支名」。
- 步驟 8 第一項改成內容比對，寫明分支名不進入這項比對。
- 分支名維持 ASCII，`tools/slugify.sh` 與 `tools/base-branch.sh` 的行為不動。

Who：
- 使用者裁定標題讓位給語言規則，jsc-git 修改代理執行。
chore(version): 升版 jsc-git 至 0.1.3 5d6b73a5cc 
What：
- 三份 plugin manifest 的 version 由 0.1.2 升到 0.1.3。

Why：
- `pr` 技能的標題行為改了，版本要跟著動，各 CLI 才收得到更新。

How：
- 跑 `sh /root/plugins/meta/tools/sync-skill-manifest.sh /root/plugins/git`，退出碼 0。

Who：
- jsc-git 修改代理執行。
Merge pull request '新增 commit、pr 兩支技能的行為清單，標清兩者的邊界' (#23) from feat/skill-behaviors-and-version-block/behavior-list into feat/skill-behaviors-and-version-block/main ec9f1c1559
Merge pull request 'PR 標題改用繁體中文摘要，不再套用分支名' (#25) from feat/skill-behaviors-and-version-block/pr-title-language into feat/skill-behaviors-and-version-block/main 717561fa08
Merge pull request '把 commit、pr 兩支技能的行為清單收攏進 develop' (#24) from feat/skill-behaviors-and-version-block/main into develop fd5b364f0f
admin approved these changes 2026-08-31 08:18:36 +00:00
admin merged commit 5d2bafb9c9 into master 2026-08-31 08:18:38 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/git#26