25cb4d1f63
issue #1:新增 /issue-handle slash command,CC 處理 GitHub issue 的 普世指引——讀回自己 repo 直接做、跨 repo 發要先問人、禁掛 Actions/cron 自動輪詢(會觸發 GitHub 異常偵測)。屬共用指引,install/update 不分模組裝。 issue #2:pre-write-guard.sh 釐清定位為「按需手填的空插槽」,非裝上就 生效的警察。檔頭明講有 CC 在場時直接叫 CC 寫貼合的 guard 更好;install/ update 安裝時提示「預設不攔,要手填才生效」,消除安全錯覺。hook 執行維持 安靜不洗版。 另:repo 自己裝了一套開發用 wiki(內部記錄),與 template/ 成品範本實體 隔離,.gitignore 排除 .claude/wiki/、.claude/hooks/、.claude/VERSION, 不推 GitHub。 升版 1.2.0,CHANGELOG 記錄。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
57 lines
3.0 KiB
Markdown
57 lines
3.0 KiB
Markdown
# 更新紀錄 CHANGELOG
|
||
|
||
> 每次改了什麼,都記在這。版號對應 `template/.claude/VERSION`。
|
||
> 想更新到最新版?看 [README → 一鍵更新](README.md#-已安裝舊版一鍵更新)。
|
||
|
||
版號規則(語意化版本,簡化版):
|
||
- **大版號**(1.x → 2.x):破壞性變動,舊專案更新後可能要手動調整。
|
||
- **中版號**(1.0 → 1.1):加了新功能,向下相容,更新即用。
|
||
- **小版號**(1.1.0 → 1.1.1):修 bug、改文件,無新功能。
|
||
|
||
---
|
||
|
||
## 1.2.0 — GitHub issue 指引 + pre-write-guard 定位釐清
|
||
|
||
**新增**
|
||
- `/issue-handle` slash command(`template/.claude/commands/issue-handle.md`):
|
||
CC 處理 GitHub issue 的普世指引,三層界線——
|
||
①讀/回/結案自己 repo 的 issue(直接做);
|
||
②發 issue 給別的 repo(先問人,不擅自);
|
||
③**禁止掛 Actions/cron/webhook 自動輪詢 issue**(會觸發 GitHub 異常偵測、被 rate limit)。
|
||
屬共用指引,install/update 不分模組都裝。(issue #1)
|
||
|
||
**變更**
|
||
- `pre-write-guard.sh` 釐清定位(issue #2):它是「按需手填的空插槽」,不是裝上就生效的警察。
|
||
- 檔頭明講:**有 CC 在場時,直接叫 CC 寫貼合的 guard hook 更好**,這個空殼範本只對「手動 DIY」用戶有價值。
|
||
- 解決安全錯覺:install.sh / update.sh 安裝它時提示「預設不攔任何東西,要手填+掛 settings 才生效」,
|
||
讓用戶不會誤以為裝了就有保護。(hook 執行時維持安靜,避免每次 Write 洗版。)
|
||
|
||
---
|
||
|
||
## 1.1.0 — 一鍵更新
|
||
|
||
**新增**
|
||
- `scripts/update.sh`:已安裝舊版的人,一行指令更新到最新版。
|
||
只覆蓋模板/邏輯檔(hooks、commands、TEMPLATE-*),**完全不碰**使用者資料
|
||
(`wiki/status.md`、`mistakes.md`、`decisions-summary.md`、`.wikiignore`、`settings.json`、`CLAUDE.md`)。
|
||
會先比對版本、列出新功能、依已裝模組自動偵測該更新什麼,跑完自我更新。
|
||
- `template/.claude/VERSION`:版本基準檔,讓「檢查新版」有依據。
|
||
- `CHANGELOG.md`(本檔)。
|
||
|
||
**第一次更新的雞生蛋問題**:舊版本機還沒有 `update.sh`,所以第一次靠 README 那行
|
||
`curl` 從遠端抓更新器來跑;跑完它把自己裝進 `scripts/update.sh`,之後直接跑本機的即可。
|
||
|
||
---
|
||
|
||
## 1.0.0 — 模組化安裝(基準版)
|
||
|
||
此版本之前無 VERSION 檔,以下為依 git 歷史回溯的功能基準。
|
||
|
||
- `scripts/install.sh` 模組化安裝:`--wiki` / `--sdd` / `--all`,無參數則互動詢問。
|
||
- **LLM Wiki**:CC 記憶系統(INDEX / status / mistakes / decisions-summary)
|
||
+ 接關 hook(session-start-recall)+ 對應 slash commands。
|
||
- **wiki 機敏防護三層**:`.wikiignore`(檔案層)+行內標記(局部)+
|
||
`wiki-secret-scan.sh`(機械兜底攔截)。
|
||
- **SDD 強制**:動 code 前必須有 `design.md`,由 `sdd-guard.sh` hook 把關,附 TEMPLATE 範本。
|
||
- docs 分類結構(1-vision ~ 6-user)與 ADR 範本。
|