release: v0.1.8 develop 到 master #28

2026-08-27T02:04:16Z

jiantw83 commented

2026-08-27 02:04:16 +00:00

摘要

需求描述：把 develop 的註解界線規則與簡體字修正發佈到 master。實作與維護兩個階段是唯一會動程式碼的地方，規則落在寫程式碼與交件的環節。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`skills/implement/SKILL.md`	步驟 9.3 新增註解界線規則與完成條件；步驟 10 交給 code-review 前先掃整包 diff
`skills/maintain/SKILL.md`	步驟 3.3 新增同一規則，聚焦議題編號、commit hash、分支名、人名與 `@` 提及
`references/tdd.md`	循環規則新增第 4 項：一個待辦要算完成，該次 diff 的註解不得夾帶追蹤編號
`references/cpm-chart.md`	第 14 行的簡體字改成正體「出現」
`README.md`	同步 implement 與 maintain 說明
三份 manifest	同步升版到 0.1.8

設計重點

點名這兩個階段手上一定有的編號：工作包編號、分析頁編號、TDD 待辦編號、來源分支名、PR 編號。這些正是最容易順手寫進註解的東西。
完成條件寫成可檢核的形式：該工作包的 diff 裡沒有任何一行註解帶著上述編號，才算完成。
規則正文不抄過來，只放一行指引指向 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/implement/SKILL.md` | 步驟 9.3 新增註解界線規則與完成條件；步驟 10 交給 code-review 前先掃整包 diff | | `skills/maintain/SKILL.md` | 步驟 3.3 新增同一規則，聚焦議題編號、commit hash、分支名、人名與 `@` 提及 | | `references/tdd.md` | 循環規則新增第 4 項：一個待辦要算完成，該次 diff 的註解不得夾帶追蹤編號 | | `references/cpm-chart.md` | 第 14 行的簡體字改成正體「出現」 | | `README.md` | 同步 implement 與 maintain 說明 | | 三份 manifest | 同步升版到 0.1.8 | ## 設計重點 - **點名這兩個階段手上一定有的編號**：工作包編號、分析頁編號、TDD 待辦編號、來源分支名、PR 編號。這些正是最容易順手寫進註解的東西。 - **完成條件寫成可檢核的形式**：該工作包的 diff 裡沒有任何一行註解帶著上述編號，才算完成。 - 規則正文不抄過來，只放一行指引指向 `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 8 commits 2026-08-27 02:04:16 +00:00

feat(implement): implement 步驟加上註解界線規則 cd95c22bd4

What：步驟 9 新增 9.3「註解只寫原因」，原 9.3 順延為 9.4；步驟 10 交給 code-review 前先掃整包 diff。
Why：實作階段手上一直握著工作包編號、分析頁編號、待辦編號、分支名與 PR 編號，這些追蹤資訊很容易被寫進程式碼註解，讓註解變成文件索引。
How：規則正文放在 jsc-review 的 references/comment-scope.md，本技能只寫指引與完成條件，不重複清單；並指向 jsc-hooks 的 comment-scope.sh 當寫檔後的即時警告。
Who：jsc-sdlc 的 implement 技能。

feat(maintain): maintain 步驟加上註解界線規則 e6e3e176ef

What：步驟 3 新增 3.3「註解只寫原因」，原 3.3、3.4 順延為 3.4、3.5。
Why：維護階段常改到既有註解，議題編號、commit hash、分支名、人名與 @ 提及很容易順手留在註解裡，讓註解變成追蹤記錄。
How：規則正文放在 jsc-review 的 references/comment-scope.md，本技能只寫指引與完成條件，不重複清單；並指向 jsc-hooks 的 comment-scope.sh 當寫檔後的即時警告。
Who：jsc-sdlc 的 maintain 技能。

feat(tdd): TDD 循環規則新增註解只寫原因 31ba3f490a

What：references/tdd.md 的循環規則新增第 4 項「註解只寫原因」，並寫成單一待辦的完成條件。
Why：註解界線要在紅綠循環當下就守住，不能等到審查階段才回頭清，否則追蹤編號早已散進整包 diff。
How：規則只寫一句界線加完成條件，完整清單與白名單指向 jsc-review 的 references/comment-scope.md。
Who：jsc-sdlc 的 TDD 參考文件，implement 與 maintain 兩支技能共用。

feat(readme): README 同步 implement 與 maintain 的註解界線 f503091655

What：README 的 implement 與 maintain 兩段說明各補一句註解界線，點出各自禁止寫進註解的追蹤資訊。
Why：README 是技能的對外說明，兩支技能已加規則，說明沒跟上就會讓使用者誤以為註解沒有限制。
How：兩段各補一句，內容與 SKILL.md 的指引一致，完整清單指向 jsc-review 的 references/comment-scope.md。
Who：jsc-sdlc 的 README 技能說明區塊。

feat(manifest): 三份 manifest 版本升到 0.1.7 868e4345e9

What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 的 version 由 0.1.6 改為 0.1.7。
Why：本次為 implement、maintain 與 TDD 參考文件新增註解界線規則，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。
How：三份 manifest 只改 version 一個欄位，其餘內容不動，三份保持同一版號。
Who：jsc-sdlc 外掛的套件描述檔。

Merge pull request 'feat/comment-scope-rule' (#26 ) from feat/comment-scope-rule into develop b37476277d

Reviewed-on: #26

fix(references): 修正 cpm-chart 的簡體字並同步 manifest 版本 78fb70a099

What: 把 references/cpm-chart.md 第 14 行的「出现」改成正體「出現」，
並把三份 manifest 的版本由 0.1.7 bump 到 0.1.8。

Why: 存取庫文件一律用正體中文，簡體字會被 STE100 語言檢查擋下，也讓讀規則
的人分心。技能內容有異動就要 bump 版本，安裝端才拿得到新版。

How: 只換掉那一個字，句子其餘文意不動。接著跑 ste100-lint.sh 掃全庫的 .md、
.json 與程式碼檔，再用簡體字全表、U+FFFD、雙重編碼特徵與非 UTF-8 四項掃過每個
受版控的檔案，兩輪都零命中。最後用 sync-skill-manifest.sh 同步 plugin.json、
.claude-plugin/plugin.json、.codex-plugin/plugin.json。

Who: Jeffery

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Merge pull request 'fix/cpm-chart-simplified-char' (#27 ) from fix/cpm-chart-simplified-char into develop 7fb1b8db11

Reviewed-on: #27

admin approved these changes 2026-08-27 02:08:17 +00:00

admin merged commit 35e26bf9d1 into master

2026-08-27 02:08:20 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/sdlc#28