release: v0.0.6 develop 到 master #9

Merged
admin merged 7 commits from develop into master 2026-08-27 02:08:03 +00:00
Member

摘要

  • 需求描述:把 develop 的稽核修正與註解界線規則發佈到 master。套件更新途中留註解時,只寫鎖版本或繞道的原因,不寫追蹤編號。
  • 計畫名稱:無
  • 計畫頁:無
  • 分析頁:無

變更內容

檔案 為什麼改
skills/pkg-update/SKILL.md 步驟 3.5 新增註解界線規則與可檢核完成條件
README.md 同步 pkg-update 說明
稽核修正與文件同步 前一輪 skill-check 的缺失修正
三份 manifest 與 marketplace 正本 同步升版到 0.0.6

設計重點

  • 第三方套件的 issue 連結屬白名單,可以寫。這支技能最容易踩到這一項——它正是說明繞道成因與解除條件的東西,拿掉反而讓後人看不懂為什麼鎖版本。
  • 不能寫的是內部議題編號、工作包編號、人名與 @ 提及、產生來源署名。
  • 規則正文不抄過來,只放一行指引指向 jsc-review 的 references/comment-scope.md。

測試結果

本次發佈前對 develop 樹重跑一輪,實測數據:

  • sh -n 語法檢查所有 shell 腳本:0 錯
  • 所有 JSON 檔通過解析:0 錯
  • jsc-meta 的 ste100-lint.sh 掃整個存取庫:0 命中
  • jsc-hooks 的 lang-guard.sh 逐檔掃描(簡體字、亂碼、非 UTF-8):0 命中

前置 Push Request

  • 無
## 摘要 - 需求描述:把 develop 的稽核修正與註解界線規則發佈到 master。套件更新途中留註解時,只寫鎖版本或繞道的原因,不寫追蹤編號。 - 計畫名稱:無 - 計畫頁:無 - 分析頁:無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `skills/pkg-update/SKILL.md` | 步驟 3.5 新增註解界線規則與可檢核完成條件 | | `README.md` | 同步 pkg-update 說明 | | 稽核修正與文件同步 | 前一輪 skill-check 的缺失修正 | | 三份 manifest 與 marketplace 正本 | 同步升版到 0.0.6 | ## 設計重點 - **第三方套件的 issue 連結屬白名單,可以寫**。這支技能最容易踩到這一項——它正是說明繞道成因與解除條件的東西,拿掉反而讓後人看不懂為什麼鎖版本。 - 不能寫的是內部議題編號、工作包編號、人名與 `@` 提及、產生來源署名。 - 規則正文不抄過來,只放一行指引指向 `jsc-review` 的 `references/comment-scope.md`。 ## 測試結果 本次發佈前對 develop 樹重跑一輪,實測數據: - `sh -n` 語法檢查所有 shell 腳本:0 錯 - 所有 JSON 檔通過解析:0 錯 - `jsc-meta` 的 `ste100-lint.sh` 掃整個存取庫:0 命中 - `jsc-hooks` 的 `lang-guard.sh` 逐檔掃描(簡體字、亂碼、非 UTF-8):0 命中 ## 前置 Push Request - 無
jiantw83 added 7 commits 2026-08-27 02:04:15 +00:00
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>
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>
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>
Reviewed-on: #7
What:在 pkg-update 技能的步驟 3.5 新增註解界線規則,並在 README.md 的 pkg-update 段落同步同一份指引。

Why:套件更新途中常會為了鎖版本或繞道不相容而留註解,過去沒有界線,容易把文件相關資訊寫進程式碼註解,造成註解與文件重複、且內容很快過期。

How:規則正文留在 jsc-review 的 references/comment-scope.md,這裡只放指引與連結、不重複清單。註解只寫鎖版本或繞道的原因;第三方套件的 issue 連結屬白名單,用來說明繞道成因與解除條件;內部議題編號、工作包編號、人名與 @ 提及、產生來源署名一律不得寫。步驟 3.5 另附可檢核的完成條件,並指向 jsc-hooks 的 comment-scope.sh 即時告警與修正回檢流程。

Who:jsc-pkg 的 pkg-update 技能,以及 README.md 的技能說明區塊。
What:把 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 的 version 由 0.0.5 升為 0.0.6。

Why:pkg-update 技能新增註解界線規則,屬於行為變更,必須發版才會被各 CLI 的外掛版本守衛辨識並更新。

How:三份 manifest 同步改動同一個 version 欄位,其餘欄位不動,維持三份內容一致。

Who:jsc-pkg 外掛的三份 manifest。
Reviewed-on: #8
admin approved these changes 2026-08-27 02:08:00 +00:00
admin merged commit 9c33aae25f into master 2026-08-27 02:08:03 +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/pkg#9