chore(release): 放行技能組稽核修正到預設分支 #20

2026-08-31T03:53:30Z

jiantw83 commented

2026-08-31 03:53:30 +00:00

摘要

把 develop 上這一輪技能組稽核的修正放行到預設分支。marketplace 與版本前置檢查都讀預設分支，只合到 develop 的話已安裝的 CLI 抓不到任何改動。

本次放行 6 個提交。

變更內容

內容與 develop 上已合併的各支 PR 相同，這一支只做分支放行，不含新的改動。

測試結果

各項檢查在合併進 develop 之前已經跑過並通過：腳本語法檢查、語言檢查、腳本結束碼宣告檢查全部無發現；涉及 hook 的存取庫另外實測過五支 CLI 的冒煙測試。本支未再新增程式碼，因此沒有新的測試項目。

前置相依

無。

## 摘要把 develop 上這一輪技能組稽核的修正放行到預設分支。marketplace 與版本前置檢查都讀預設分支，只合到 develop 的話已安裝的 CLI 抓不到任何改動。本次放行 6 個提交。 ## 變更內容內容與 develop 上已合併的各支 PR 相同，這一支只做分支放行，不含新的改動。 ## 測試結果各項檢查在合併進 develop 之前已經跑過並通過：腳本語法檢查、語言檢查、腳本結束碼宣告檢查全部無發現；涉及 hook 的存取庫另外實測過五支 CLI 的冒煙測試。本支未再新增程式碼，因此沒有新的測試項目。 ## 前置相依無。

jiantw83 added 6 commits 2026-08-31 03:53:30 +00:00

feat(tools): 新增發現合併與變更註解兩支腳本 a0bd488ac8

- 合併、去重、排序原本寫在兩支技能的步驟文字裡，各寫一份就會各自演化。改由腳本執行，並定下六欄 TSV 的回報格式。格式不對就擋下並指出是第幾列，不猜、不放行、不自行補欄。
- 另一支腳本列出本次改到的註解行，清理範圍不再靠肉眼判讀。
- 註解樣式與非程式碼副檔名清單沿用註解範圍腳本的同一份，不另立第二套判準。markdown 的標題行開頭就是井字號，判準不一致就會把整份文件當成註解。

feat(api-doc): 範例只掛純量成員，類別型往下遞迴 f6cd1f9ef7

- 使用者要求改判準。類別型參數與中間層的類別屬性只留說明，範例責任往下推給屬性，一路走到最內層的純量。
- 一個值只有一個出處。範例掛在父層，屬性一改就過期，讀的人拿到的是沒有屬性定義背書的一份資料。
- 集合看元素型別，不看外殼；字典看值型別。字串集合與字串判出來一樣，位址集合與位址判出來也一樣。
- 壞味道清單原本寫「輸入與輸出參數都必須有範例」，與新判準衝突，兩支技能會對同一段程式碼給出不同標準。一併改成同一套。
- 說明與範例的兩份檢核表併成一個 sub agent，同一批資料模型檔只讀一次。
- 順帶補上偵測腳本結束碼二漏掉的一個原因：環境缺 grep。原本只寫參數與路徑，遇到這個原因換路徑重跑永遠清不掉。

fix(review): 補上註解腳本路徑與缺漏的失敗分支 ced541faa5

- 註解範圍腳本的路徑少一層目錄，照著寫會找不到檔案，補上 hooks 那一層。
- 建置測試跑完卻失敗時沒有分支可走，只寫得出「通過」。現在要指出指令、結束碼，並判斷失敗是不是本次改動造成的。
- 取得差異失敗時原本會安靜跳過，現在原樣帶出錯誤並停手。判不出範圍不等於沒有東西要審。
- 禁止清單原本抄了兩份，改成只指向註解範圍的正本，兩份不會各自演化。
- 第二組不再重掃樣式判得出來的項目。hook 關掉或沒接上時就沒有最後一道網，這件事寫進技能文件，不讓它默默消失。
- 差異只算一次，落成一份快照檔給六組共讀；檔名帶執行代號，同一台機器平行跑不會互相覆蓋。註解清理改成一個檔案一個 sub agent 平行跑。

docs(review): 說明檔對齊新的技能行為與工具清單 1efebdfd22

- 三支技能的說明改成與技能文件一致，讀說明檔的人不會拿到舊的判準。
- 補上兩支新腳本的用途、輸入輸出與結束碼。
- 偵測腳本的結束碼說明補上缺 grep 這個原因。
- 刻意移除的那道保護另寫一段提醒：hook 關掉或沒接上時，認可前要先跑註解清理。

chore(plugin): 提升外掛版號以帶出這批行為變更 4d15b618c7

- 這批改動含判準變更與兩支新腳本，屬於行為變更，不是純文件修飾。
- claude、codex 與共用的三份描述檔一起帶。版號不一致會讓安裝端拿到舊的技能。

Merge pull request 'fix/skill-check-compliance-and-flow' (#19 ) from fix/skill-check-compliance-and-flow into develop 7c8712963f

Reviewed-on: #19

admin approved these changes 2026-08-31 03:54:50 +00:00

admin merged commit 28b540307e into master

2026-08-31 03:54:53 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/review#20