私有化部署敏捷管理工具新手入门指南：从创建迭代开始

公司把敏捷管理工具部署在内网之后，新加入的研发成员或刚接手项目的负责人，第一个要完成的动作通常是创建迭代。私有化部署敏捷管理工具的使用方式和云端工具并没有本质区别，差别主要在访问入口、账号权限和版本节奏由企业自己掌握，所以新手遇到的第一个问题往往不是"功能在哪"，而是"为什么我的菜单里没有"。

这篇文章按真实依赖顺序展开：先说清环境与概念前提，再讲创建迭代的完整步骤，然后处理新手最容易卡住的几个分支，最后给出可验证的生效信号与收尾动作。读完你应该能在自己的账号里独立跑通第一个迭代。

私有化部署环境里，先把两个前提弄清楚

第一个前提是访问与权限。私有化部署意味着系统安装在企业自己的服务器上，日常访问的是一个内网地址，账号由管理员在后台创建并分配权限。看不到"迭代"入口，多数情况不是功能缺失，而是当前角色权限没有覆盖到项目。 需要新建账号或调整权限时找管理员处理，不要借用同事账号登录；如果企业同时还有别的环境（测试环境、培训环境），注意区分访问地址，避免把数据录错地方。

第二个前提是概念对齐。禅道的管理结构分为项目集、产品、项目、执行四层，其中"执行"是一个容易被错过的名称——在敏捷模式下它就是迭代，在瀑布模式下对应阶段，两者含义一致，只是叫法随流程切换。 项目承载本次交付的边界，迭代承载一个周期内的需求与任务，交付标识则放在产品下的版本里。新手上手敏捷开发时，记住"项目 — 迭代 — 任务"这条线就够了。如果你需要确认自己用的是哪一套部署形态，禅道的私有化部署说明里有对应的版本与交付方式。

创建迭代前的三项前置检查

动手创建之前，先确认这三件事，能省掉后面大部分的返工。

1. 项目已经创建，且管理方式选择的是 Scrum 敏捷开发全流程项目管理。 不同的项目管理方式对应不同的流程引擎和视图，选错了后续的迭代、看板行为都会不一样。
2. 项目创建时勾选了"启用迭代"。 禅道使用手册《Scrum项目》（2025 年 9 月更新）的说明是：启用迭代后，项目会被划分为多个迭代，每个迭代都有固定的时间框架，通常是 1 到 4 周，项目输出是增量的；不启用迭代时，项目本身就相当于一个迭代，要做多轮迭代就需要创建多个项目。这个字段从禅道 21 系列开始提供，如果项目创建时没有勾选，回到项目设置里核对，比事后再调整成本低得多。
3. 迭代要有可关联的需求。 需求需要完成评审并处于激活状态，才能被选入迭代。没有任何可关联需求时，迭代也能建出来，但会是一个空壳，看板和燃尽图都不会有内容。

关于迭代周期，两周是研发团队里比较常见的节奏，但周期本身不是越短越好。周期短，反馈快，需求切分和测试压力也更大；周期长，计划稳定，临时插入的变更更容易打乱节奏。内部实践通常建议不要超过 4 周，先按团队实际的发布节奏选一个值，跑完两轮再调整。

从项目进入迭代列表，创建第一个迭代

具体操作路径如下，顺序按界面依赖排列：

1. 进入目标项目，找到左侧的迭代入口。不同版本的菜单名称略有差异，常见写法是"冲刺/迭代"，较新版本统一为"执行"，指向的是同一个对象。
2. 点击右上角的"添加迭代"或"创建迭代"按钮，进入创建表单。
3. 填写迭代名称。建议带上团队与时间信息，例如"支付团队 2026-05"，后续在列表里更容易区分。
4. 设置起止日期。日期决定燃尽图的时间轴，也影响成员可用工时如何折算，尽量与团队实际工作日一致。
5. 关联产品。产品型项目通常已经关联产品；如果这里为空，先把产品补上，否则后面关联需求时没有可选范围。
6. 保存。

成功信号很明确：迭代出现在项目的迭代列表中，状态为待启动，点击迭代名称可以进入它的执行视图。 如果保存后列表里没有出现，先确认是不是保存到了另一个项目，再检查列表的筛选条件是否限制了状态。

顺便区分一组容易混淆的对象：迭代在项目下创建，属于执行层；版本在产品下创建，属于产品层，用于标识一次对外交付。创建位置不同，用途也不同，不要用其中一个替代另一个。

迭代创建之后：建团队、关联需求、分解任务

顺序建议固定下来：先维护团队，再关联需求，最后分解任务。反过来做，最容易出现"任务建完了却没人负责"的情况。

• 维护团队。 在迭代的团队菜单里选择参与成员，并填写每人每天可投入的工时。系统会据此计算这个迭代的可用工时总量，这个数字直接影响后面排任务时的判断。
• 关联需求。 从产品的需求池中勾选本次迭代计划完成的需求。只关联评审通过、状态激活的需求，未评审的需求不会出现在候选列表里。
• 分解任务。 需求确定后逐条分解为任务，任务类型（设计、开发、测试等）为必填项，一个任务对应一个负责人，必要时可以继续拆成子任务。工时估算越接近实际，燃尽图的参考价值越高。

任务不必一次分解到位，但迭代启动前至少要覆盖前几天的排期，否则看板第一天就是空的，团队也看不出节奏。

新手最容易卡住的四个分支

前面四步走下来，卡点通常集中在下面四处。它们的共同点是：迭代本身没有建错，缺的是迭代与需求、人员、时间之间的连接。

如果排查后仍然对不上，先确认自己操作的是不是同一个项目、同一个迭代，多环境并行时这一步最容易被忽略。

确认迭代生效：三个可观察信号

创建动作完成不等于迭代开始运转。判断它是否真的生效，看三个地方：

1. 迭代状态从待启动变为进行中。
2. 看板视图中的任务随状态流转在列之间移动，剩余工时同步变化。
3. 燃尽图开始出现数据点，实际线与计划线的偏差可以当场看出来。

迭代收尾时，关闭迭代，把未完成的需求留到下一个迭代继续处理，已验收的内容再进入版本。迭代用来组织节奏，版本用来标识交付，两者各管一段。 把第一个迭代完整跑通之后，后续的动作可以直接复用同一条路径：项目 → 迭代 → 团队 → 需求 → 任务。到这一步，私有化部署敏捷管理工具就从"公司采购的一套系统"，变成了你每天都会打开的工作台。

参考资料

• 禅道使用手册《Scrum项目》，2025 年 9 月更新：https://www.zentao.net/book/zentaopms/1597.mhtml
• 禅道使用手册《关于禅道项目管理软件》：https://www.zentao.net/book/zentaopms/c859.html