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

release: v0.2.0 develop 到 master #34

Merged
admin merged 5 commits from develop into master 2026-08-27 09:01:27 +00:00
Conversation 1 Commits 5 Files Changed 5
+14 -7
jiantw83 commented 2026-08-27 09:00:08 +00:00
Member
Copy Link
Copy Source

摘要

  • 需求描述：把 jsc-sdlc 0.2.0 從 develop 放行到 master，共 5 個 commit。內容是使用者 15 條工作規則的第二群「產出物文件品質」在本存取庫的落地：implement 第 10 步從單一的程式碼審查改成兩關並列的收尾稽核，10.1 程式碼審查、10.2 API 文件稽核。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

檔案 為什麼改
skills/implement/SKILL.md 第 10 步改成兩關並列。10.1 呼叫 jsc-review:code-review，10.2 呼叫 jsc-review:api-doc，並依 swagger-detect.sh 的結束碼分流：不支援 Swagger 就明確跳過並算通過，不是靜靜略過。
README.md 同步兩關收尾稽核的說明與跟 jsc-review 的分工。
plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest 同步升版到 0.2.0。

設計重點

  • 這一段才是讓已安裝的 CLI 抓到新內容的那一段。develop 併了不等於生效：marketplace 與 jsc-hooks/hooks/version-guard.sh 讀的都是存取庫的預設分支 master。version-guard.sh 取 raw plugin.json 時刻意不指定 ref，Gitea 就回預設分支那一份，所以只有這個 PR 合進 master，五支 CLI 才看得到 0.2.0。
  • 「跳過算通過」寫成明確的一條路，不是省略。不支援 Swagger 的專案要看到「已判定不支援、本關跳過」的結論，不能讓人分不清是通過還是根本沒跑。
  • 兩關並列而不是串接。程式碼審查沒過不會擋住文件稽核跑，兩邊的結果一起交給呼叫者判斷，減少來回。
  • 分流條件交給程式決定。用 swagger-detect.sh 的結束碼，不靠技能自己讀專案猜有沒有 Swagger。
  • 這版是 0.2.0 而不是 0.1.10：收尾多一道必過關卡改變了工作包的完成定義，屬於行為變更，往上跳一個次版號。

升級後使用者會立刻感受到的差異

  • implement 多一關。支援 Swagger 的專案，控制器文件沒補全就不算工作包完成，工作包會停在收尾稽核而不是直接開 PR。
  • 不支援 Swagger 的專案感受不到差異，只會在收尾看到一行跳過的結論。

測試結果

  • ste100-lint.sh 掃本存取庫全綠。
  • 三份 manifest 版本一致為 0.2.0。
  • 沒跑的部分據實說明：真實 Gitea 端對端的 API 文件稽核沒跑，要跑需要一個實際啟用 Swagger 的專案，目前手上沒有。本存取庫這一段只改技能文件，沒有新增腳本，swagger-detect.sh 的結束碼判定測試在 jsc-review 0.0.6 的放行 PR 裡。
  • 本次放行本身沒有重跑腳本測試。上列測試是在子功能 PR（#32）與主幹 PR（#33）階段跑的，這個 PR 只是把已驗證的 develop 內容推到預設分支。

前置 Push Request

  • 無
## 摘要 - 需求描述：把 jsc-sdlc 0.2.0 從 `develop` 放行到 `master`，共 5 個 commit。內容是使用者 15 條工作規則的第二群「產出物文件品質」在本存取庫的落地：`implement` 第 10 步從單一的程式碼審查改成兩關並列的收尾稽核，10.1 程式碼審查、10.2 API 文件稽核。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `skills/implement/SKILL.md` | 第 10 步改成兩關並列。10.1 呼叫 `jsc-review:code-review`，10.2 呼叫 `jsc-review:api-doc`，並依 `swagger-detect.sh` 的結束碼分流：不支援 Swagger 就明確跳過並算通過，不是靜靜略過。 | | `README.md` | 同步兩關收尾稽核的說明與跟 jsc-review 的分工。 | | `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` | 三份 manifest 同步升版到 0.2.0。 | ## 設計重點 - 這一段才是讓已安裝的 CLI 抓到新內容的那一段。`develop` 併了不等於生效：marketplace 與 `jsc-hooks/hooks/version-guard.sh` 讀的都是存取庫的**預設分支** `master`。`version-guard.sh` 取 raw `plugin.json` 時刻意不指定 ref，Gitea 就回預設分支那一份，所以只有這個 PR 合進 `master`，五支 CLI 才看得到 0.2.0。 - 「跳過算通過」寫成明確的一條路，不是省略。不支援 Swagger 的專案要看到「已判定不支援、本關跳過」的結論，不能讓人分不清是通過還是根本沒跑。 - 兩關並列而不是串接。程式碼審查沒過不會擋住文件稽核跑，兩邊的結果一起交給呼叫者判斷，減少來回。 - 分流條件交給程式決定。用 `swagger-detect.sh` 的結束碼，不靠技能自己讀專案猜有沒有 Swagger。 - 這版是 0.2.0 而不是 0.1.10：收尾多一道必過關卡改變了工作包的完成定義，屬於行為變更，往上跳一個次版號。 ## 升級後使用者會立刻感受到的差異 - `implement` 多一關。支援 Swagger 的專案，控制器文件沒補全就不算工作包完成，工作包會停在收尾稽核而不是直接開 PR。 - 不支援 Swagger 的專案感受不到差異，只會在收尾看到一行跳過的結論。 ## 測試結果 - `ste100-lint.sh` 掃本存取庫全綠。 - 三份 manifest 版本一致為 0.2.0。 - 沒跑的部分據實說明：**真實 Gitea 端對端的 API 文件稽核沒跑**，要跑需要一個實際啟用 Swagger 的專案，目前手上沒有。本存取庫這一段只改技能文件，沒有新增腳本，`swagger-detect.sh` 的結束碼判定測試在 jsc-review 0.0.6 的放行 PR 裡。 - 本次放行本身沒有重跑腳本測試。上列測試是在子功能 PR（#32）與主幹 PR（#33）階段跑的，這個 PR 只是把已驗證的 `develop` 內容推到預設分支。 ## 前置 Push Request - 無
jiantw83 added 5 commits 2026-08-27 09:00:09 +00:00
feat(implement): 收尾改成程式碼審查與 API 文件稽核兩關並列 9b48d16422 
What：skills/implement/SKILL.md 第 10 步改寫。原本只呼叫 code-review，現在拆成
並列的兩關：10.1 程式碼審查維持原判準，10.2 新增 API 文件稽核——先跑
jsc-review/tools/swagger-detect.sh，退出碼 0 就呼叫 jsc-review:api-doc，1 就
明確跳過並回報，2 就修好參數或路徑重跑。技能的 description 同步改寫。

Why：支援 Swagger 的專案，控制器文件沒補全就等於工作包沒做完。兩關並列而不是
一關套一關，是因為程式碼審查過了不代表 API 文件補齊了，反過來也一樣，任何一關
沒過工作包都不算完成。跳過一定要講出來：沒回報的跳過跟忘記做分不出來。退出碼
2 是偵測不出結果，既不算通過也不算跳過，硬當跳過會讓真的支援 Swagger 的專案
漏掉稽核。

How：改寫刻意只動第 10 步內部，用 10.1、10.2 子項編號，1 到 14 的頂層編號一個
都不動——references/deliver-formats.md 指的「步驟 7」、references/branch.md 指的
「步驟 4 與步驟 11」都還指得到原來的位置。稽核項目不抄一份過來，只寫「看
jsc-review:api-doc」，判準改動時不必兩邊同步。兩關的失敗都是修，不是放行：每一
輪修正都以 sub agent 在同一個 worktree 內進行，修完再稽核一次。

Who：jsc-sdlc 的 implement 技能，工作包的收尾稽核。
docs(sdlc): README 同步兩關收尾稽核與 jsc-review 的分工 981cda6adf 
What：README.md 的 implement 摘要，把原本一句「程式碼審查」換成兩關並列的收尾
稽核，寫明偵測、呼叫、跳過三條路徑與各自的退出碼；相關 domain 一節的 jsc-review
說明同步改成兩關，並註明專案支不支援 Swagger 由 swagger-detect.sh 判定、稽核
項目只寫在該技能。

Why：README 是使用者查一支技能做什麼的入口。技能正文改了流程，README 還停在
只有程式碼審查那版，讀的人會以為 API 文件稽核不存在，或以為那是另一支技能自己
的事。

How：只改 implement 摘要那一段的收尾環節，以及相關 domain 的那一行，其餘流程
敘述維持原樣。稽核項目在這裡一樣不重複列，指向 jsc-review:api-doc，避免同一份
判準散在三個檔案裡。

Who：jsc-sdlc 的存取庫說明文件。
chore(manifest): 三份 manifest 同步升版至 0.2.0 39c087b31f 
What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份
manifest 的 version 由 0.1.9 改為 0.2.0。

Why：implement 的收尾多了一關 API 文件稽核，是使用者看得到的流程異動，次版號
要跟著進。版本沒跟著升，各 CLI 端的外掛版本護欄就分不出新舊，已安裝的使用者
也收不到更新。

How：三份 manifest 只改 version 欄位，其餘欄位維持原樣，三處版本號保持一致。

Who：jsc-sdlc 外掛的安裝與更新流程。
Merge pull request 'feat(sdlc): implement 收尾新增 API 文件稽核，與程式碼審查並列' (#32) from feat/api-doc-audit/implement-api-doc-gate into feat/api-doc-audit/main ac3c4e3aa2 
Reviewed-on: #32
Merge pull request 'feat(sdlc): implement 收尾改成程式碼審查與 API 文件稽核兩關並列' (#33) from feat/api-doc-audit/main into develop 7d8a8d527d 
Reviewed-on: #33
admin approved these changes 2026-08-27 09:01:24 +00:00
admin merged commit 92a0701f06 into master 2026-08-27 09:01:27 +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/sdlc#34