Leo
73a5a67b72
- 測試 3 支新增全綠（首鋪/冪等護用戶檔/掃描跳 template 產物——第三支先紅抓到 CLAUDE.md 洩入再修綠） - CLI 實跑：新鋪 36 檔→重跑 0 新檔（冪等證據）
81 lines
1.3 KiB
Markdown
81 lines
1.3 KiB
Markdown
---
|
||
status: draft # active | draft | paused | closed（生命週期鐵律見 ../SDD-LIFECYCLE.md）
|
||
superseded_by: "" # closed 且被取代時填接替的 SDD 資料夾名
|
||
---
|
||
|
||
# [子系統名稱] — Design
|
||
|
||
> 建立：[YYYY-MM-DD] | 最後更新：[YYYY-MM-DD]
|
||
> 負責人：[名稱]
|
||
|
||
---
|
||
|
||
## 一句話說明
|
||
|
||
[這個子系統做什麼，一句話。]
|
||
|
||
---
|
||
|
||
## 背景與問題
|
||
|
||
[為什麼需要這個子系統？解決了什麼問題？]
|
||
|
||
---
|
||
|
||
## 範圍
|
||
|
||
### 包含（In Scope）
|
||
- [這個 SDD 涵蓋的功能]
|
||
|
||
### 不包含（Out of Scope）
|
||
- [明確排除的功能，避免 CC 自行延伸]
|
||
|
||
---
|
||
|
||
## 設計
|
||
|
||
### 架構概覽
|
||
|
||
[用文字或 ASCII 描述系統結構]
|
||
|
||
```
|
||
[元件 A] → [元件 B] → [元件 C]
|
||
```
|
||
|
||
### 關鍵決策
|
||
|
||
| 決策 | 選擇 | 原因 | 放棄的選項 |
|
||
|------|------|------|----------|
|
||
| [問題] | [選擇] | [原因] | [其他選項] |
|
||
|
||
### API / 介面定義
|
||
|
||
[端點、資料格式、輸入輸出規格]
|
||
|
||
### 資料模型
|
||
|
||
[資料結構、欄位說明]
|
||
|
||
---
|
||
|
||
## 技術限制
|
||
|
||
- [不能用什麼]
|
||
- [必須相容什麼]
|
||
- [效能要求]
|
||
|
||
---
|
||
|
||
## 驗收標準
|
||
|
||
完成的定義（CC 完成任何 task 前必須確認）：
|
||
- [ ] [可客觀驗證的條件，例如：POST /api/xxx 回傳 200]
|
||
- [ ] [...]
|
||
|
||
---
|
||
|
||
## 相關文件
|
||
|
||
- [連結到相關 ADR]
|
||
- [連結到相關 SDD]
|