通过 Issue 组织研发工作、跟踪进度,并围绕具体问题发起讨论。
适用版本:企业版(Teams、Enterprise)。个人版暂不支持。
创建项目
创建项目时,写清要完成的工作和预期结果,方便成员了解项目目标。代码仓库还未确定,也可以先创建项目并添加 Issue。
- 在左侧主导航中打开 项目,单击 新建项目。
- 填写 项目名称,并在 项目目标描述 中写清要完成的工作和预期结果。
- 按需选择封面图标和颜色。在 Repo URL 中填写仓库地址;需要关联多个仓库时,点击 添加仓库 逐项填写,用对应的移除按钮删除不需要的项。也可以留空,之后在项目设置中补充。
- 单击 创建,然后从项目列表中打开该项目。
邀请成员
项目创建后,可以将邀请链接发送给负责需求、开发或测试的同事,由对方通过链接加入。目前仅支持通过链接邀请新成员,不能从企业通讯录中直接添加任意成员。
- 打开项目,单击右上角的 邀请。
- 若尚未生成邀请链接,先生成链接,再复制并发送给需要参与项目的人。
- 使用项目顶部的成员列表查看项目成员。
用 Issue 组织工作
将需要单独分配和跟踪的工作建成 Issue,并写清背景、目标和完成条件。例如,“评审幂等方案”需要确定采用的方案和异常处理方式,“补充回归用例”则需要验证这些异常场景。分开记录后,可以分别记录结果、跟踪进度。
- 在项目中单击 新建 Issue,也可以使用看板某个状态列中的新建入口。
- 填写 Issue 标题,并在描述中写明目标、背景和完成条件。
- 按需设置状态和优先级。
- 单击 创建 Issue。需要连续录入多项工作时,可开启 继续创建。
- 在看板中打开 Issue,查看或修改标题、正文、状态和优先级。需要补充进展时,可以发表评论;背景或目标变化时,再更新正文。
在 Issue 中协作和指派智能体
在 Issue 动态中发表评论、回复具体评论或添加附件,可以补充进展和参考材料。需要将评论中的工作单独跟踪时,打开评论的 更多操作 → 从评论创建 Issue…,根据评论和回复整理草稿,核对标题和描述后再创建。
需要智能体处理 Issue 时,先在正文中写清目标、输入和完成条件,再指派执行:
- 打开 Issue,单击 添加智能体,选择可用的智能体。选择负责人 用于设置项目成员,与智能体执行入口分开。
- 若智能体显示 开启范围并加入项目,先核对范围并完成加入,再选择它执行。开启范围或加入项目本身不会发起执行。
- 指派后,在动态中查看执行状态。单击 查看执行对话 可打开本次执行过程;已有任务运行时,按界面提示等待结束后再调整指派。
- 检查智能体回写的评论和结果,确认满足完成条件后,再更新 Issue 状态。
围绕 Issue 讨论方案
遇到需要多人确认的问题,可以直接从 Issue 发起讨论,已有标题和描述会自动填入。例如,在“评审幂等方案”中邀请后端和测试同事讨论实现方式,确认方案后,再将结论记录回 Issue。
- 打开 Issue,单击 发起讨论。
- 检查预填的讨论标题和描述,补充本次需要讨论的问题。
- 按需选择已有项目成员或 Agent,然后单击 创建。
- 在讨论中交流,并将达成的结论记录回 Issue,更新工作进度。
跟踪项目进度
项目看板按状态展示 Issue,方便查看待开始、进行中和待验收的工作。完成一个阶段或遇到问题时,及时更新 Issue 的描述和状态,让其他成员了解最新进展。
打开 Issue,通过 状态 菜单更新进度。
| 状态 | 建议使用时机 |
|---|---|
| 待规划 | 已记录需求,还需要明确方案或拆分工作 |
| 待开始 | 目标和完成条件已明确,等待执行 |
| 进行中 | 正在处理 |
| 待验收 | 已有结果,等待检查是否满足完成条件 |
| 已完成 | 已确认交付结果满足要求 |
| 已取消 | 不再推进该事项 |