fix/skill-check-compliance-and-flow #19

Merged
admin merged 5 commits from fix/skill-check-compliance-and-flow into develop 2026-08-31 03:24:30 +00:00
5 Commits
Author SHA1 Message Date
jiantw83 4d15b618c7 chore(plugin): 提升外掛版號以帶出這批行為變更
- 這批改動含判準變更與兩支新腳本,屬於行為變更,不是純文件修飾。
- claude、codex 與共用的三份描述檔一起帶。版號不一致會讓安裝端拿到舊的技能。
2026-08-31 11:07:05 +08:00
jiantw83 1efebdfd22 docs(review): 說明檔對齊新的技能行為與工具清單
- 三支技能的說明改成與技能文件一致,讀說明檔的人不會拿到舊的判準。
- 補上兩支新腳本的用途、輸入輸出與結束碼。
- 偵測腳本的結束碼說明補上缺 grep 這個原因。
- 刻意移除的那道保護另寫一段提醒:hook 關掉或沒接上時,認可前要先跑註解清理。
2026-08-31 11:07:05 +08:00
jiantw83 ced541faa5 fix(review): 補上註解腳本路徑與缺漏的失敗分支
- 註解範圍腳本的路徑少一層目錄,照著寫會找不到檔案,補上 hooks 那一層。
- 建置測試跑完卻失敗時沒有分支可走,只寫得出「通過」。現在要指出指令、結束碼,並判斷失敗是不是本次改動造成的。
- 取得差異失敗時原本會安靜跳過,現在原樣帶出錯誤並停手。判不出範圍不等於沒有東西要審。
- 禁止清單原本抄了兩份,改成只指向註解範圍的正本,兩份不會各自演化。
- 第二組不再重掃樣式判得出來的項目。hook 關掉或沒接上時就沒有最後一道網,這件事寫進技能文件,不讓它默默消失。
- 差異只算一次,落成一份快照檔給六組共讀;檔名帶執行代號,同一台機器平行跑不會互相覆蓋。註解清理改成一個檔案一個 sub agent 平行跑。
2026-08-31 11:07:05 +08:00
jiantw83 f6cd1f9ef7 feat(api-doc): 範例只掛純量成員,類別型往下遞迴
- 使用者要求改判準。類別型參數與中間層的類別屬性只留說明,範例責任往下推給屬性,一路走到最內層的純量。
- 一個值只有一個出處。範例掛在父層,屬性一改就過期,讀的人拿到的是沒有屬性定義背書的一份資料。
- 集合看元素型別,不看外殼;字典看值型別。字串集合與字串判出來一樣,位址集合與位址判出來也一樣。
- 壞味道清單原本寫「輸入與輸出參數都必須有範例」,與新判準衝突,兩支技能會對同一段程式碼給出不同標準。一併改成同一套。
- 說明與範例的兩份檢核表併成一個 sub agent,同一批資料模型檔只讀一次。
- 順帶補上偵測腳本結束碼二漏掉的一個原因:環境缺 grep。原本只寫參數與路徑,遇到這個原因換路徑重跑永遠清不掉。
2026-08-31 11:07:05 +08:00
jiantw83 a0bd488ac8 feat(tools): 新增發現合併與變更註解兩支腳本
- 合併、去重、排序原本寫在兩支技能的步驟文字裡,各寫一份就會各自演化。改由腳本執行,並定下六欄 TSV 的回報格式。格式不對就擋下並指出是第幾列,不猜、不放行、不自行補欄。
- 另一支腳本列出本次改到的註解行,清理範圍不再靠肉眼判讀。
- 註解樣式與非程式碼副檔名清單沿用註解範圍腳本的同一份,不另立第二套判準。markdown 的標題行開頭就是井字號,判準不一致就會把整份文件當成註解。
2026-08-31 11:07:05 +08:00