---
name: "deviation-report"
description: "偏差报告技能 — 对照执行文档逐条比较实现，记录所有偏差。当需要"写偏差报告"、"版本复盘"、"比较实现偏差"时使用。"
---

# 偏差报告

> 对照执行文档逐条比较实现，诚实记录所有偏差。

## 触发条件

- **版本复盘任务**：版本开发完成后进行复盘时使用
- **用户手动触发**：用户说"写偏差报告"、"版本复盘"等

---

## 五项要求

1. **逐条对照执行文档比较实现** — 每一条行为规则
2. **记录所有偏差** — 无论多小
3. **为每个偏差分级**：
   - **轻微**：不影响核心行为——如过渡时间从 0.3s 调为 0.25s，UI 布局微调
   - **重大**：影响核心行为或与设计严重不一致——如遗漏行为规则、改变了交互流程、系统接口不匹配
4. **解释每个偏差的原因** — 技术限制、性能优化、设计不合理等
5. **建议后续处理** — 轻微偏差：在文档同步时处理；重大偏差：建议开启新版本或回退

---

## 偏差报告格式

```markdown
## 实现偏差清单

### 偏差 1
- **对应执行案条目**: [执行文档中的具体行为规则]
- **偏差等级**: 轻微 / 重大
- **原方案**: [技术设计中的计划]
- **实际实现**: [实际做了什么]
- **偏差原因**: [为什么发生偏差]
- **建议处理**: [后续处理建议]
```

---

## 核心原则

**绝不隐瞒偏差。** 诚实报告至关重要，因为文档是下一个迭代的起点。