Dev Tech View Supplement

---
name: dev-tech-view-supplement
description: 根据设计补充Dev视角的技术细节（数据库/API/通信协议），帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。
stage: DESIGN
level_supported: [L1, L2, L3]
---

## dev-tech-view-supplement: Dev技术视图补充

### 描述
根据设计文档中的业务语言和架构信息，补充 Dev 视角的技术细节视图。由于 L1/L2 受 CRAFT 的 80% 业务语言约束，技术细节可能不足，导致：
- Dev 收到设计后需要频繁向设计人员问询"数据库怎么设计？""API 有哪些 endpoint？"
- Dev 浪费时间推导技术细节，而不是专注实施
- 设计交接效率低

此 SKILL 补充 Dev 需要的技术视图，加速 DESIGN → IMPLEMENTATION 交接。

### 适用场景
- **WORKFLOW_STEP_4 Task S4-2 Round 2**：生成所有 artifacts 后，为 Dev 补充技术视图
- **WORKFLOW_STEP_4 Task S4-7**：准备向 Dev 团队交付设计时，补充技术细节
- **Dev 反馈场景**：如果 Dev 反馈"设计缺乏实施细节"或"不知道数据库怎么设计"时
- **L1/L2 特定**：L1/L2 受 CRAFT 的 80% 业务约束，此 SKILL 补充技术视图
- **技术栈确认**：在 DESIGN 确认了技术栈后，需要具体的技术设计指导

### 输入
- `spec/design/` 目录（所有 VS/SD/DM/ARCH/ADR）
- `spec/requirements/` 目录（US/NFR，特别是 NFR 中的性能/安全/可扩展性需求）
- 当前级别（L1/L2/L3）
- 项目类型（Web/Mobile/API/CLI 等，从 SPEC_PRJ_DESC 推断）

### 输出
- **Dev 友好的技术细节补充文档**（markdown）
- **数据库设计概览**
  - 主要表清单（表名、用途）
  - 关键字段清单（不需要完整 schema，只需关键字段）
  - 主要索引（哪些字段需要索引及为什么）
  - 数据关系（表之间的关联）
- **API 设计清单**
  - 主要 endpoint 列表
  - 请求/响应格式概览
  - 常见的参数和返回值
- **通信协议选择**
  - 同步 vs 异步决策原因
  - 选择 REST/GraphQL/gRPC 的理由
  - 错误处理策略概览
- **技术栈与模块映射**
  - 哪个模块用什么技术
  - 依赖库选择和理由
- **NFR 技术实现细节**
  - 性能优化方案（缓存策略、索引等）
  - 安全加固方案（认证、加密、权限等）
  - 可扩展性方案（分片、负载均衡等）
- **常见 Dev 问题解答**（FAQ 形式）

### 执行策略
1. **提取已有的技术信息**：
   - 从 ARCH 读取架构层次（前端/后端/数据库 等）
   - 从 ADR 读取已做的技术决策
   - 从 DM 读取数据模型（有助于推导数据库设计）
   - 从 DESIGN artifacts 读取 entry_points 和 value_path

2. **从 NFR 提取技术需求**：
   - 性能 NFR：并发数、响应时间、数据量 → 推导缓存、索引、分片策略
   - 安全 NFR：认证、加密、权限 → 推导安全加固方案
   - 可扩展性 NFR：未来用户量、数据量增长 → 推导分层、负载均衡策略

3. **补充 Dev 需要的技术细节**：
   - **数据库**：
     - 列出主要表（从 DM 推导）
     - 关键字段（哪些字段必须有、哪些可选）
     - 主要索引（基于 NFR 的性能需求）
     - 数据关系（一对多、多对多）
   - **API**：
     - 列出主要 endpoint（基于 VS 的 value_path）
     - 请求格式（GET/POST 等，参数）
     - 响应格式（成功/失败 HTTP code，数据结构）
   - **通信**：
     - 同步 vs 异步（基于 NFR 的实时性需求）
     - 协议选择（基于 ARCH 的技术栈）
     - 错误处理（如何处理超时、重试）
   - **技术栈**：
     - 前端框架/库选择和理由
     - 后端框架/库选择和理由
     - 数据库选择和理由
   - **性能/安全/扩展**：
     - 缓存策略（什么数据缓存、缓存多久）
     - 索引策略（哪些查询频繁、需要加索引）
     - 安全策略（认证、授权、数据加密）
     - 扩展策略（如果用户/数据增长 10 倍怎么办）

4. **确保水位合理**：
   - L1：精简版（仅列出主要数据库表、API endpoint、技术栈理由）
   - L2：标准版（上述内容 + 索引、缓存、安全策略）
   - L3：详细版（上述内容 + NFR 推导过程、性能测试建议、扩展方案细节）

5. **生成 Dev 友好的格式**：
   - 用表格、清单、图表，而不是长段落
   - 用代码示例（JSON 格式的请求/响应，SQL schema 概览）
   - 用 FAQ 解答常见 Dev 问题

### 价值
- **Dev**：快速理解技术设计，减少与设计人员沟通的往返，加速开发启动
- **Tech Lead**：为 Dev 补充 80%/20% 约束下缺失的技术视图，确保实施质量
- **设计人员**：不需要在 IMPLEMENTATION 阶段频繁被 Dev 打断，专注后续设计
- **交接效率**：减少 DESIGN → IMPLEMENTATION 的沟通成本和延误

### 验收标准
| 指标 | L1 | L2 | L3 |
|------|----|----|-----|
| **覆盖范围** | 主要表、endpoint、技术栈 | + 索引、缓存、安全 | + NFR推导、性能/扩展细节 |
| **内容完整性** | ≥80% Dev 问题有答案 | ≥90% Dev 问题有答案 | ≥95% Dev 问题有答案 |
| **交接时间** | Dev 理解时间 <2h | Dev 理解时间 <1h | Dev 理解时间 <30min |
| **技术精准度** | 概览准确，细节允许Dev微调 | 大部分精准，少量细节调整 | 精准可直接用于实施 |