项目
用项目组织相关任务，并为它们提供共同的目标、计划和执行上下文。
项目用来组织需要多条 任务 一起完成的工作，例如一次产品发布、一次迁移，或一个分阶段推进的功能。
一条任务能说清的工作不需要项目。项目适合有共同目标、需要统一跟进进度，或需要共享仓库和工作目录的一组工作。
项目的组成
| 内容 | 用途 |
|---|---|
| 名称、图标和描述 | 目标、范围和长期有效的要求；描述会进入项目内智能体的执行上下文。 |
| 状态 | planned、in_progress、paused、completed 或 cancelled。 |
| 优先级 | urgent、high、medium、low 或 none。 |
| 负责人（lead） | 成员或智能体，表示谁负责协调项目。 |
| 开始和截止日期 | 项目计划的时间范围。 |
| 任务和进度 | 项目中的工作及其完成比例。 |
| 资源 | 关联的 GitHub 仓库或指定电脑上的本地目录。 |
| 工作流 | 任务经过哪些步骤，以及每一步由谁接手。 |
项目和任务的关系
一个项目可以包含多条任务，一条任务最多属于一个项目。可以在项目中直接创建任务，也可以在任务属性中选择或更换项目。
项目进度按关联任务自动计算：
进度 = 状态属于 done 或 closed 分类的任务数 ÷ 项目中的全部任务数内置状态里就是 done 和 cancelled，归入这两个分类的自定义状态也一样计入。cancelled 表示这项工作已从项目范围中结束，所以算进进度。
项目状态和任务状态各管各的：所有任务完成后，项目不会自动变为 completed；修改项目状态，也不会批量修改其中的任务。
- 状态
- 负责人
- 你
- 进度
- 2/4 · 50%
- OPS-41确定活动主题和时间
- OPS-42写活动推文
- OPS-43列出抽奖奖品清单
- OPS-44联系合作博主
10 月 31 日前办完周年庆线上活动：活动推文、抽奖和合作推广。语气保持亲切，花费不超过已批预算。
会作为项目上下文提供给智能体，应用于该项目下的每次运行。
项目描述与执行上下文
智能体执行项目内的任务时，项目名称和描述会加入本次执行的上下文。所有相关运行都需要知道的信息写在描述里，比如目标、技术边界、交付约定；只与单条任务相关的要求写在那条任务中。
添加资源
项目资源告诉智能体使用哪些代码和工作目录：
- GitHub 仓库：提供可 checkout 的仓库和可选 ref。
- 本地目录：让指定电脑上的运行时在已有目录中工作，目录内容会被智能体直接修改。
具体选择和安全边界见项目资源。
选择工作流
项目的工作流决定看板有哪些列，以及任务进入每一步时交给谁。例如开发交给一个智能体，审查交给另一个，最后交给成员验收。没有选用其他工作流时，使用 Default：所有状态都可用，也不会自动交接。创建流程和切换已有项目的方法见工作流。
项目负责人
项目负责人可以是成员或智能体，担任负责人的成员还可以为项目切换工作流。设置负责人不会把任务分配给它，也不会启动任何工作；想让某一步交给项目负责人，在工作流里把这一步的处理人设为项目负责人。
固定到侧边栏
固定后，项目出现在你的侧边栏中。固定是个人偏好，不影响其他成员。
创建、编辑和删除
工作区成员都可以创建和编辑项目；只有 owner 和 admin 可以删除。
删除项目不会删除其中的任务：它们解除关联后继续保留在工作区；项目的描述、状态和资源会被永久删除。