项目
用项目组织相关任务，并为它们提供共同的目标、计划和执行上下文。
项目用来组织需要多条 任务 一起完成的工作，例如一次产品发布、一次迁移，或一个分阶段推进的功能。
一条任务能说清的工作不需要项目。项目适合有共同目标、需要统一跟进进度，或需要共享仓库和工作目录的一组工作。
项目的组成
| 内容 | 用途 |
|---|---|
| 名称、图标和描述 | 目标、范围和长期有效的要求；描述会进入项目内智能体的执行上下文。 |
| 状态 | planned、in_progress、paused、completed 或 cancelled。 |
| 优先级 | urgent、high、medium、low 或 none。 |
| 负责人（lead） | 成员或智能体，表示谁负责协调项目。 |
| 开始和截止日期 | 项目计划的时间范围。 |
| 任务和进度 | 项目中的工作及其完成比例。 |
| 资源 | 关联的 GitHub 仓库或指定电脑上的本地目录。 |
项目和任务的关系
一个项目可以包含多条任务，一条任务最多属于一个项目。可以在项目中直接创建任务，也可以在任务属性中选择或更换项目。
项目进度按关联任务自动计算：
进度 = 状态为 done 或 cancelled 的 issue 数 ÷ 项目中的全部 issue 数cancelled 表示这项工作已从项目范围中结束，因此计入进度。项目状态与任务状态彼此独立：所有任务完成后项目不会自动变为 completed，修改项目状态也不会批量修改其中的任务。
项目描述与执行上下文
智能体执行项目内的任务时，项目名称和描述会加入本次执行的上下文。描述适合保存所有相关 task 都需要的信息：目标、技术边界、交付约定。只与单条任务相关的要求写在该任务中。
添加资源
项目资源告诉智能体使用哪些代码和工作目录：
- GitHub 仓库：提供可 checkout 的仓库和可选 ref。
- 本地目录：让指定电脑上的运行时在已有目录中工作，目录内容会被智能体直接修改。
具体选择和安全边界见项目资源。
项目负责人
Lead 可以是成员或智能体，表示谁负责协调项目。它不是权限设置，不会自动分配项目中的任务；把智能体设为 lead 也不会自动运行它。启动执行仍需分配任务、@提及或自动化触发。
固定到侧边栏
固定后，项目出现在你的侧边栏中。固定是个人偏好，不影响其他成员。
创建、编辑和删除
工作区成员都可以创建和编辑项目；只有 owner 和 admin 可以删除。
删除项目不会删除其中的任务：它们解除关联后继续保留在工作区；项目的描述、状态和资源会被永久删除。