ecf1f882c6
工具產物原散在用戶根目錄(docs 七層、scripts),又把 wiki/VERSION 寄生在 CC 原生
.claude/ 裡,用戶分不清哪個 docs 是工具的。這版徹底收斂:除 .claude/(settings/
commands/hooks)與 CLAUDE.md 留根,工具所有資料收進 system-dev/。
對應 SDD: system-dev/docs/3-specs/install-layout/(內部記錄,依原則不推)。
- 新結構 system-dev/{VERSION,wiki/,docs/,scripts/};.claude/ 只剩 CC 機制檔
- wiki 改寫產物落點正式化:install 建 system-dev/wiki/cards/(.gitkeep)
- docs 雙語義拆開:工具文件→system-dev/docs/;用戶 raw source 維持原處只讀
- scripts 一開始就裝進 system-dev/scripts/
- 舊版自動遷移雙保險:update.sh 冪等搬移(wiki 含 .git、docs 白名單)
+ session-start hook 偵測舊結構未遷移時提示(low-code 用戶兜底)
- wiki-secret-scan 觸發路徑改 system-dev/wiki/**(否則新結構防護失效)
- 全套路徑引用同步:CLAUDE/SKILL/wiki-*/sdd-*/hooks/INDEX/README(中英)
- 沙盒驗證:遷移含 .git commit 一致、冪等、用戶自填 docs 保留;全 bash -n 過
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
56 lines
1.4 KiB
Markdown
56 lines
1.4 KiB
Markdown
# /sdd-check — 確認當前任務有沒有對應 SDD
|
||
|
||
動手前執行。確保 CC 有全局觀,不會在沒有設計文件的情況下猛衝。
|
||
|
||
---
|
||
|
||
## 執行流程
|
||
|
||
### 第一步:理解任務
|
||
|
||
確認使用者要做什麼:
|
||
- 涉及哪個子系統?
|
||
- 是新功能還是修改現有功能?
|
||
- 影響範圍?
|
||
|
||
### 第二步:尋找對應 SDD
|
||
|
||
在 `system-dev/docs/3-specs/` 下尋找對應的子系統目錄,確認有沒有:
|
||
- `design.md`(設計文件)
|
||
- `tasks.md`(任務清單)
|
||
|
||
### 第三步:根據結果回應
|
||
|
||
**情況 A:找到對應 SDD**
|
||
```
|
||
✅ 找到 SDD:system-dev/docs/3-specs/[子系統]/
|
||
📋 design.md:[確認]
|
||
📋 tasks.md:[確認,列出相關 task]
|
||
🎯 對應 task:[編號和描述]
|
||
繼續嗎?
|
||
```
|
||
|
||
**情況 B:找不到 SDD,任務明確**
|
||
```
|
||
⚠️ 找不到對應 SDD
|
||
任務:[描述]
|
||
建議在 system-dev/docs/3-specs/[建議子系統名]/ 建立 SDD
|
||
|
||
要我幫你起草 design.md 嗎?(需要你確認後才動手)
|
||
```
|
||
|
||
**情況 C:找不到 SDD,任務模糊**
|
||
```
|
||
⚠️ 找不到對應 SDD,而且任務範圍不夠清楚
|
||
請先回答:
|
||
1. 這個功能屬於哪個子系統?
|
||
2. 完成的標準是什麼?
|
||
3. 有沒有不能動的邊界?
|
||
```
|
||
|
||
### 注意
|
||
|
||
- 找不到 SDD **不等於可以直接動手**
|
||
- 小修改(修 bug、改文字)可以豁免,但要明確說「這是小修改,範圍是 X」
|
||
- 新功能、架構變動、跨模組的修改 → 一定要有 SDD
|