---
name: mu
description: 增量修改 UIDesign.md，根据用户指令在现有内容基础上更新 UI 设计文档。
---

# Modify UIDesign

当用户调用 `/mu` 时，执行以下步骤：

## 1. 读取目标文档

读取以下文件：

1. `doc/UIDesign.md` - 目标文档（必须存在）
2. `doc/DevelopmentPlan.md` - 上游参考文档
3. `doc/review-UIDesign-claude.md` - 评审报告（如果存在，自动作为修改依据）

如果 UIDesign.md 不存在，提示用户：
> UIDesign.md 不存在，请先使用 `/wu` 生成 UI 设计文档。

## 2. 确定修改来源

按以下优先级确定修改内容：

### 2.1 用户提供了修改指令

如果用户在调用 `/mu` 时附带了参数或说明，直接使用该指令。

### 2.2 自动检测评审报告

如果用户未提供修改指令，**自动检测** `doc/review-UIDesign-claude.md` 是否存在：

- **存在**：读取评审报告，提取其中的问题清单，作为本次修改的依据。向用户确认：
  > 检测到评审报告，包含 X 个问题。是否根据评审报告进行修改？

- **不存在**：询问用户：
  > 请说明需要修改的内容，或先运行 `/ru` 生成评审报告。

## 3. 修改原则

### 3.1 增量修改

- 保留原有内容结构和格式
- 仅修改/新增指定部分
- 不删除未明确要求删除的内容

### 3.2 新增内容标记

对于新增的段落或章节：

```markdown
<!-- NEW START -->
新增内容...
<!-- NEW END -->
```

对于行内新增：

```markdown
原有内容 <!-- NEW --> 新增内容
```

### 3.3 修改内容标记

```markdown
<!-- MODIFIED: 原内容为 "xxx" -->
修改后的内容
```

### 3.4 与 DevelopmentPlan 一致性

- 页面设计必须覆盖所有功能模块
- 交互流程必须支撑功能需求
- 设计规范必须统一

## 4. 执行修改

| 修改类型 | 处理方式 |
|----------|----------|
| 新增页面 | 在页面设计章节添加新子章节 |
| 修改布局 | 更新布局描述，添加 MODIFIED 标记 |
| 修改组件 | 更新组件表格 |
| 修改交互 | 更新交互说明 |
| 新增状态 | 在状态列表中添加项目 |
| 修改设计规范 | 更新设计规范章节 |

## 5. 保存并验证

1. 保存修改后的文档到 `doc/UIDesign.md`
2. 使用 git diff 展示变更内容
3. 向用户确认修改是否符合预期

## 6. 输出摘要

向用户展示修改摘要：

- 修改位置（章节/行号）
- 修改类型（新增/修改/删除）
- 修改内容概要
- 与 DevelopmentPlan 的一致性确认

---

## 注意事项

- UIDesign 依赖于 DevelopmentPlan，修改时需确保与上游一致
- 修改后，下游文档（tasks）可能需要同步更新
- 页面修改需考虑对用户流程的影响
- 设计规范修改需检查所有页面的一致性
- 建议修改完成后运行 `/rt` 检查下游一致性

## 标记清理

用户确认修改无误后，可手动删除标记或保留作为变更历史参考。