refactor(skills 共用規範): 抽出共用規範至 generic spec-* 並升版 0.2.2 #36

Merged
admin merged 2 commits from develop into master 2026-07-17 03:27:18 +00:00
Member

變更摘要

把 4 個 doc skills 的重複區塊抽出至 generic plugin 的 spec-* 共用規範 skills(7 檔,+55/-50),各 skill 開頭新增「共用規範」區塊:引用 /jsc:spec-*+一行 fallback 摘要,並明訂 generic plugin 未安裝時先詢問是否安裝、不安裝就直接中斷

  • doc-funcs:輸出訊息格式/區塊階段命名/一行一則 → /jsc:spec-time-log;語言規範 → /jsc:spec-output
  • doc-issues-analyze:工具可用性檢查流程 → /jsc:spec-gitea;看板「待處理」規則 → /jsc:spec-project-board;Mermaid 呈現 → /jsc:spec-output
  • doc-issues-analyze-to-file:jq/PII/語言規範 → /jsc:spec-gitea/jsc:spec-output
  • doc-issues-sync:工具與 jq → /jsc:spec-gitea;欄位語意對應五條規則與探測/寫入限制 → /jsc:spec-project-board
  • doc-docker 無共用內容,未變動。

影響範圍

  • 4 個 SKILL.md+3 個 manifest 升版 0.2.2
  • 各 skill 特有規則(不落地檔案準則、專案完成模式、附件讀取等)全數保留。

風險與注意事項

  • 新增執行期相依:需要 generic plugin(https://gitea.jsc.idv.tw/plugins/generic.git)的 spec-* skills;未安裝時 skill 會詢問安裝、拒絕則中斷。請先合併並發佈 generic 的對應 PR 再發佈本版
## 變更摘要 把 4 個 doc skills 的重複區塊抽出至 generic plugin 的 `spec-*` 共用規範 skills(7 檔,+55/-50),各 skill 開頭新增「共用規範」區塊:引用 `/jsc:spec-*`+一行 fallback 摘要,並明訂 **generic plugin 未安裝時先詢問是否安裝、不安裝就直接中斷**。 - `doc-funcs`:輸出訊息格式/區塊階段命名/一行一則 → `/jsc:spec-time-log`;語言規範 → `/jsc:spec-output`。 - `doc-issues-analyze`:工具可用性檢查流程 → `/jsc:spec-gitea`;看板「待處理」規則 → `/jsc:spec-project-board`;Mermaid 呈現 → `/jsc:spec-output`。 - `doc-issues-analyze-to-file`:jq/PII/語言規範 → `/jsc:spec-gitea`+`/jsc:spec-output`。 - `doc-issues-sync`:工具與 jq → `/jsc:spec-gitea`;欄位語意對應五條規則與探測/寫入限制 → `/jsc:spec-project-board`。 - `doc-docker` 無共用內容,未變動。 ## 影響範圍 - 4 個 SKILL.md+3 個 manifest 升版 **0.2.2**。 - 各 skill 特有規則(不落地檔案準則、專案完成模式、附件讀取等)全數保留。 ## 風險與注意事項 - **新增執行期相依**:需要 generic plugin(`https://gitea.jsc.idv.tw/plugins/generic.git`)的 `spec-*` skills;未安裝時 skill 會詢問安裝、拒絕則中斷。**請先合併並發佈 generic 的對應 PR 再發佈本版**。
jiantw83 added 2 commits 2026-07-17 00:59:51 +00:00
admin approved these changes 2026-07-17 03:27:16 +00:00
admin merged commit 0ad1a173fe into master 2026-07-17 03:27:18 +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/doc#36