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

發佈 jsc-hooks 0.0.5：SDLC 階段閘門程式化與包裝啟動器 #8

Merged
admin merged 13 commits from develop into master 2026-08-24 08:17:17 +00:00
Conversation 1 Commits 13 Files Changed 15
+514 -37
jiantw83 commented 2026-08-24 08:10:32 +00:00
Member
Copy Link
Copy Source

本 PR 內容

把 develop 累積的變更發佈到 master，發佈版本 0.0.5。

目前領先 master 的 commit

  • b8d0be9 Merge pull request 'fix/sync-marketplace-and-hooks-install-script' (#6) from fix/sync-marketplace-and-hooks-install-script into develop
  • 69eee91 feat(hooks-install): 將 hooks-install 的 CLI 佈線邏輯抽離為腳本
  • c4909e1 fix(marketplace): 修正 marketplace.json 與正典註冊表不同步的欄位缺漏
  • 125005d Merge pull request 'feat/sdlc-model-lock-and-wrapper' (#5) from feat/sdlc-model-lock-and-wrapper into develop
  • aae0516 chore(manifest): 三份 manifest 升版至 0.0.3
  • bdfb461 docs(hooks-install): 更新四支 hook 的接線說明與文件
  • 8a95bd2 feat(ste100): 加入送出前自我檢查清單
  • bb91cc2 feat(wrapper): 新增無 Hook CLI 的包裝啟動器與日誌回填
  • 05b3779 feat(sdlc-gate): 新增 SDLC 每 session 模型鎖 hook

待納入（依賴 #7）

本 PR 依賴 #7。#7 合併進 develop 後，其內容會自動出現在本 PR：

  • sdlc-gate.sh 閘門改為能力標籤程式判定，模型不符即以 exit 2 擋下提示
  • lib.sh 新增 transcript_model，從 transcript 讀出實際模型 id
  • 三份 manifest 升版至 0.0.5

合併順序

已在 Gitea 設定依賴，前置 PR 未關閉前本 PR 無法合併。跨 repo 發佈順序：jsc-cli → jsc-hooks → jsc-sdlc——後者的技能會呼叫前者的腳本，順序顛倒會讓使用者裝到不完整的組合。

## 本 PR 內容 把 `develop` 累積的變更發佈到 `master`，發佈版本 0.0.5。 ## 目前領先 master 的 commit - b8d0be9 Merge pull request 'fix/sync-marketplace-and-hooks-install-script' (#6) from fix/sync-marketplace-and-hooks-install-script into develop - 69eee91 feat(hooks-install): 將 hooks-install 的 CLI 佈線邏輯抽離為腳本 - c4909e1 fix(marketplace): 修正 marketplace.json 與正典註冊表不同步的欄位缺漏 - 125005d Merge pull request 'feat/sdlc-model-lock-and-wrapper' (#5) from feat/sdlc-model-lock-and-wrapper into develop - aae0516 chore(manifest): 三份 manifest 升版至 0.0.3 - bdfb461 docs(hooks-install): 更新四支 hook 的接線說明與文件 - 8a95bd2 feat(ste100): 加入送出前自我檢查清單 - bb91cc2 feat(wrapper): 新增無 Hook CLI 的包裝啟動器與日誌回填 - 05b3779 feat(sdlc-gate): 新增 SDLC 每 session 模型鎖 hook ## 待納入（依賴 #7） 本 PR 依賴 #7。#7 合併進 `develop` 後，其內容會自動出現在本 PR： - `sdlc-gate.sh` 閘門改為能力標籤程式判定，模型不符即以 exit 2 擋下提示 - `lib.sh` 新增 `transcript_model`，從 transcript 讀出實際模型 id - 三份 manifest 升版至 0.0.5 ## 合併順序 已在 Gitea 設定依賴，前置 PR 未關閉前本 PR 無法合併。跨 repo 發佈順序：`jsc-cli` → `jsc-hooks` → `jsc-sdlc`——後者的技能會呼叫前者的腳本，順序顛倒會讓使用者裝到不完整的組合。
jiantw83 added 9 commits 2026-08-24 08:10:33 +00:00
feat(sdlc-gate): 新增 SDLC 每 session 模型鎖 hook 05b3779118 
What：新增 hooks/sdlc-gate.sh，提供 lock、unlock、check、report 四個子指令；hooks.json 於 UserPromptSubmit 加掛 check。
Why：SDLC 各階段對模型能力有硬性要求，僅靠技能提示無法防止中途切換模型，需要 hook 層強制。
How：以 session 為鍵把「階段 模型」寫入 $JSC_HOME/sessions/{sid}.stage；check 依 stdin JSON、JSC_MODEL、~/.claude/settings.json 順序判定目前模型，別名互含視為相符，不符時注入繁中封鎖提醒；缺資料一律安靜降級、永遠 exit 0。
Who：jsc-sdlc 四個階段技能（plan、analyze、implement、maintain）於閘門通過時上鎖，Claude Code 的 UserPromptSubmit hook 負責攔查。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
feat(wrapper): 新增無 Hook CLI 的包裝啟動器與日誌回填 bb91cc2832 
What：新增 tools/jsc-wrap.sh 包裝啟動器與 tools/scan-logs.sh 離線日誌回填腳本。
Why：copilot、antigravity 沒有 hook 系統，計時與技能用量原本完全缺漏，需要 hook 之外的落地方案。
How：jsc-wrap.sh 匯出 JSC_CLI 與 JSC_SESSION_ID，啟動前後各呼叫一次 session-timer.sh，結束時自動執行 scan-logs.sh 並原樣傳遞子行程退出碼；scan-logs.sh 解析 copilot、antigravity、codex 的原生日誌，把技能用量與階段界線補進 $JSC_HOME，重掃不產生重複記錄。
Who：無 hook 系統的 CLI（copilot、antigravity）與僅有 notify 的 codex，資料供 jsc-log:worklog 與 jsc-log:stats 使用。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
feat(ste100): 加入送出前自我檢查清單 8a95bd2b47 
What：ste100-guard.sh 追加一行輸出，列出五項送出前自我檢查（簡體字、半形句尾標點、套路句、半形斜線並列、諂媚開場），並附常見例字。
Why：只宣告規則不足以攔下高頻違規，參考 oh-my-pi 的做法，把可自查的具體症狀直接列給模型，命中就先改再送出。
How：在既有規則宣告後追加第二個 echo，維持單行文字、exit 0，不影響任何 CLI 的接線方式。
Who：所有經 UserPromptSubmit hook 或規則檔取得 STE100 規則的 AI CLI 輸出。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
docs(hooks-install): 更新四支 hook 的接線說明與文件 bdfb4619af 
What：hooks-install SKILL.md 改寫接線表並加上逐 CLI 驗證欄；README 補上 sdlc-gate、tools 兩支腳本與 JSC_MODEL 變數說明；AGENTS.md 同步 domain 描述。
Why：新增 SDLC 模型鎖與 wrapper 方案後，安裝流程與環境變數契約已改變，文件必須與實作一致，否則接線技能會漏裝。
How：接線表改為三欄（CLI、接線、驗證），copilot 與 antigravity 改兩段式（jsc-wrap.sh 包裝＋規則檔追加），codex 與 kiro 註明模型鎖降級為技能步驟檢查；每步補上完成判準。
Who：執行 hooks-install 技能的 AI 助理與維護 jsc-hooks domain 的開發者。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
chore(manifest): 三份 manifest 升版至 0.0.3 aae0516cb5 
What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本由 0.0.2 升至 0.0.3，描述補上「SDLC 模型鎖」。
Why：本次新增 SDLC 模型鎖 hook 與 wrapper 工具屬功能擴充，需升版讓各 CLI 的 plugin 更新機制抓到新版本，描述也要反映新能力。
How：三份 manifest 同步改 version 與 description，維持欄位結構不變。
Who：透過 jsc marketplace 安裝 jsc-hooks 的所有 AI CLI 與 jsc-cli:deploy 佈署流程。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Merge pull request 'feat/sdlc-model-lock-and-wrapper' (#5) from feat/sdlc-model-lock-and-wrapper into develop 125005d59d 
Reviewed-on: #5
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
fix(marketplace): 修正 marketplace.json 與正典註冊表不同步的欄位缺漏 c4909e1a1f 
為什麼：
`.claude-plugin/marketplace.json` 與 `.agents/plugins/marketplace.json` 兩份檔案內容與 `plugins/jsc` 正典 marketplace 註冊表不一致，導致各 domain repo 的 marketplace 副本無法保持逐位元組同步。

做了什麼：
補上 `.agents/plugins/marketplace.json` 缺漏的頂層 `description`、`owner` 物件的 `description`，以及全部 11 個外掛（含 jsc-hooks 本身）缺漏的 per-plugin `description` 欄位；同時修正 `.claude-plugin/marketplace.json` 中 jsc-meta 描述的標點不一致問題，將斜線改為中文頓號，與正典風格一致。

怎麼做：
逐欄位比對正典 `plugins/jsc/marketplace.json` 內容，補齊並修正兩份檔案至與正典完全一致。

影響範圍：
`.claude-plugin/marketplace.json`、`.agents/plugins/marketplace.json`，屬全 repo 範圍的基礎設施修正，不影響任何 skill 邏輯或執行行為。
feat(hooks-install): 將 hooks-install 的 CLI 佈線邏輯抽離為腳本 69eee91f27 
為什麼：
`skills/hooks-install/SKILL.md` 原本直接內嵌各 CLI（codex／copilot／antigravity／kiro）的詳細佈線步驟，包含逐步設定檔修改、wrapper alias 安裝、以及 `<!-- jsc-hooks -->` 標記區塊的冪等替換邏輯，違反 jsc-meta:skill-check 稽核準則中「確定性程序邏輯應由腳本執行，不應留給子代理每次自行解讀 prose」的要求。

做了什麼：
新增腳本 `tools/wire-cli.sh {cli}`，將原本內嵌於 SKILL.md 的佈線邏輯全數抽出，並支援冪等執行（標記區塊替換、可安全重跑），輸出機器可讀的 `status=wired|degraded|skipped reason=...` 首行訊息與對應結束碼（0=wired、1=degraded、2=bad usage、3=skipped）。改寫 `skills/hooks-install/SKILL.md`，改為依偵測到的 CLI 呼叫此腳本，並讀取其 status／結束碼判斷結果，不再自行內含佈線步驟。同步更新 `README.md`：在工具表新增 `tools/wire-cli.sh` 說明列，並改寫 hooks-install skill 的描述段落，反映新的腳本驅動流程與 `status=` 回報慣例。三份外掛清單 `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 版本號自 0.0.3 升級為 0.0.4，對應此行為變更。

怎麼做：
建立獨立腳本承載原本的 CLI 佈線程序邏輯，改造 SKILL.md 為呼叫腳本並解讀其標準化輸出，同步更新文件與版本號。

影響範圍：
`skills/hooks-install/SKILL.md`、`README.md`、`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、新增檔案 `tools/wire-cli.sh`；影響 hooks-install skill 的執行流程與所有安裝 jsc-hooks 外掛的 CLI 佈線行為。
Merge pull request 'fix/sync-marketplace-and-hooks-install-script' (#6) from fix/sync-marketplace-and-hooks-install-script into develop b8d0be9c10 
Reviewed-on: #6
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
admin added 4 commits 2026-08-24 08:17:04 +00:00
feat(sdlc-gate): 階段閘門改為能力標籤程式判定，模型不符即擋下該輪提示 830ec26f97 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs(README): 更新 sdlc-gate 閘門行為與 JSC_MODEL 優先序說明 0d1671cae1 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
chore(plugin 版本): 三份 manifest 升版至 0.0.5 cacd234869 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Merge pull request 'feat(sdlc-gate): 階段閘門改為能力標籤程式判定，模型不符即擋下該輪提示' (#7) from fix/sync-marketplace-and-hooks-install-script into develop 5f5d51de8f 
Reviewed-on: #7
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
admin approved these changes 2026-08-24 08:17:13 +00:00
admin merged commit d79a84ef26 into master 2026-08-24 08:17:17 +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.
Blocks
#7 發佈 jsc-sdlc 0.0.5：階段閘門程式化、分支確認與交接優先
plugins/sdlc
Depends on
#7 feat(sdlc-gate): 階段閘門改為能力標籤程式判定，模型不符即擋下該輪提示
plugins/hooks
#6 發佈 jsc-cli 0.0.4：模型能力標籤閘門與階段模型路由
plugins/cli
Reference: plugins/hooks#8