Commit Graph
17 Commits
Author SHA1 Message Date
jiantw83 651dc19be9 docs(guidelines): 改寫相依版本準則並補上技能行為清單合約
What:「Manifest 相依版本」第 5 條改成部署端照樣更新,只在回報裡寫明缺哪一版。「版本前置檢查」補上相依版本檢查三列。新增「技能行為清單」一節,訂出位置、標題、節、表格、欄位與更新時機。審核檢查清單加上行為清單這一項。README 補上 behaviors.md 與 check-behaviors.sh 兩列,並把 skill-check 段落改成三組腳本。

Why:跳過更新會讓落後的 domain 永遠更新不到。它落後所以被跳過,被跳過所以永遠落後。相依版本不符要擋的是拿舊版去跑,不是把舊版換成新版。阻擋改到技能被呼叫的當下,才擋得住真正會出事的動作。行為清單要有一份格式合約,check-behaviors.sh 才有判定依據。

How:阻擋交給 jsc-hooks/hooks/version-guard.sh。版本比對由它自己實作,不呼叫 jsc-cli/tools/check-requires.sh。hook 專屬存放於 jsc-hooks,而且 jsc-cli 已宣告相依 jsc-hooks,反向呼叫會做出循環相依。兩道檢查共用同一份豁免清單。行為清單一個 domain 一份,放進該 domain 的 references/behaviors.md,技能改動與清單改動才進得了同一個 PR。

Who:涵蓋這次兩件需求的準則與說明文件,一件是相依版本不符改為阻擋執行,一件是技能行為清單。
2026-08-31 13:37:22 +08:00
jiantw83 6d28e207c7 docs(guidelines): 修正版本閘門、重啟閘門與維護頁的準則記載
版本前置檢查的豁免表只列了四項,重啟閘門的豁免表少了 hook 修復技能。
照著這兩張表設定,hook 壞掉時唯一的修復路徑會被自己擋住,修不好也繞不過。
兩張表逐項對齊三方實作與腳本現況,補成七項與十項,
並寫明各自的唯一真實來源是哪一支 hook 腳本,兩邊以後要一起改。

Wiki 頁命名總表原本替維護類型列了內容頁。
技能與樣板都沒有產生那一頁的步驟,照著總表找,只會找到一個不存在的頁。
改成只列目錄頁,並寫清楚維護登記全寫在目錄頁的表格裡;
要補內容頁就先補技能步驟與樣板,不能只在總表上寫著。

另外登記技能盤點頁的類型、環境變數與雜湊來源,說明為什麼雜湊要帶工具名稱,
補上唯讀稽核要帶唯讀旗標、行數一律讀腳本自己印的那一行兩項檢查,
並把新增的共用說明、兩份樣板與三支工具寫進 README 的檔案一覽。
2026-08-31 11:11:12 +08:00
jiantw83 0cf2392ae7 fix(skill-check): 納入腳本與 hook 驗證 2026-08-28 16:55:48 +08:00
jiantw83 c593803ed5 docs(tooling-guide): 更新 README 技能與工具目錄 2026-08-28 15:33:13 +08:00
jiantw83 b0ea356ff5 feat(meta): 建立 PR 收尾回報單一規範 2026-08-28 09:30:23 +08:00
jiantw83 fbb7004e70 fix(meta): 放寬 major 版本限制 2026-08-25 16:41:57 +08:00
jiantw83 acbbd30a0f fix(meta): 版本號改為單位數進位 2026-08-25 16:40:01 +08:00
jiantw83andClaude Opus 5 073c51e145 docs(meta): 同步文件與參考資料
What:更新 README、AGENTS.md、templates 與 references,讓文件敘述與實際行為一致。

Why:稽核發現多處文件與程式行為分歧,違反「每個意義只有單一真實來源」。

How:以實際程式行為為準改寫敘述,重複的規則收成單一來源並以一行指引指過去。

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
jiantw83andClaude Opus 5 98bc02578d refactor(marketplace 正本): 正本與權威來源改為 plugins/meta,移除對 plugins/jsc 的相依
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-24 18:00:35 +08:00
jiantw83 3c63989f80 fix(skill-check): 補強工具化與環境優先審核 2026-08-21 16:53:17 +00:00
jiantw83andClaude Fable 5 ef2577c011 feat(skill-check): 新增 skill-check 技能——例行稽核整個技能組是否符合準則
What(改了什麼):
- 新增 skills/skill-check/SKILL.md:六步流程——依 Gitea 正本 marketplace 同步全部 domain repo → 每個 domain 各派一個 sub agent 對照 guidelines 審核檢查清單稽核 → 不符項目逐項走 jsc-ask:ask 決策樹確認(套用建議修正/略過/自訂修正,每個選項標明影響範圍)→ 每個受影響 repo 各派一個 sub agent 套用修正(含 README「Skills 目錄」同步與三份 manifest 版本遞增)→ 複檢至全數通過 → 逐 repo 以 jsc-git:pr 開 PR。
- README.md「Skills 目錄」新增 skill-check 條目,並標明與 skillset-update 的分工:無變更需求走 skill-check,有變更需求走 skillset-update。

Why(為什麼改):
- 既有 skillset-update 以「一份變更需求」為前提;準則本身演進後,技能組缺少「無變更需求時」的例行體檢入口,不符項目只能等到下次改動才被發現。
- 稽核與修正拆成獨立技能,可排入定期維護,讓整個技能組持續符合 guidelines.md。

How(怎麼改):
- 依 guidelines.md 準則撰寫:英文 description 含觸發與不觸發時機(套用變更需求改用 skillset-update、單一技能改用 skill-update)、Gitea 操作一律走 jsc-gitea/tools/gitea.sh、提問一律走 jsc-ask:ask、需隔離的步驟標明 MUST run as a sub agent、每步標明完成條件。
- 複檢失敗時明定回到決策樹確認步驟,直到檢查清單全數通過才開 PR。

Who(影響哪個功能/使用者):
- 負責 jsc 技能組例行維護的維護者;一般技能新增、更新、刪除的使用者不受影響(仍走 skill-new/skill-update/skill-delete)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 09:25:59 +00:00
jiantw83andClaude Fable 5 30687d5eea feat(skillset-update): 新增 skillset-update 技能——一份變更需求批次套用到整個技能組
What(改了什麼):
- 新增 skills/skillset-update/SKILL.md:五步流程——決策樹確認變更範圍 → 依 Gitea 正本 marketplace 同步全部 domain repo → 每個受影響 domain 各派一個 sub agent 套用變更(含 README「Skills 目錄」同步與三份 manifest 版本遞增)→ 逐技能過 guidelines 審核檢查清單 → 每個受影響 repo 各開一個 PR。
- README.md「Skills 目錄」新增 skillset-update 條目,並同步更新 skill-update 與 skill-delete 的流程描述(marketplace 先行、補 clone、深度刪除驗證)。

Why(為什麼改):
- 既有 skill-update 一次只能改一個技能;跨多技能、多 domain 的規則變更(如共用流程步驟調整)需要逐 repo 重複操作,容易漏改。
- README 需與技能實際流程保持同步,此為 guidelines 審核檢查清單的必要項目。

How(怎麼改):
- 依 guidelines.md 準則撰寫:英文 description 含觸發與不觸發時機(單一技能改用 skill-update)、Gitea 操作一律走 jsc-gitea/tools/gitea.sh、提問一律走 jsc-ask:ask、需隔離的步驟標明 MUST run as a sub agent、每步標明完成條件。
- README 條目與各技能一節的敘述對齊 SKILL.md 的實際流程。
- 註:README.md 的三處變更位於同一個 diff hunk、無法乾淨拆分,故整檔併入本群組(本群組為最後一個觸及 README 的 feature 群組)。

Who(影響哪個功能/使用者):
- 需要對整個 jsc 技能組做橫向規則變更的維護者;單一技能更新的使用者不受影響(仍走 skill-update)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 08:23:53 +00:00
jiantw83andClaude Fable 5 526c6c2b93 feat(meta): 新增 ste100-sync 技能——同步上游 speak-human-tw 並釘住版本 v1.4.0
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 14:27:39 +08:00
jiantw83andClaude Fable 5 f1f7e6163a feat(meta): 新增 tools/ste100-lint.sh 語言機檢工具並補列參考表
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 14:18:42 +08:00
jiantw83andClaude Fable 5 66fa5e4aad docs(meta): README 安裝/更新/移除改為每指令一行(五個 CLI)並為相關 domain 加上 repo 連結
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 14:03:37 +08:00
jiantw83andClaude Fable 5 b6a3ef1f26 docs(meta): 以統一格式改寫繁體中文 README 與 AGENTS
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 13:08:43 +08:00
jiantw83 d759ea9208 Initial commit 2026-08-21 04:44:34 +00:00