---
name: iter
description: 迭代变更入口，调研问题后更新 PRD.md 和 tasks.md，支持 Bug 修复、功能迭代、技术重构。
---

# Iterate - 迭代变更

> **定位**：1-100 阶段的变更入口。项目已上线，需要修复问题或迭代功能时，通过此 skill 调研、澄清、更新文档。

当用户调用 `/iter` 或 `/iter <问题描述>` 时，执行以下步骤：
⚠️ 重要：本 skill 只修改文档（PRD.md、tasks.md），绝不执行代码、不运行命令、不修改源文件。

## 1. 获取变更描述

如果用户提供了参数，使用该描述。否则询问：
> 请描述需要迭代的内容（Bug/功能/重构）

**示例输入**：
- "登录验证存在漏洞，token 过期后仍可访问"
- "列表页需要增加按时间筛选功能"
- "用户模块性能太差，需要重构缓存策略"

## 2. 调研分析

### 2.1 读取现有文档

读取以下文件了解当前状态：

1. `doc/PRD.md` - 了解产品定义
2. `doc/tasks.md` - 了解任务现状

### 2.2 调研相关代码（可选）

根据问题描述，定位相关代码文件：

- 搜索关键词定位文件
- 读取相关模块代码
- 分析现有实现

### 2.3 分析变更类型

| 类型 | 特征 | 影响范围 |
|------|------|----------|
| Bug/漏洞 | 现有功能不符合预期 | 修复逻辑，可能涉及安全 |
| 功能迭代 | 在现有功能上增加/调整 | 新增或修改功能点 |
| 技术重构 | 不改功能，优化实现 | 性能、架构、代码质量 |

## 3. 澄清确认

**【必须】向用户提出澄清问题**，确保理解准确：

### 3.1 问题理解确认

向用户确认：
> 我理解的变更需求是：{一句话总结}
>
> 变更类型：{Bug修复 / 功能迭代 / 技术重构}
>
> 影响范围：{涉及的模块/功能}

### 3.2 方案选择（如有多种）

如果有多种解决方案，列出选项让用户选择：

```
方案 A：{描述}
- 优点：...
- 缺点：...

方案 B：{描述}
- 优点：...
- 缺点：...

请选择方案，或说明其他想法。
```

### 3.3 边界确认

确认变更边界：
> 本次变更**包含**：
> - {范围1}
> - {范围2}
>
> 本次变更**不包含**：
> - {排除项}
>
> 是否确认？

## 4. 用户确认后执行

**只有用户明确确认后**，才执行以下更新：

### 4.1 更新 PRD.md

使用增量修改标记：

```markdown
<!-- ITER: {日期} - {变更简述} -->
<!-- NEW START -->
新增内容...
<!-- NEW END -->
```

或修改现有内容：

```markdown
<!-- ITER: {日期} - {变更简述} -->
<!-- MODIFIED: 原内容为 "xxx" -->
修改后的内容
```

**更新位置**：
- Bug 修复 → 更新对应功能的验收标准
- 功能迭代 → 在 3.2 功能详情添加/修改功能点
- 技术重构 → 在 4.x 非功能需求或 7.1 技术约束中说明

### 4.2 更新 tasks.md

新增任务使用标记：

```markdown
<!-- ITER: {日期} - {变更简述} -->
| T-xxx | {任务名} | {描述} | {依赖} | {优先级} | {验收标准} |
```

**任务 ID 规则**：
- 查找现有最大 ID，递增分配
- 格式：T-xxx（三位数字）

### 4.3 标记规范

所有变更使用 `<!-- ITER: -->` 前缀，区分于 `/mp` `/mt` 的标记：

- `<!-- ITER: 2026-01-23 - 修复登录验证漏洞 -->`
- 便于追溯迭代历史

## 5. 输出摘要

完成后向用户展示：

```
## 迭代变更完成

**变更类型**: {Bug修复 / 功能迭代 / 技术重构}

**变更摘要**: {一句话描述}

**已更新文档**:
- doc/PRD.md: {更新位置}
- doc/tasks.md: 新增任务 T-xxx

**新增任务**:
| ID | 任务 | 优先级 |
|----|------|--------|
| T-xxx | {任务名} | P0/P1/P2 |

**下一步**:
- 执行任务 T-xxx
- 或运行 `/rp` `/rt` 评审变更
```

---

## 工作流示意

```
用户描述问题
      │
      ▼
┌─────────────┐
│  调研分析   │ ──▶ 读取 PRD、tasks、相关代码
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  澄清确认   │ ──▶ 提问 → 用户回答 → 确认方案
└──────┬──────┘
       │
       ▼ 用户确认
┌─────────────┐
│  更新文档   │ ──▶ PRD.md + tasks.md
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  输出摘要   │
└─────────────┘
```

## 注意事项

- **必须先澄清确认**，不要假设用户意图
- 变更范围要明确，避免 scope creep
- 优先级根据问题严重程度判断：
  - 安全漏洞 → P0
  - 功能 Bug → P0/P1
  - 功能迭代 → P1/P2
  - 技术重构 → P1/P2
- 只更新 PRD + tasks，保持轻量
- 如需更新其他文档，提示用户手动运行 `/mf` `/md` 等

## 与其他 skill 的关系

| 场景 | 使用 skill |
|------|------------|
| 迭代变更入口 | `/iter`（本 skill） |
| 需要更新 FeatureSummary | `/iter` 后运行 `/mf` |
| 需要更新 DevelopmentPlan | `/iter` 后运行 `/md` |
| 需要评审变更 | `/iter` 后运行 `/rp` `/rt` |
| 从头生成文档 | 使用 `/wp` `/wf` `/wd` 等 |