Commit Graph
127 Commits
Author SHA1 Message Date
admin cc9cd66eb5 Merge pull request 'feat/change-requests/main' (#31) from feat/change-requests/main into develop
Reviewed-on: #31
2026-08-28 01:51:17 +00:00
admin 41cfc8d54c Merge pull request 'feat/change-requests/skill-governance-updates' (#30) from feat/change-requests/skill-governance-updates into feat/change-requests/main
Reviewed-on: #30
2026-08-28 01:46:59 +00:00
jiantw83 08a7d23a12 feat(skill-check): 加入流程效率稽核 2026-08-28 09:30:27 +08:00
jiantw83 b0ea356ff5 feat(meta): 建立 PR 收尾回報單一規範 2026-08-28 09:30:23 +08:00
admin ccae8bfd7a Merge pull request 'docs(meta): 準則的重啟閘門狀態檔規則改為一支 CLI 一份' (#28) from fix/restart-gate-per-cli-state into develop
Reviewed-on: #28
2026-08-27 10:51:30 +00:00
jiantw83 29080ca6e8 chore(meta): 三份 manifest 版本升到 0.1.5
What:`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 從 0.1.4 升到 0.1.5,三份同步,description 不動。

Why:準則改了就要讓機器上的 `jsc-meta` 換到新版,四支異動技能與 skill-check 讀的才是這一版的規則。版本不升,`version-guard.sh` 的版本前置檢查與 `jsc-cli:deploy` 的落後判定都看不出本機還是舊版,機器上就不會被提示更新。

How:只改版號一個欄位。三份必須一致:`plugin.json` 給 marketplace、`.claude-plugin` 給 claude、`.codex-plugin` 給 codex,任一份落後都會讓那一路的版本比對抓錯。這一輪只改準則正文、沒有新增或移除技能,所以走修訂號。

Who:`jsc-meta` 的三份 plugin manifest,配合這一輪準則修正發佈。
2026-08-27 18:49:59 +08:00
jiantw83 baa1f1118f docs(guidelines): 重啟閘門狀態檔規則改為一支 CLI 一份
What:`references/guidelines.md`「部署後重啟閘門」的規則表改四列——狀態檔路徑改成 `$JSC_HOME/restart-required.d/{cli}` 並標明一支 CLI 一份、清除時機標明只清自己那一份、原本的「狀態檔存在時」與「狀態檔不存在時」兩列改寫成「該 CLI 那份存在時」與「該 CLI 那份不存在時」,並寫明別支 CLI 的狀態檔不影響這一支。另外新增一段「狀態檔為什麼一支 CLI 一份」,記下 2026-08-27 部署時實測出的兩個缺陷,並把它寫成通則。

Why:準則是技能組的規則正本,`jsc-hooks` 的實作與 `jsc-cli` 的說明都對著它看。實作改成一支 CLI 一份而準則還停在單一檔案,下一次 skill-check 會判成實作違規,也可能有人照準則把實作改回去。這兩個缺陷是實測抓到的、不是推測,理由留在準則裡才擋得住下一次的簡化。

How:規則表只改該改的四列,判定位置與逃生門兩列不動。新增那段把缺陷寫清楚——並行部署互相覆蓋只留最後一支,以及任一支重啟就解除全部五支的閘門——再收成通則:跨 CLI 或跨工作階段的狀態檔,設計時先問清楚那個事實屬於誰,並指出工作包歸屬狀態檔踩過同一類錯誤。豁免清單那九支與「清單認技能名不認呼叫鏈」不動,這一輪沒有動到豁免範圍。

Who:`jsc-meta` 的技能準則,部署後重啟閘門這條規則的正本。
2026-08-27 18:49:59 +08:00
admin a65f546911 Merge pull request 'feat(meta): 新增 SKILLSET 頁型與部署後重啟閘門準則,稽核加流程檢查四項' (#26) from feat/skillset-governance/main into develop
Reviewed-on: #26
2026-08-27 08:54:50 +00:00
admin 0ce64ba392 Merge pull request 'feat(meta): 新增 SKILLSET 頁型與稽核流程檢查,四支異動技能收尾寫異動報告' (#25) from feat/skillset-governance/page-type-and-process-audit into feat/skillset-governance/main
Reviewed-on: #25
2026-08-27 08:39:07 +00:00
jiantw83 816fe07fbd chore(manifest): 三份 manifest 版本升到 0.1.4
What:`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.3 改為 0.1.4。

Why:本次準則新增 `SKILLSET` 頁型、部署後重啟閘門與流程檢查四項,`skill-check` 多了 marketplace 同步必經步驟,四支異動技能也多了收尾步驟,屬於行為變更,版本要跟著往上走,各 CLI 才知道要更新。

How:三份只改 `version` 一個欄位,其餘內容不動,三份保持同一版號。

Who:`jsc-meta` 外掛的套件描述檔。
2026-08-27 16:34:16 +08:00
jiantw83 478f670d53 feat(skillset-report): 四支異動技能收尾套用到工作階段、驗證並寫異動報告
What:`skill-new`、`skill-update`、`skill-delete`、`skillset-update` 四支各新增一個收尾步驟,內含三個子步驟:把改動套用到目前工作階段、逐項驗證功能真的動得起來、把驗證結果附加到 wiki 的 `SKILLSET_{HASH}`。四支的 `description` 同步補上這段收尾。

Why:原本四支都以「開了 PR」作為收尾。PR 開完技能還沒進到任何 CLI,改動到底動不動得起來沒人驗過,壞了要等下一次有人踩到才知道。技能組的異動紀錄也一樣沒有落腳處:同一支技能改過幾次、每次改了什麼,只能翻 git 紀錄。

How:套用那一步分兩條路徑,依改動走到哪裡決定。PR 已經合併到 `master` 才走 `jsc-cli:deploy` 更新模式,並依提示重新啟動;PR 還停在 `develop` 或還在等審核,就改用工作樹驗證,報告標成「工作樹驗證、尚未部署」,並點名還沒合併的發佈 PR。分兩條路徑的理由是完成條件達不到:marketplace 與 `version-guard.sh` 都讀存取庫的預設分支,停在 `develop` 的改動 `deploy` 一定看不到,硬跑就卡在永遠達不到的完成條件上。驗證那一步要求逐項比對結束碼與實際輸出,不接受「跑完沒報錯」;對不上就回到套用那一步重跑,不往下走。報告一律附加一節、不覆蓋舊節,要看一支技能改過幾次就在同一頁上翻;寫不進去就把頁名與未寫入的內容交回使用者,這一步留著不結案。

Who:`jsc-meta` 的四支技能組異動技能,以及日後查技能組異動紀錄的人。
2026-08-27 16:34:16 +08:00
jiantw83 9a0ea8e248 feat(skill-check): 稽核加入 marketplace 同步必經步驟與流程檢查四項
What:`skills/skill-check/SKILL.md` 兩處增修。第 2 步的稽核範圍明寫要逐項涵蓋準則的流程檢查四項,四項各列一條,完成條件改成「每個 domain 的稽核結果對所有清單項目都有結論,含這四項」;新增第 5 步「同步 marketplace 正本」,四個結束碼各自寫明怎麼處理,原本的複查與開 PR 順延為第 6、7 步。

Why:`sync-marketplace.sh` 原本沒有出現在任何技能流程裡,跑不跑全憑人記得。正本在 `plugins/meta`,每個 domain 存取庫各留一份位元組完全相同的副本,稽核改完不同步,就會有存取庫註冊到過期的 plugin 清單。流程檢查四項同理:準則加了項目,稽核不點名就沒有人會查,四項等於沒加。

How:同步列為必經步驟,不是選項。呼叫時拿既有項目自己現在的值重寫一次,重寫同一筆是冪等的,所以不必先判斷哪一筆該改。四個結束碼逐一分流:3 是寫好了但有 domain 沒 clone 到本機,先跑 `sync-domains.sh` 再重跑;2 是參數個數不對;1 是缺 python3、正本讀不到或副本位元組不一致;0 才代表每份副本完全相同,而且是腳本自己驗過的。

Who:`jsc-meta:skill-check` 的例行合規稽核流程。
2026-08-27 16:34:16 +08:00
jiantw83 6447416c7b docs(guidelines): 準則新增 SKILLSET 頁型、部署後重啟閘門與流程檢查四項
What:`references/guidelines.md` 四處增修。環境變數表新增 `JSC_WIKI_REPO_SKILLSET` 與 `JSC_RESTART_GATE` 兩列;wiki 頁命名總表新增 `SKILLSET` 一列,並補上雜湊來源為被改動的 domain 存取庫 `{owner}/{repo}`、頁內累積歷次異動兩段說明;新增「部署後重啟閘門」一節,用表寫下狀態檔、清除時機、判定位置與逃生門,另附九支豁免技能的表與「清單認的是技能名,不是呼叫鏈」一段;審核檢查清單末尾新增流程檢查四項。

Why:這批規則要落到四個 domain 的腳本與技能裡,準則是它們的唯一真實來源。規則只留在各自的實作裡,改一邊忘一邊,稽核就沒有對照標準。三件事各有各的理由:`SKILLSET` 頁型讓技能組每次異動留下查得到的驗證紀錄;重啟閘門補上「部署換掉的是磁碟上的技能檔,工作階段載入的還是舊版」這段落差;流程檢查四項把過去踩過的坑寫成逐項確認得出來的項目。

How:閘門那一節刻意把每一支的「為什麼不能擋」逐支寫出來,不只列技能名——豁免清單日後要增刪,理由沒寫下來就得重新想一次。九支的理由收斂成同一件事:部署後還要寫得完技能組異動報告與工作日誌,整批擋下去「先重啟」與「先寫完報告」會互相打死,通則另外寫進流程檢查第 4 項「閘門不自鎖」。「清單認技能名不認呼叫鏈」單獨寫一段,因為後三支(`jsc-ask:ask`、`jsc-git:pr`、`jsc-git:commit`)自己不是收尾規則的主體,是為了讓前六支走得完才補進來的,日後增豁免時要一併想它會呼叫誰。流程檢查其中兩項附上踩過的實例,抽象敘述判不出來的,看實例就判得出來。

Who:`jsc-meta` 的技能準則,以及依準則稽核的 `skill-check` 與四支技能組異動技能。
2026-08-27 16:34:16 +08:00
jiantw83 47c479d65c Merge pull request 'docs(meta): 技能準則新增 PR 分支階梯與盯場輪詢間隔' (#23) from feat/sdlc-flow-rules/main into develop 2026-08-27 03:39:39 +00:00
admin 07d8583937 Merge pull request 'docs(meta): 技能準則新增 PR 分支階梯與盯場輪詢間隔' (#22) from feat/sdlc-flow-rules/pr-ladder-guideline into feat/sdlc-flow-rules/main
Reviewed-on: #22
2026-08-27 03:26:19 +00:00
jiantw83 02b36a315c chore(manifest): 三份 manifest 版本升到 0.1.3
What:`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.2 改為 0.1.3。

Why:技能準則新增了一節規則與一項稽核檢查,準則有異動就要 bump 版本,安裝端才拿得到新版。

How:三份只改 `version` 一個欄位,其餘內容不動,三份保持同一版號。

Who:`jsc-meta` 外掛的套件描述檔。
2026-08-27 11:20:30 +08:00
jiantw83 769d8f3f33 docs(guidelines): 準則新增 PR 分支階梯與盯場輪詢間隔
What:`references/guidelines.md` 新增「PR 分支階梯」一節,列出兩種型別的階梯、多層子功能的組法、base 一律由 `jsc-git/tools/base-branch.sh --derive` 推導、功能主幹自動建立,以及最後一級不能省;環境變數表補上 `JSC_PR_WATCH_INTERVAL`;稽核檢查清單新增一項「PR 的 base 符合 PR 分支階梯,沒有越級」。

Why:階梯要對所有存取庫成立,就必須有一份正本。放在技能準則裡,各 domain 的 README 與參考文件才能只寫摘要並指回來,不會養出好幾份互相打架的規則;稽核清單少了這一項,越級開的 PR 也沒有任何一關會發現。

How:階梯只寫表與六條說明,不寫實作細節,推導行為的正本仍在 `jsc-git/tools/base-branch.sh`。特別寫明第 4 條「推不出唯一合法基底就中止並詢問使用者,不猜,也不退回 `develop`」與第 6 條「`develop` 併進 `master` 才會生效」——marketplace 與 `version-guard.sh` 讀的都是存取庫的預設分支,階梯最後一級省掉就等於沒有發布。

Who:所有 jsc domain 存取庫的 PR,以及跑 `jsc-meta:skill-check` 稽核的人。
2026-08-27 11:20:30 +08:00
admin 44fce3a68c Merge pull request 'feat/ste100-scope-encoding-and-lint' (#20) from feat/ste100-scope-encoding-and-lint into develop
Reviewed-on: #20
2026-08-27 01:58:46 +00:00
jiantw83 69003a7d2c fix(lint): 修正簡體字並把規則實作本身加進跳過清單
What:把 sync-domains.sh 檔頭註解的簡體字「脏」改成正體「髒」;ste100-lint.sh 的
skip() 新增三個檔案:jsc-hooks 的 simplified.txt、ste100-guard.sh、lang-guard.sh。

Why:「脏」是既有的簡體字,擴充字表後才驗出來,正好證明檢查有效。另外三個檔案
裡的簡體字是被列舉、被討論的對象,不是被使用;掃它們會每次都命中卻永遠改不掉,
久了就會有人乾脆把整個檢查關掉。

How:skip() 沿用既有的 case 比對,同時吃絕對路徑與純檔名兩種寫法,並在註解裡
寫明為什麼要跳過,避免後人誤以為是漏掉。

Who:STE100 語言規則的機檢工具。
2026-08-27 09:50:42 +08:00
jiantw83 7a2544772f feat(manifest): 三份 manifest 版本升到 0.1.2
What
- `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 由 0.1.1 升到 0.1.2。

Why
- STE100 規則正文與機檢工具都有變更,安裝端要靠版本號才知道該更新。

How
- 跑 `sh tools/sync-skill-manifest.sh /root/plugins/meta`,三份 manifest 一起 bump,
  README 的「Skills 目錄」無增減。

Who
- 影響安裝或更新 jsc-meta 的所有 CLI。
2026-08-27 09:43:20 +08:00
jiantw83 7c963b73cf feat(lint): 機檢改讀共用簡體字表、加亂碼類別、掃描擴及程式碼檔
What
- 簡體字表改成優先讀 jsc-hooks 的 `hooks/simplified.txt`,讀不到才退回內建備援字表。
- 新增「亂碼」類別:U+FFFD 替代字元、雙重編碼的 `�`,以及 Latin-1 雙重編碼特徵。
- 掃描範圍加入程式碼檔(sh、js、ts、py、cs、java、go、rb、php、sql、yml、yaml、toml)。
- 檔頭註解補上分流理由,並把本檔自己加進跳過清單。

Why
- 字表寫死在本檔,和 hook 端的守門字表各自維護,兩邊遲早不一致;真實來源只該有一份。
- 內建備援不能拿掉:jsc-hooks 不一定裝在這台機器上,單獨 clone plugins/meta 或 CI 只取
  一個 repo 都會發生。缺基礎設施就讓簡體字檢查靜靜失效,會把「沒命中」變成假通過。
- 新規則要求所有非程式碼輸出無亂碼、無簡體字,程式碼註解也算,所以檢查得看得到程式碼檔。

How
- `simplified_file()` 的搜尋路徑比照 `jsc-hooks/hooks/lib.sh` 的 `jsc_gitea_sh()`:先環境變數
  `JSC_SIMPLIFIED_FILE`,再並排存取庫版面,最後已安裝的 plugin 快取版面取版本排序最後一份。
- 字表格式一行一個字,`#` 開頭與空行忽略,串成 grep -E 交替式。
- 分流:`.md` 與 `.json` 跑全部六項;程式碼檔只跑簡體字與亂碼。中國用語、半形標點、AI 套話、
  並列斜線這四項在程式碼裡會被英文標點、路徑、URL、正規表示式大量誤報,留著只會讓人忽略輸出。
- 亂碼樣式一律用十六進位跳脫寫,本檔才不會存進真的亂碼字元自己打自己。

Who
- 影響跑 `tools/ste100-lint.sh` 的人與 `jsc-meta:skill-check`、`jsc-meta:ste100-sync` 兩支技能。
2026-08-27 09:43:20 +08:00
jiantw83 19303ca555 feat(ste100): 語言規則納入適用範圍與編碼要求
What
- `references/ste100.md` 新增「適用範圍」與「編碼」兩節,並以表格列出各類輸出是否適用。
- 「機檢」一節補上新的類別清單與文件檔、程式碼檔的分流說明。
- `references/guidelines.md`「語言」第 1 條改寫成「所有非程式碼輸出一律繁體中文、UTF-8、
  無亂碼、無簡體字」,並以一行指引指回 `references/ste100.md`。
- 「審核檢查清單」新增一個可勾選項目,涵蓋非程式碼輸出的語言與編碼,且要求機檢全綠。

Why
- 舊條文只講「交談與輸出內容」用 STE100 繁中,沒有把程式碼註解、commit 訊息、PR 描述、
  wiki 頁這些實際會產出的東西點名,執行時容易各自解讀。
- 編碼要求原本只有基礎紀律裡的一句「UTF-8,無亂碼」,沒有說明什麼算亂碼,也沒有寫明
  不得出現簡體字,機檢與人工判讀對不上。

How
- 適用範圍用表格逐項標「是」或「否」,並明講程式碼識別字、關鍵字、API 名稱不受限,
  SKILL.md 維持整份英文。
- 編碼用表格寫要求、內容與常見違規,違規範例直接對應機檢的「亂碼」類別。
- 細節只寫在 `references/ste100.md` 一處,guidelines.md 只留摘要與指引,維持單一真實來源。

Who
- 影響所有 jsc 技能的輸出與審核;撰寫技能與跑 `jsc-meta:skill-check` 的人要照新清單檢查。
2026-08-27 09:43:20 +08:00
admin 444ab9762b Merge pull request 'docs/meta-check-report-wiki-types' (#18) from docs/meta-check-report-wiki-types into develop
Reviewed-on: #18
2026-08-26 02:51:30 +00:00
jiantw83 d9d1dafe6e docs(guidelines): 準則新增 CHECK 與 REPORT 兩種 wiki 頁類型
What: wiki 頁命名總表加入 CHECK(擁有者 jsc-cli)與 REPORT(擁有者 jsc-log),環境變數表加入 JSC_WIKI_REPO_CHECK 與 JSC_WIKI_REPO_REPORT,並補上兩者的雜湊來源規則。
Why: 準則是這兩張總表的唯一真實來源。新頁類型只加進程式的白名單而沒寫進準則,下一次審核就會把它們當成漏網項目。
How: CHECK 記的是一台執行環境而不是存取庫,雜湊來源改用 {主機名}/{登入帳號},是總表的唯一例外,明文寫清楚為什麼。REPORT 用既有的「加上主題字串」規則,雜湊來源為 {owner}/{repo}/{期間},年月週日各一頁。
Who: wiki 頁面命名與 wiki 存取庫解析。
2026-08-26 10:46:11 +08:00
admin 106b9f7df3 Merge pull request 'fix/single-digit-version-carry' (#16) from fix/single-digit-version-carry into develop
Reviewed-on: #16
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-25 08:58:29 +00: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
admin dba1aa2b44 Merge pull request 'fix/skillset-audit-compliance-and-guard-fixes' (#15) from fix/skillset-audit-compliance-and-guard-fixes into develop
Reviewed-on: #15
2026-08-25 07:15:11 +00:00
jiantw83andClaude Opus 5 bdfea58fab chore(meta): 三份 manifest 同步升版並同步 marketplace 正本
What:三份 plugin manifest 版本同步 bump,兩份 marketplace 檔與 plugins/meta 正本對齊。

Why:準則要求技能異動必須同步升版;marketplace 副本必須與正本完全一致。

How:以 jsc-meta 的 tools/sync-skill-manifest.sh 升版,marketplace 檔由正本複製。

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 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 9ab5b42864 fix(meta): 補齊稽核缺失並修掉護欄失效
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
admin 287e3ff113 Merge pull request '發佈 jsc-meta 0.0.8:技能版本前置檢查' (#14) from develop into master
Reviewed-on: #14
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-25 04:56:37 +00:00
jiantw83andClaude Opus 5 262c02e38d chore(plugin 版本): 三份 manifest 升版至 0.0.8
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 11:52:38 +08:00
jiantw83andClaude Opus 5 7eb179f3a1 docs(guidelines): 新增版本前置檢查規範與豁免清單
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 11:52:38 +08:00
admin 385cf755fd Merge pull request '發佈 jsc-meta 0.0.7:marketplace 正本移至 plugins/meta' (#13) from develop into master
Reviewed-on: #13
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-24 10:19:15 +00:00
admin fcdfc509fb Merge pull request 'chore(marketplace 正本): 正本移至 plugins/meta(升版 0.0.7)' (#12) from chore/marketplace-canon-to-meta into develop
Reviewed-on: #12
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-24 10:13:39 +00:00
jiantw83andClaude Opus 5 3435644801 chore(plugin 版本): 三份 manifest 升版至 0.0.7
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-24 18:00:35 +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
admin 045edca6d2 Merge pull request '發佈 jsc-meta 0.0.6:guidelines 收錄 DELIVER 頁型' (#11) from develop into master
Reviewed-on: #11
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-24 09:50:13 +00:00
admin f51bac0498 Merge pull request 'docs(guidelines): 新增 DELIVER 頁型與 JSC_WIKI_REPO_DELIVER 環境變數' (#10) from docs/deliver-page-type-guidelines into develop
Reviewed-on: #10
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-24 09:34:19 +00:00
jiantw83andClaude Opus 5 58bcaa50e5 chore(plugin 版本): 三份 manifest 升版至 0.0.6
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-24 17:24:45 +08:00
jiantw83andClaude Opus 5 a87946784b docs(guidelines): 新增 DELIVER 頁型與 JSC_WIKI_REPO_DELIVER 環境變數
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-24 17:24:45 +08:00
admin db8baf1f8c Merge pull request '發佈 jsc-meta 0.0.5:抽出技能目錄同步與引用查找共用工具' (#9) from develop into master
Reviewed-on: #9
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-24 08:27:40 +00:00
admin ce3dab42db Merge pull request 'fix/sync-marketplace-and-extract-skill-tools' (#8) from fix/sync-marketplace-and-extract-skill-tools into develop
Reviewed-on: #8
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-24 08:00:44 +00:00
jiantw83 ef974b4ef5 fix(meta): 修正外掛描述標點並同步版本號至 0.0.5
什麼:將 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest 中 jsc-meta 自身的 description 由斜線「新建/更新/刪除」改為頓號「新建、更新、刪除」,並將 version 由 0.0.4 一併提升至 0.0.5。
為何:斜線列舉違反 STE100 純敘述、不用斜線分隔清單的規則,描述文字修正後三份 manifest 需要對應 bump 版本以標示這次的合規性修正。
如何:三份 manifest 同步套用相同的標點修正與版本號更新,確保 claude、codex 兩種外掛載入路徑與根目錄 plugin.json 三者版本與描述一致。
負責範圍:jsc-meta 外掛自身的合規性修正與版本標示;skill-delete、skill-update 兩支 SKILL.md 的 description 精簡改動已隨其步驟修改一併納入 Group B 的提交。
2026-08-24 14:49:37 +08:00
jiantw83 4454d62e82 feat(meta): 抽出技能目錄同步與引用查找為共用工具
什麼:新增 tools/sync-skill-manifest.sh(重建 domain README 的「Skills 目錄」區塊並將三份 plugin manifest 的版本一併 bump)與 tools/find-skill-refs.sh(掃描所有 jsc domain 存取庫,列出技能名稱或 /jsc-{domain}:{name} 指令形式的引用檔案),並更新 skill-check、skill-delete、skill-new、skill-update、skillset-update 五支 SKILL.md 改為呼叫這兩支工具。skill-delete 與 skill-update 的 frontmatter description 也一併收斂在此次改動內,配合本次流程調整精簡文字。
為何:五支技能先前各自以近乎相同的內嵌文字描述「同步 README、bump 版本」的機械流程,重複維護成本高且容易漂移;skill-delete 的引用盤點步驟先前只是一段沒有工具、也沒有標明子代理人的裸 grep 指示,稽核時難以驗證涵蓋範圍。
如何:把兩段機械流程各自抽成一支冪等 shell 工具,五支技能的對應步驟改為「子代理人只做內容判斷與修改,機械式同步與版本 bump 一律呼叫工具」;skill-delete 步驟 4 改呼叫 find-skill-refs.sh 取代裸 grep 說明。
負責範圍:jsc-meta 技能組自我管理,skill-check、skill-delete、skill-new、skill-update、skillset-update 五支技能共用的機械流程去重。
2026-08-24 14:49:23 +08:00
jiantw83 720ec6194e fix(marketplace): 同步 marketplace.json 至權威格式並修正標點
什麼:為 .agents/plugins/marketplace.json 與 .claude-plugin/marketplace.json 補齊每個 plugin 條目缺少的 description 與 marketplace 層級的 description、owner 欄位,並將 jsc-meta 條目描述中的斜線「新建/更新/刪除」改為頓號「新建、更新、刪除」以符合 STE100。
為何:兩份 marketplace.json 先前落後於 plugins/jsc 的權威版本,缺少說明文字會讓使用者在瀏覽 marketplace 時看不到各外掛用途,斜線清單也違反 STE100 純敘述、不用斜線列舉的規則。
如何:以 plugins/jsc 的 marketplace.json 為基準,逐一補上缺漏的 description 與 owner 欄位,並將受影響條目的標點改為頓號。
負責範圍:jsc-meta skill-check 例行合規稽核,marketplace 中繼資料同步項目。
2026-08-24 14:49:06 +08:00
admin 43f9f09bfe Merge pull request 'docs/learn-wiki-page-type' (#7) from docs/learn-wiki-page-type into develop
Reviewed-on: #7
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
2026-08-24 03:46:24 +00:00
jiantw83andClaude Fable 5 1fdfdaf15a chore(manifest): 版本號提升至 0.0.4
What:將 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest 的 version 由 0.0.3 提升至 0.0.4。

Why:guidelines.md 新增 LEARN 頁型與 JSC_WIKI_REPO_LEARN 屬於準則內容變更,需要發布新版本讓各 CLI 更新取得。

How:同步修改三份 manifest 的 version 欄位,保持三處版本號一致。

Who:jsc-meta 技能組(manifest 維護)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-24 11:36:59 +08:00
jiantw83andClaude Fable 5 85cfa77ed1 docs(guidelines): 新增 LEARN 頁型與 JSC_WIKI_REPO_LEARN 環境變數
What:在 references/guidelines.md 的 wiki 頁命名總表新增 LEARN 頁型(LEARN_CONTENTS 教訓目錄、LEARN_{HASH} 技能教訓頁),並在環境變數表新增 JSC_WIKI_REPO_LEARN,未設定時退回 JSC_WIKI_REPO。

Why:jsc-log 新增 learn 技能,需要在準則中收錄對應的 wiki 頁型與環境變數,讓各技能對頁面命名與 wiki 存取庫解析有一致依據。

How:比照既有 LOG/ERROR 頁型格式,於環境變數表與頁命名總表各補一列,維持表格欄位與退回規則一致。

Who:jsc-log(learn 技能)為此頁型的擁有者。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-24 11:36:48 +08:00