fix/sync-marketplace-and-extract-skill-tools #8

2026-08-24T06:51:36Z

jiantw83 commented

2026-08-24 06:51:36 +00:00

摘要

需求描述：本次為 jsc-meta:skill-check 對整個 jsc 技能組進行的例行合規稽核，涵蓋此次稽核中變更範圍最大的一組修正。內容包含將兩份 marketplace.json 同步至權威格式並修正標點、將五支技能共用的機械式同步流程抽出為共用工具、以及修正 jsc-meta 外掛自身描述標點並同步版本號。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
.agents/plugins/marketplace.json	補齊落後於 plugins/jsc 權威版本的各外掛 description 與 owner 欄位，並將 jsc-meta 條目描述的斜線改為頓號以符合 STE100
.claude-plugin/marketplace.json	同步補齊缺漏欄位，並修正 jsc-meta 條目描述的斜線標點為頓號
tools/sync-skill-manifest.sh	新增工具，將重建 domain README 的「Skills 目錄」區塊與三份 plugin manifest 版本 bump 的機械流程抽出，供多支技能共用，避免各自維護導致漂移
tools/find-skill-refs.sh	新增工具，掃描所有 jsc domain 存取庫中技能名稱與指令形式的引用，取代原本沒有工具、也沒有標明子代理人的裸 grep 指示
skills/skill-check/SKILL.md	改為呼叫 sync-skill-manifest.sh 取代內嵌的 README 同步與版本 bump 說明文字
skills/skill-delete/SKILL.md	引用盤點步驟改為呼叫 find-skill-refs.sh 取代裸 grep，並改為呼叫 sync-skill-manifest.sh；frontmatter description 精簡至五句以內
skills/skill-new/SKILL.md	改為呼叫 sync-skill-manifest.sh 取代內嵌的 README 同步與版本 bump 說明文字
skills/skill-update/SKILL.md	改為呼叫 sync-skill-manifest.sh 取代內嵌說明；frontmatter description 精簡至五句以內
skills/skillset-update/SKILL.md	改為呼叫 sync-skill-manifest.sh 取代內嵌的 README 同步與版本 bump 說明文字
plugin.json	修正 jsc-meta 描述中斜線列舉為頓號，並將版本由 0.0.4 提升至 0.0.5
.claude-plugin/plugin.json	同上，修正描述標點並同步版本號至 0.0.5
.codex-plugin/plugin.json	同上，修正描述標點並同步版本號至 0.0.5

設計重點

skill-check、skill-delete、skill-new、skill-update、skillset-update 五支技能先前各自以近乎相同的內嵌文字描述「同步 README、bump 版本」這段機械流程，重複維護成本高，容易在多支技能之間產生內容漂移。抽出成 sync-skill-manifest.sh 與 find-skill-refs.sh 兩支冪等工具後，只需維護一份邏輯，符合 DRY 原則。
抽出工具後，五支技能的步驟一致改為「子代理人只負責內容判斷與修改決策，機械式的同步與版本 bump 一律直接呼叫工具」，讓子代理人標記在同一技能組內保持一致。skill-delete 的引用盤點步驟先前既沒有工具也沒有標明子代理人，稽核時難以驗證涵蓋範圍，此次一併對齊其他手足技能的作法。

測試結果

tools/sync-skill-manifest.sh 與 tools/find-skill-refs.sh 皆通過 sh -n 語法檢查。兩支工具先前已針對暫存測試素材驗證過，並通過 ste100-lint 檢查，此結果為既有驗證紀錄，本次未重新執行測試。

前置 Push Request

無

## 摘要 - 需求描述：本次為 jsc-meta:skill-check 對整個 jsc 技能組進行的例行合規稽核，涵蓋此次稽核中變更範圍最大的一組修正。內容包含將兩份 marketplace.json 同步至權威格式並修正標點、將五支技能共用的機械式同步流程抽出為共用工具、以及修正 jsc-meta 外掛自身描述標點並同步版本號。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | .agents/plugins/marketplace.json | 補齊落後於 plugins/jsc 權威版本的各外掛 description 與 owner 欄位，並將 jsc-meta 條目描述的斜線改為頓號以符合 STE100 | | .claude-plugin/marketplace.json | 同步補齊缺漏欄位，並修正 jsc-meta 條目描述的斜線標點為頓號 | | tools/sync-skill-manifest.sh | 新增工具，將重建 domain README 的「Skills 目錄」區塊與三份 plugin manifest 版本 bump 的機械流程抽出，供多支技能共用，避免各自維護導致漂移 | | tools/find-skill-refs.sh | 新增工具，掃描所有 jsc domain 存取庫中技能名稱與指令形式的引用，取代原本沒有工具、也沒有標明子代理人的裸 grep 指示 | | skills/skill-check/SKILL.md | 改為呼叫 sync-skill-manifest.sh 取代內嵌的 README 同步與版本 bump 說明文字 | | skills/skill-delete/SKILL.md | 引用盤點步驟改為呼叫 find-skill-refs.sh 取代裸 grep，並改為呼叫 sync-skill-manifest.sh；frontmatter description 精簡至五句以內 | | skills/skill-new/SKILL.md | 改為呼叫 sync-skill-manifest.sh 取代內嵌的 README 同步與版本 bump 說明文字 | | skills/skill-update/SKILL.md | 改為呼叫 sync-skill-manifest.sh 取代內嵌說明；frontmatter description 精簡至五句以內 | | skills/skillset-update/SKILL.md | 改為呼叫 sync-skill-manifest.sh 取代內嵌的 README 同步與版本 bump 說明文字 | | plugin.json | 修正 jsc-meta 描述中斜線列舉為頓號，並將版本由 0.0.4 提升至 0.0.5 | | .claude-plugin/plugin.json | 同上，修正描述標點並同步版本號至 0.0.5 | | .codex-plugin/plugin.json | 同上，修正描述標點並同步版本號至 0.0.5 | ## 設計重點 - skill-check、skill-delete、skill-new、skill-update、skillset-update 五支技能先前各自以近乎相同的內嵌文字描述「同步 README、bump 版本」這段機械流程，重複維護成本高，容易在多支技能之間產生內容漂移。抽出成 sync-skill-manifest.sh 與 find-skill-refs.sh 兩支冪等工具後，只需維護一份邏輯，符合 DRY 原則。 - 抽出工具後，五支技能的步驟一致改為「子代理人只負責內容判斷與修改決策，機械式的同步與版本 bump 一律直接呼叫工具」，讓子代理人標記在同一技能組內保持一致。skill-delete 的引用盤點步驟先前既沒有工具也沒有標明子代理人，稽核時難以驗證涵蓋範圍，此次一併對齊其他手足技能的作法。 ## 測試結果 - tools/sync-skill-manifest.sh 與 tools/find-skill-refs.sh 皆通過 sh -n 語法檢查。兩支工具先前已針對暫存測試素材驗證過，並通過 ste100-lint 檢查，此結果為既有驗證紀錄，本次未重新執行測試。 ## 前置 Push Request - 無

jiantw83 added 3 commits 2026-08-24 06:51:36 +00:00

fix(marketplace): 同步 marketplace.json 至權威格式並修正標點 720ec6194e

什麼：為 .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 中繼資料同步項目。

feat(meta): 抽出技能目錄同步與引用查找為共用工具 4454d62e82

什麼：新增 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 五支技能共用的機械流程去重。

fix(meta): 修正外掛描述標點並同步版本號至 0.0.5 ef974b4ef5

什麼：將 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 的提交。

admin approved these changes 2026-08-24 08:00:40 +00:00

admin merged commit ce3dab42db into develop

2026-08-24 08:00:45 +00:00

admin deleted branch fix/sync-marketplace-and-extract-skill-tools

2026-08-24 08:00:45 +00:00

jiantw83 referenced this pull request

2026-08-24 08:23:34 +00:00

發佈 jsc-meta 0.0.5：抽出技能目錄同步與引用查找共用工具 #9

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/meta#8