Skip to main content

项目

通过 Issue 组织研发工作、跟踪进度,并围绕具体问题发起讨论。

适用版本:企业版(Teams、Enterprise)。个人版暂不支持。
项目用于组织需要多人协作的研发工作,例如开发新功能、修复缺陷或进行技术改造。你可以将工作拆分为 Issue,设置优先级和状态,在看板中跟踪进度。需要评审方案或确认问题时,可以从 Issue 发起讨论,邀请同事和 Agent 一起参与。 例如,为“支付链路可靠性改造”创建项目,将排查重复扣款、评审幂等方案和补充回归用例分别建成 Issue。团队成员可以各自负责一项工作,在 Issue 中记录进展,并根据讨论结论调整后续安排。

创建项目

创建项目时,写清要完成的工作和预期结果,方便成员了解项目目标。代码仓库还未确定,也可以先创建项目并添加 Issue。
  1. 在左侧主导航中打开 项目,单击 新建项目。
  2. 填写 项目名称,并在 项目目标描述 中写清要完成的工作和预期结果。
  3. 按需选择封面图标和颜色。在 Repo URL 中填写仓库地址;需要关联多个仓库时,点击 添加仓库 逐项填写,用对应的移除按钮删除不需要的项。也可以留空,之后在项目设置中补充。
  4. 单击 创建,然后从项目列表中打开该项目。
你也可以单击新建窗口右上角的 使用 Agent 创建,通过 Agent 创建项目。 关联仓库用于记录项目的代码库信息,不会自动克隆全部仓库,也不等于为任务授予仓库访问权。保存前核对各地址;创建时达到账号的项目数量限制,则按页面提示处理。

邀请成员

项目创建后,可以将邀请链接发送给负责需求、开发或测试的同事,由对方通过链接加入。目前仅支持通过链接邀请新成员,不能从企业通讯录中直接添加任意成员。
  1. 打开项目,单击右上角的 邀请。
  2. 若尚未生成邀请链接,先生成链接,再复制并发送给需要参与项目的人。
  3. 使用项目顶部的成员列表查看项目成员。

用 Issue 组织工作

将需要单独分配和跟踪的工作建成 Issue,并写清背景、目标和完成条件。例如,“评审幂等方案”需要确定采用的方案和异常处理方式,“补充回归用例”则需要验证这些异常场景。分开记录后,可以分别记录结果、跟踪进度。
  1. 在项目中单击 新建 Issue,也可以使用看板某个状态列中的新建入口。
  2. 填写 Issue 标题,并在描述中写明目标、背景和完成条件。
  3. 按需设置状态和优先级。
  4. 单击 创建 Issue。需要连续录入多项工作时,可开启 继续创建。
  5. 在看板中打开 Issue,查看或修改标题、正文、状态和优先级。需要补充进展时,可以发表评论;背景或目标变化时,再更新正文。
可以用下面的方式描述一项工作:
标题:评审支付请求的幂等方案
目标:明确重复请求的识别方式与处理规则。
背景:客户端重试可能让同一笔支付请求多次到达服务端。
完成条件:给出方案、异常边界、回归用例及实现负责人。

在 Issue 中协作和指派智能体

在 Issue 动态中发表评论、回复具体评论或添加附件,可以补充进展和参考材料。需要将评论中的工作单独跟踪时,打开评论的 更多操作 → 从评论创建 Issue…,根据评论和回复整理草稿,核对标题和描述后再创建。 需要智能体处理 Issue 时,先在正文中写清目标、输入和完成条件,再指派执行:
  1. 打开 Issue,单击 添加智能体,选择可用的智能体。选择负责人 用于设置项目成员,与智能体执行入口分开。
  2. 若智能体显示 开启范围并加入项目,先核对范围并完成加入,再选择它执行。开启范围或加入项目本身不会发起执行。
  3. 指派后,在动态中查看执行状态。单击 查看执行对话 可打开本次执行过程;已有任务运行时,按界面提示等待结束后再调整指派。
  4. 检查智能体回写的评论和结果,确认满足完成条件后,再更新 Issue 状态。
执行使用对应智能体可用的工作区、模型和权限,不因指派而获得额外访问权。此功能适用于企业版(Teams、Enterprise)。

围绕 Issue 讨论方案

遇到需要多人确认的问题,可以直接从 Issue 发起讨论,已有标题和描述会自动填入。例如,在“评审幂等方案”中邀请后端和测试同事讨论实现方式,确认方案后,再将结论记录回 Issue。
  1. 打开 Issue,单击 发起讨论。
  2. 检查预填的讨论标题和描述,补充本次需要讨论的问题。
  3. 按需选择已有项目成员或 Agent,然后单击 创建。
  4. 在讨论中交流,并将达成的结论记录回 Issue,更新工作进度。
讨论的邀请方式、消息回复和关键消息用法,见讨论。

跟踪项目进度

项目看板按状态展示 Issue,方便查看待开始、进行中和待验收的工作。完成一个阶段或遇到问题时,及时更新 Issue 的描述和状态,让其他成员了解最新进展。 打开 Issue,通过 状态 菜单更新进度。
状态建议使用时机
待规划已记录需求,还需要明确方案或拆分工作
待开始目标和完成条件已明确,等待执行
进行中正在处理
待验收已有结果,等待检查是否满足完成条件
已完成已确认交付结果满足要求
已取消不再推进该事项
Issue 较多时,可以用标题关键词搜索,或通过 添加筛选 按优先级等条件缩小范围。要直接在看板上查看工作背景,可在 卡片字段 中开启描述摘要。 例如,方案评审完成后,在 Issue 中补充评审结论;如果还有问题需要确认,写明待确认内容和需要谁协助。

修改项目资料

打开项目,单击页面顶部项目名称右侧的 …,选择 项目设置。在设置窗口中,可修改项目名称、描述、图标和颜色,也可以补充或调整 Repo URL。修改后,单击 保存设置。