fix/sync-marketplace-metadata-and-pr-skill-audit-fixes #3

Merged
admin merged 2 commits from fix/sync-marketplace-metadata-and-pr-skill-audit-fixes into develop 2026-08-24 07:59:34 +00:00
Member

摘要

  • 需求描述:本次為 jsc-meta:skill-check 對 jsc-git 倉庫自身的合規稽核修正,同時包含 marketplace.json 與正本同步;此為維護性工作,無正式計畫頁。
  • 計畫名稱:無
  • 計畫頁:無
  • 分析頁:無

變更內容

檔案 為什麼改
.agents/plugins/marketplace.json 補齊缺漏的頂層 owner 欄位與各 plugin 的 description,與 plugins/jsc 正本同步
.claude-plugin/marketplace.json 修正 jsc-meta 說明文字的標點(斜線改頓號),與正本用字一致
tools/slugify.sh(新增) 新增分支命名 slugify 工具,把原本寫在技能文件裡的規則工具化,避免各 agent 理解不一致
skills/pr/SKILL.md 步驟 3.2 改為呼叫 tools/slugify.sh;Rules 同時把「分支標題摘要」與「描述撰寫」標記為必須交由 sub agent 執行;範例字串改為全英文
plugin.json 版本號 0.0.1 → 0.0.2,反映本次功能與稽核修正
.claude-plugin/plugin.json 版本號 0.0.1 → 0.0.2,同步各 manifest
.codex-plugin/plugin.json 版本號 0.0.1 → 0.0.2,同步各 manifest

設計重點

  • 決定性、機械式的流程(如分支名稱 slugify)應工具化為腳本,而非寫成文字規則,避免不同 agent 或模型各自理解出現落差。
  • 需要判斷力的步驟(分支標題摘要、PR 描述撰寫)在技能 Rules 段落中一致標記為「必須交由 sub agent 執行」;修正前僅描述撰寫一項有此標記,屬不一致,本次一併修正。

測試結果

  • tools/slugify.sh 已用多組輸入測試:一般英文短語、含中文與標點符號的短語、含重複/前後空白的短語、空字串輸入,皆正確輸出 ASCII 化的分支名稱片段。
  • ste100-lint 已於先前流程中對本倉庫執行過並確認乾淨(無需重跑)。

前置 Push Request

  • 無
## 摘要 - 需求描述:本次為 jsc-meta:skill-check 對 jsc-git 倉庫自身的合規稽核修正,同時包含 marketplace.json 與正本同步;此為維護性工作,無正式計畫頁。 - 計畫名稱:無 - 計畫頁:無 - 分析頁:無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | .agents/plugins/marketplace.json | 補齊缺漏的頂層 owner 欄位與各 plugin 的 description,與 plugins/jsc 正本同步 | | .claude-plugin/marketplace.json | 修正 jsc-meta 說明文字的標點(斜線改頓號),與正本用字一致 | | tools/slugify.sh(新增) | 新增分支命名 slugify 工具,把原本寫在技能文件裡的規則工具化,避免各 agent 理解不一致 | | skills/pr/SKILL.md | 步驟 3.2 改為呼叫 tools/slugify.sh;Rules 同時把「分支標題摘要」與「描述撰寫」標記為必須交由 sub agent 執行;範例字串改為全英文 | | plugin.json | 版本號 0.0.1 → 0.0.2,反映本次功能與稽核修正 | | .claude-plugin/plugin.json | 版本號 0.0.1 → 0.0.2,同步各 manifest | | .codex-plugin/plugin.json | 版本號 0.0.1 → 0.0.2,同步各 manifest | ## 設計重點 - 決定性、機械式的流程(如分支名稱 slugify)應工具化為腳本,而非寫成文字規則,避免不同 agent 或模型各自理解出現落差。 - 需要判斷力的步驟(分支標題摘要、PR 描述撰寫)在技能 Rules 段落中一致標記為「必須交由 sub agent 執行」;修正前僅描述撰寫一項有此標記,屬不一致,本次一併修正。 ## 測試結果 - tools/slugify.sh 已用多組輸入測試:一般英文短語、含中文與標點符號的短語、含重複/前後空白的短語、空字串輸入,皆正確輸出 ASCII 化的分支名稱片段。 - ste100-lint 已於先前流程中對本倉庫執行過並確認乾淨(無需重跑)。 ## 前置 Push Request - 無
jiantw83 added 2 commits 2026-08-24 06:48:57 +00:00
What: 在 .agents/plugins/marketplace.json 加入頂層 owner 欄位(name: JSC)與整體說明,並為 jsc-ask、jsc-cli、jsc-git、jsc-gitea、jsc-hooks、jsc-log、jsc-meta、jsc-pkg、jsc-review、jsc-sdlc 十個 plugin 逐一補上 description;同時把 .claude-plugin/marketplace.json 裡 jsc-meta 的說明標點從斜線改成頓號,與正本用字一致。
Why: 兩份 marketplace.json 是 plugins/jsc 正本的副本,先前副本落後於正本,缺少 description 與 owner 欄位會讓各 CLI 的 marketplace 清單顯示不完整,也造成多份副本之間內容不一致。
How: 逐一比對 plugins/jsc 正本內容,把缺漏欄位補齊到 .agents/plugins/marketplace.json,並修正 .claude-plugin/marketplace.json 的用字差異,使兩份副本與正本同步。
Who: 影響 jsc-git 倉庫內所有 marketplace.json 副本,屬全倉庫層級的基礎設施修正,非單一技能功能。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
What: 新增 tools/slugify.sh 腳本,將分支類型與短語轉成 ASCII slug;修改 skills/pr/SKILL.md,把原本內嵌在文字說明中的 slugify 規則改為呼叫 tools/slugify.sh,並把 Rules 段落中「分支標題摘要」與「描述撰寫」都標記為必須交由 sub agent 執行(原本只有描述撰寫一項),同時把一個非英文範例字串替換成全英文範例;plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest 版本號由 0.0.1 升到 0.0.2。
Why: 因應 jsc-meta:skill-check 稽核結果,pr 技能有兩項不合規:決定性的分支名稱 slugify 流程應該工具化而非寫成文字規則,避免各 agent 各自理解出現落差;另外,需要判斷力的步驟(分支標題摘要、描述撰寫)標記不一致,只標了描述撰寫一項會讓分支標題摘要漏掉必要的 sub agent 隔離;範例字串混雜非英文也不符合技能文件全英文的要求。
How: 新增可執行的 tools/slugify.sh(小寫化、非 a-z0-9 字元轉連字號、合併連續連字號、去除頭尾連字號),並在 SKILL.md 步驟 3.2 改為呼叫此腳本;同步更新 Rules 第 3 項,把「分支標題摘要」與「描述撰寫」都列為必須交由 sub agent 執行;把範例改成全英文;三份 plugin manifest 版本號同步升版以反映此次修改。
Who: 影響 jsc-git 的 pr 技能與其新增的 slugify.sh 工具,屬 pr 流程分支命名與稽核合規的功能性變更。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
admin approved these changes 2026-08-24 07:59:30 +00:00
admin merged commit 9ce424e28f into develop 2026-08-24 07:59:34 +00:00
admin deleted branch fix/sync-marketplace-metadata-and-pr-skill-audit-fixes 2026-08-24 07:59:34 +00:00
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/git#3