메뉴
分析 docs/design-review-findings.md 歷史，識別跨 spec 的重複 UI 問題模式，提出流程改善建議。spectra-archive 完成或 findings 累積 5 倍數時主動觸發。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Implement or resume tasks from a Spectra change
Archive a completed change
Have a focused discussion about a topic and reach a conclusion
Implement or resume tasks from a Spectra change
Archive a completed change
Have a focused discussion about a topic and reach a conclusion
| name | design-retro |
| description | 分析 docs/design-review-findings.md 歷史，識別跨 spec 的重複 UI 問題模式，提出流程改善建議。spectra-archive 完成或 findings 累積 5 倍數時主動觸發。 |
分析 Design Review 歷史發現，識別跨 spec 的重複問題模式，主動提出流程改善建議。
本 skill 引用的 /impeccable audit / /impeccable layout / /impeccable harden 等指令來自 pbakaus/impeccable（對齊 design skill Prerequisites 當前鎖定版本，見 design/references/impeccable-install.md）。Consumer 必須先安裝對應版本，否則 retro 報告中的「建議動作」指令會無效。
spectra-archive 完成且該 change 有 design review findings 時docs/design-review-findings.md 新增記錄後，總 change 數達 5 的倍數（5、10、15…）使用者執行 /design-retro 時。可選參數：
/design-retro — 分析全部歷史/design-retro last 3 — 只分析最近 3 個 changedocs/design-review-findings.md對收集到的資料執行以下分析：
按類別統計出現次數與佔比：
| 類別 | 次數 | 佔比 | 趨勢 |
|------|------|------|------|
| spacing | 14 | 30% | ↑ 連續 4 個 change 出現 |
| a11y | 9 | 19% | → 穩定 |
| color | 3 | 6% | ↓ 最近 3 個 change 未出現 |
趨勢判定：
↑ — 最近 3 個 change 中出現 ≥ 2 次→ — 穩定出現但無明顯增減↓ — 最近 3 個 change 中未出現| 嚴重度 | 次數 | 佔比 |
|--------|------|------|
| critical | 5 | 11% |
| warning | 30 | 64% |
| info | 12 | 25% |
統計哪個 design skill 發現最多問題：
| 發現來源 | 次數 | 常見類別 |
|---------|------|---------|
| /impeccable audit | 15 | a11y, color |
| /impeccable layout | 10 | spacing, layout |
| /design improve | 8 | consistency |
統計哪些頁面/元件反覆出現問題：
| 頁面/元件 | 出現次數 | 主要類別 |
|-----------|---------|---------|
| pages/admin/projects.vue | 4 | spacing, layout |
| components/DataTable.vue | 3 | a11y, responsive |
根據 Phase 2 的數據，診斷根因並分為三個層級：
問題在 propose 階段就能預防，但 spec 沒有涵蓋。
判定條件：
改善方向：在 spectra-propose 的 design artifact 加入 checklist
問題在實作時應該被 skill 攔住，但沒有。
判定條件：
改善方向：調整 proactive-skills.md 的 skill 選擇指南或自動觸發條件
問題反映開發者（包括 AI）缺乏某方面意識。
判定條件：
.claude/rules/ 的覆蓋範圍改善方向：建議新增或修改 .claude/rules/ 規則
根據 Phase 3 的診斷，產出具體且可執行的改善建議。
# Design Retro — YYYY-MM-DD
## 分析範圍
- 涵蓋 change: [change-1], [change-2], ...（共 N 個）
- 總 findings: M 筆
## 頻率摘要
[Phase 2.1 的表格]
## 診斷結果
### 需要行動的模式
#### 1. [類別] — [問題描述]
- **層級**: A / B / C
- **證據**: 在 [change-x], [change-y], [change-z] 中出現
- **根因**: [為什麼重複發生]
- **建議動作**:
- [ ] [具體的改善行動，例如「在 spectra-propose 的 design artifact template 加入 spacing checklist」]
- [ ] [第二個行動，若需要]
- **預期效果**: [實施後預期減少的問題量]
### 已改善的模式（正向回饋）
- [類別] 從 X% 降至 Y%（自從 [改善措施] 實施後）
### 暫不行動（觀察中）
- [類別]: 出現 N 次，尚未達行動門檻，持續觀察
## 建議優先序
1. [最高優先] — 影響範圍最大 / 嚴重度最高
2. ...
3. ...
docs/design-review-findings.md 尾部的 ## Retro 決策記錄 區塊## Retro 決策記錄
### YYYY-MM-DD
| # | 建議 | 決策 | 備註 |
| --- | ---------------------------- | ------ | ------------------------------- |
| 1 | propose 加 spacing checklist | 同意 | 已更新 spectra-propose template |
| 2 | 強制觸發 /impeccable harden | 延後 | 等累積更多數據 |
| 3 | 新增 a11y rule | 不同意 | 現有 /impeccable audit 已足夠 |
.claude/rules/ 或 skill 檔案 — 所有改動必須經使用者確認