---
name: planning-write-design
description: SpecPow planning-write-design skill
---

# 编写设计

> 根据规范编写技术设计文档

## 触发条件

- specs 完成后需要编写设计
- 用户提到"写设计"/"技术设计"/"design"

## 铁律

1. **ADR 先行** — 先确定架构决策
2. **接口定义** — 明确模块间接口
3. **前后端分离** — 明确职责边界

## 设计文档结构

```markdown
# 技术设计: [变更标题]

## 1. 架构决策 (ADR)
### ADR-001: [决策标题]
- 状态: 已决定
- 背景: 为什么需要这个决策
- 决策: 选择了什么方案
- 理由: 为什么选这个
- 影响: 这个决策带来什么

## 2. 模块划分
- 模块 A: 职责描述
- 模块 B: 职责描述

## 3. 接口定义
### 3.1 API 接口
| Method | Path | 描述 | 请求体 | 响应体 |
|--------|------|------|--------|--------|

### 3.2 内部接口
- 模块间调用方式

## 4. 数据模型
- 新增/修改的表结构
- ER 关系图

## 5. 前后端分工
| 功能 | 前端 | 后端 |
|------|------|------|
```

## 红旗

- 未确定架构决策 → 先讨论 ADR
- 接口未定义 → 不能开始编码
- 数据模型不清晰 → 先设计 DB