plugins/ask
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix/marketplace-sync-and-ask-skill-check-compliance #6

Merged
admin merged 2 commits from fix/marketplace-sync-and-ask-skill-check-compliance into develop 2026-08-24 07:57:57 +00:00
Conversation 1 Commits 2 Files Changed 9
+33 -19
jiantw83 commented 2026-08-24 06:47:19 +00:00
Member
Copy Link
Copy Source

PR 描述範本

摘要

  • 需求描述：同步 plugins/ask 的 marketplace.json 至 jsc canonical 版本，並修正 jsc-meta:skill-check 稽核發現的 ask 技能不合規項（description 過長、wiki hash 演算法重複描述），版本號 0.0.2 → 0.0.3。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

檔案 為什麼改
.agents/plugins/marketplace.json 落後於 jsc canonical marketplace，補齊各外掛缺少的 description 與 owner 欄位
.claude-plugin/marketplace.json 同上，並統一既有描述措辭（meta 外掛描述頓號用法）
skills/ask/SKILL.md frontmatter description 超過 5 句且缺少明確排除觸發語句；改寫並精簡至 5 句內、補上排除語句
templates/question-contents.md 重述 wiki hash 演算法細節，違反不重複邏輯原則；改為指向 canonical 的 jsc-gitea/tools/hash-id
templates/question-record.md 同上，重述的 hash 演算法段落改為指向 jsc-gitea/tools/hash-id
README.md Skills 目錄中 ask 技能描述同步 SKILL.md 的修改內容
plugin.json 版本號 0.0.2 → 0.0.3
.claude-plugin/plugin.json 版本號 0.0.2 → 0.0.3
.codex-plugin/plugin.json 版本號 0.0.2 → 0.0.3

設計重點

  • 委派 canonical 工具而非重複邏輯：wiki hash 演算法只在 jsc-gitea/tools/hash-id 保留一份實作與說明，SKILL.md 與各範本一律改為呼叫該工具，避免多處重述造成日後不一致。
  • description 依準則上限修剪：SKILL.md frontmatter description 壓縮至 5 句內，並補上明確的負向觸發語句（何時不使用本技能），符合 jsc-meta:skill-check 的稽核項目。

測試結果

  • ste100-lint：已對本次變更檔案執行，結果乾淨（clean），無違規。
  • UTF-8 編碼：已於稽核／修正／驗證流程中確認所有變更檔案皆為合法 UTF-8。
  • 上述測試結果來自本次工作前已完成的稽核（audit）、修正（fix）、驗證（verify）三個階段，未於本次 PR 建立過程重跑。

前置 Push Request

  • 無
# PR 描述範本 <!-- 用法：複製本範本，替換 {占位符}；各節不可留空，無內容填「無」。 --> ## 摘要 - 需求描述：同步 `plugins/ask` 的 marketplace.json 至 jsc canonical 版本，並修正 jsc-meta:skill-check 稽核發現的 ask 技能不合規項（description 過長、wiki hash 演算法重複描述），版本號 0.0.2 → 0.0.3。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `.agents/plugins/marketplace.json` | 落後於 jsc canonical marketplace，補齊各外掛缺少的 description 與 owner 欄位 | | `.claude-plugin/marketplace.json` | 同上，並統一既有描述措辭（meta 外掛描述頓號用法） | | `skills/ask/SKILL.md` | frontmatter description 超過 5 句且缺少明確排除觸發語句；改寫並精簡至 5 句內、補上排除語句 | | `templates/question-contents.md` | 重述 wiki hash 演算法細節，違反不重複邏輯原則；改為指向 canonical 的 `jsc-gitea/tools/hash-id` | | `templates/question-record.md` | 同上，重述的 hash 演算法段落改為指向 `jsc-gitea/tools/hash-id` | | `README.md` | Skills 目錄中 ask 技能描述同步 SKILL.md 的修改內容 | | `plugin.json` | 版本號 0.0.2 → 0.0.3 | | `.claude-plugin/plugin.json` | 版本號 0.0.2 → 0.0.3 | | `.codex-plugin/plugin.json` | 版本號 0.0.2 → 0.0.3 | ## 設計重點 - 委派 canonical 工具而非重複邏輯：wiki hash 演算法只在 `jsc-gitea/tools/hash-id` 保留一份實作與說明，SKILL.md 與各範本一律改為呼叫該工具，避免多處重述造成日後不一致。 - description 依準則上限修剪：SKILL.md frontmatter description 壓縮至 5 句內，並補上明確的負向觸發語句（何時不使用本技能），符合 jsc-meta:skill-check 的稽核項目。 ## 測試結果 - ste100-lint：已對本次變更檔案執行，結果乾淨（clean），無違規。 - UTF-8 編碼：已於稽核／修正／驗證流程中確認所有變更檔案皆為合法 UTF-8。 - 上述測試結果來自本次工作前已完成的稽核（audit）、修正（fix）、驗證（verify）三個階段，未於本次 PR 建立過程重跑。 ## 前置 Push Request - 無
jiantw83 added 2 commits 2026-08-24 06:47:19 +00:00
fix(marketplace): 同步 marketplace.json 至 jsc canonical 版本 ea1a2c805b 
What：同步 `.agents/plugins/marketplace.json` 與 `.claude-plugin/marketplace.json`
至 jsc canonical marketplace，補齊各外掛缺少的 description 與 owner 欄位，並統一
既有描述措辭。

Why：兩份 marketplace.json 落後於 canonical 版本，缺少說明文字與擁有者資訊，
不利於使用者辨識外掛用途，也會在 jsc-meta:skill-check 稽核時被判定不一致。

How：以 plugins/jsc 的 canonical marketplace.json 為準，補上 owner 欄位與各
外掛的 description 欄位，並將既有措辭（如 meta 外掛描述的頓號用法）對齊統一。

Who：repo 層級基礎設施修正，與 ask 技能本身邏輯無關。
fix(ask): 修正 skill-check 不合規項並升版至 0.0.3 f40b374342 
What：修剪 SKILL.md 的 frontmatter description 至 5 句內並補上明確的排除
觸發語句；將 SKILL.md 與兩份範本中重述的 wiki hash 演算法說明，改為指向
canonical 的 `jsc-gitea/tools/hash-id` 工具；同步更新 README.md 的 Skills
目錄描述；三份 manifest 版本號自 0.0.2 升至 0.0.3。

Why：jsc-meta:skill-check 稽核發現 SKILL.md 的 description 超過 5 句且缺少
明確排除觸發語句，且 SKILL.md 與 question-contents.md、question-record.md
重複描述同一套 wiki hash 演算法，違反「委派 canonical 工具、不重複邏輯」
的準則。

How：改寫 skills/ask/SKILL.md 的 description 為精簡版並加入排除語句；三處
重述 hash 演算法的段落，統一改寫為呼叫 `jsc-gitea/tools/hash-id`（演算法
細節見 guidelines.md）；README.md 的 ask 技能描述同步調整；plugin.json、
.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本號 0.0.2 → 0.0.3。

Who：ask 技能本身（skills/ask/SKILL.md 與其範本、manifest）。
admin approved these changes 2026-08-24 07:57:49 +00:00
admin merged commit 40da180151 into develop 2026-08-24 07:57:57 +00:00
admin deleted branch fix/marketplace-sync-and-ask-skill-check-compliance 2026-08-24 07:57:57 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/ask#6