plugins/hooks
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
72 Commits 12 Branches 0 Tags
8f98e42171944fcdafc21dbf642a9ae127c09e57
Commit Graph
18 Commits
Author SHA1 Message Date
jiantw83 5d60e0f231 feat(hooks-install): 文件同步六支 hook 與降級說明 
What：`skills/hooks-install/SKILL.md`、`README.md`、`AGENTS.md` 三份文件一併改口徑為六支 hook，補上 `comment-scope.sh` 的職責、兩種模式、環境變數 `JSC_COMMENT_SCOPE` 與 `JSC_CHANGED_FILE`，以及各 CLI 的覆蓋範圍差異。

Why：文件停在五支會誤導操作者，讓人以為每個 CLI 都受同等保護。實際上只有 claude 有 post-tool hook，其他四個 CLI 只接得到規則提示，這個落差必須據實寫明。

How：SKILL.md 的 `description` 與正文加上 comment scope scanner，並註明 exit 2 在冒煙測試裡算健康；README.md 的 hook 表格新增一列，接線工具那列改寫 `smoke` 的例外說明，環境變數表補兩列，另加一段講明四個 CLI 的降級實情；AGENTS.md 新增一條規則，寫明規則正文的唯一來源在 `jsc-review`，本存取庫不留副本。

Who：`jsc-hooks` 的文件層與 `hooks-install` 技能，供操作者與後續 sub agent 依循。
 2026-08-26 19:01:36 +08:00
jiantw83 221742486b fix(sdlc-gate): 工作包鎖檔改依索引區分，避免平行工作包互相覆蓋並修正提示文字 2026-08-26 17:59:21 +08:00
jiantw83 f1bcdc3d72 feat(wire-cli): 新增唯讀的接線盤點子命令 
What: wire-cli.sh 新增 status 子命令，只讀設定檔判斷 jsc 標記段落在不在，不寫檔也不執行 hook。每個接線點印一行 item，以 status=wired、degraded、unwired、skipped 回報。
Why: 體檢類技能要問「hook 接線在不在」，但既有三個子命令都會動到環境：不帶子命令會重新接線、purge 會刪掉、smoke 會真的執行 hook。體檢不該有副作用。
How: 沿用底下接線區塊的同一組檔案位置與標記字串，共用 has_block、toml_root_key、json_top_key 三個判讀函式。codex 的 notify 另外單獨檢查是否落在根層，標記在、鍵被歸進表裡時 codex 讀不到，等同沒接。
Who: 供 jsc-cli:doctor 呼叫的接線檢查。
 2026-08-26 10:44:47 +08:00
jiantw83 26a5a4690d docs(hooks): 補上工作包 PR 閘門的 hook 說明與逃生門 2026-08-25 18:59:29 +08:00
jiantw83 6ecb7d0387 docs(hooks): 同步 purge、smoke 與錯誤掃描的工具與技能說明 2026-08-25 18:18:10 +08:00
jiantw83 c68292acbc feat(hooks): 自動接手失敗接線與修復流程 2026-08-25 16:33:38 +08:00
jiantw83andClaude Opus 5 83170e1b43 docs(hooks): 同步文件與參考資料 
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>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 8a8e455c87 docs(README): 補上 version-guard report 的用途說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 13:03:17 +08:00
jiantw83andClaude Opus 5 922a95f147 docs(README): 補上 version-guard 與其環境變數說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 11:52:38 +08:00
jiantw83andClaude Opus 5 4b64bf526e docs(README): 安裝入口改為 plugins/meta 並補上遷移說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
jiantw83andClaude Opus 5 0d1671cae1 docs(README): 更新 sdlc-gate 閘門行為與 JSC_MODEL 優先序說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 16:05:18 +08:00
jiantw83 69eee91f27 feat(hooks-install): 將 hooks-install 的 CLI 佈線邏輯抽離為腳本 
為什麼：
`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 佈線行為。
 2026-08-24 14:47:46 +08:00
jiantw83andClaude Fable 5 bdfb4619af docs(hooks-install): 更新四支 hook 的接線說明與文件 
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>
 2026-08-24 11:36:54 +08:00
jiantw83 e0dd3072b2 feat(error): 新增 ERROR wiki 範本 2026-08-21 16:53:17 +00:00
jiantw83andClaude Fable 5 4ffc8459e1 style(hooks): 中文並列改頓號 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:29:45 +08:00
jiantw83andClaude Fable 5 de3c53f1df docs(hooks): README 安裝/更新/移除改為每指令一行（五個 CLI）並為相關 domain 加上 repo 連結 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:36 +08:00
jiantw83andClaude Fable 5 9854c05a72 docs(hooks): 以統一格式改寫繁體中文 README 與 AGENTS 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83 57c7191108 Initial commit 2026-08-21 04:42:09 +00:00