---
name: iteration
description: 通用迭代概念规范——迭代定义、通用生命周期、与功能/测试计划/Bug 的关系、准入准出门禁。agent 处理迭代时据此操作。产线可用同名 skill 覆盖。触发：创建/启动/完成/取消迭代，或提到迭代、sprint、增量、版本迭代。
capability: iteration_capability
tools: [create_iteration, start_iteration, complete_iteration, cancel_iteration, list_iterations, set_iteration_state]
---

# 迭代（通用概念）

## 一、概念定义

迭代 = 项目的一次**增量交付周期**（sprint/版本），把一批功能/修复打包，在固定周期内交付。
迭代是规划与执行的分组单位，功能、测试计划、Bug 都按迭代组织。

## 二、通用生命周期（状态）

| 状态 | 语义 |
|---|---|
| planning | 规划中 |
| in_progress | 进行中 |
| completed | 已完成 |
| cancelled | 已取消 |

通用流转：planning → in_progress → completed；planning/in_progress 可 → cancelled。

## 三、与其他概念的关系

```
迭代 iteration（挂 project）
 ├── 功能 feature（1:N，本迭代要交付的能力）
 ├── 测试计划 test-plan（1:N，本迭代的测试策略）
 └── Bug bug（1:N，本迭代发现的缺陷）
```

## 四、门禁（通用）

- **准入**：迭代范围（scope）明确，含可验收的功能清单。
- **准出**：迭代内功能全部 verified、测试计划 completed、未关闭 Bug 清零（或明确豁免）。

## 五、配套能力（工具）

已固化的 iteration 能力（iteration_capability）：
`create_iteration` / `start_iteration` / `complete_iteration` / `cancel_iteration` / `list_iterations` / `set_iteration_state`（CAS 兜底）。
状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

## 六、分层覆盖

本 skill 是**通用**迭代概念规范；SDLC 产线可用同名 iteration skill 覆盖具体状态机与角色权限。