 jiantw83
|
1cbe7aac3c
|
feat(狀態回報): 收尾寫一筆 skill-end 事件
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。
start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。
status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
|
2026-09-02 16:01:17 +08:00 |
|
|
jiantw83
|
1b223bd350
|
fix(pkg-update): 對齊 stop 的定義與行為，補上釘回舊版的產生路徑
What：改寫 stop 路由的定義，新增「把嫌疑套件釘回舊版重試一次」的路由，把 git 閘門提到最前面，流程由七步併成五步。
Why：原本寫 stop「不改任何檔案」，但流程走到後段才 stop 時，版本來源檔案已經被改寫過。定義跟行為對不上，使用者會以為工作區沒動過，實際上留了一地改過的檔案沒人回報。另外技能要求「套件停留在舊版時要寫註解說明原因」，卻沒有任何一條路由會產生停留在舊版的結果，這個要求等於永遠踩不到。閘門排在套件盤點後面也不划算，工作區髒的時候，整輪全專案掃描白做。
How：stop 照實描述——第一步之前確實沒動過檔案；第二步起的 stop 要一併報出失敗工具與結束碼、已套用的套件、已改寫的版本來源檔案。建置或測試真的失敗時，先從失敗輸出點名嫌疑套件，把它們釘回舊版，重裝後只重試一次；重試過了就算通過，並標記成停留在舊版，仍失敗才走還原。git 閘門移到第一步的第一個動作，建置與測試指令也在動任何檔案之前先問清楚。
Who：pkg-update 的路由表與流程步驟。
|
2026-08-31 11:09:01 +08:00 |
|
|
jiantw83
|
992d9c759c
|
feat(pkg-update): 加入註解界線規則與 README 同步說明
What：在 pkg-update 技能的步驟 3.5 新增註解界線規則，並在 README.md 的 pkg-update 段落同步同一份指引。
Why：套件更新途中常會為了鎖版本或繞道不相容而留註解，過去沒有界線，容易把文件相關資訊寫進程式碼註解，造成註解與文件重複、且內容很快過期。
How：規則正文留在 jsc-review 的 references/comment-scope.md，這裡只放指引與連結、不重複清單。註解只寫鎖版本或繞道的原因；第三方套件的 issue 連結屬白名單，用來說明繞道成因與解除條件；內部議題編號、工作包編號、人名與 @ 提及、產生來源署名一律不得寫。步驟 3.5 另附可檢核的完成條件，並指向 jsc-hooks 的 comment-scope.sh 即時告警與修正回檢流程。
Who：jsc-pkg 的 pkg-update 技能，以及 README.md 的技能說明區塊。
|
2026-08-26 19:00:37 +08:00 |
|
 jiantw83andClaude Opus 5
|
ea11ca0590
|
fix(pkg): 補齊稽核缺失並修掉護欄失效
What：依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。
Why：稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項；退碼誤判與查表錯誤則會讓良性狀況被當成失敗。
How：逐項對照 references/guidelines.md 的審核檢查清單修正，新增的工具都有
documented exit codes，並以真實執行驗證每條路徑。
Who：jsc-meta:skill-check 例行稽核（2026-08-25）。
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
2026-08-25 14:58:54 +08:00 |
|
|
jiantw83
|
5ae3611960
|
feat(pkg-update): 新增版本改寫工具並改用工具呼叫
What: 新增 tools/apply-version.sh，依 ecosystem 改寫專案的版本來源檔（package.json / requirements.txt / pyproject.toml / *.csproj），把指定套件釘選到指定版本；skills/pkg-update/SKILL.md 的改寫步驟改成呼叫這支工具；README.md 補上工具說明；plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本號由 0.0.1 升到 0.0.2。
Why: jsc-meta:skill-check 稽核發現 SKILL.md 用文字描述改寫邏輯，不符合「邏輯放工具、SKILL.md 只放步驟」的準則，需要把改寫邏輯抽成獨立工具。
How: 依 tools/list-packages.sh 已支援的四種生態（nodejs 的 package.json、python 的 requirements.txt 或 pyproject.toml、dotnet 的 *.csproj）撰寫對應的 parse 與 rewrite 邏輯，找不到檔案時 exit 3、找不到套件時 exit 4；SKILL.md 步驟改成呼叫 `tools/apply-version.sh {ecosystem} {project dir} {name} {version}`；三份 manifest 版本號同步升級。
Who: jsc-pkg 套件更新流程，影響 pkg-update 技能與所有安裝 jsc-pkg 的使用者。
|
2026-08-24 14:48:30 +08:00 |
|
|
jiantw83andClaude Fable 5
|
a35e122cfe
|
docs(pkg): translate SKILL.md into English per guidelines
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 14:29:45 +08:00 |
|
|
jiantw83andClaude Fable 5
|
f5d6ec0bff
|
feat(pkg): 匯入 jsc-pkg 技能組
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 13:08:43 +08:00 |
|