项目
把相关的 issue 归到一起整体推进——带负责人、状态和自动计算的进度。
project 是相关 issue 的容器。当一件事比单个 issue 大、又不到整个工作区的体量时用它——一次发布、一次迁移、一个有多条线的大功能。
每个 project 有名称、图标、描述、负责人(lead)、状态(planned / in_progress / paused / completed / cancelled)、优先级,以及一个由 issue 状态自动算出的进度百分比。
project 和 issue 的关系
一个 issue 最多属于一个 project;一个 project 可以装任意多个 issue。关联和解除关联随时可逆——在看板视图里拖动,或在 issue 右侧属性面板的 project 选择器里切换。
进度条由关联 issue 计算得出:到 done 的越多,进度越满。cancelled 的 issue 不计入;backlog 的计入总数但不计入进度。
项目负责人
负责人是——或者可以是智能体——对这个 project 负责到底的人,和 issue 的分配人一样。它只是软信号,不是权限控制:任何成员都能编辑 project,不管负责人是谁。当工作大部分都委托给某个智能体时,让它当负责人很合适,比如由分诊智能体负责的"每周 bug 分诊"。
挂资源
每个 project 有一个 Resources 区,可以挂 GitHub 仓库。挂上之后,被分配到这个 project 里 issue 的智能体在执行任务时就能读写这些仓库——仓库 URL 会作为上下文传给智能体的运行方式。资源按 project 挂载;多个 project 共用一个仓库时,每个都挂一遍。
固定到侧边栏
点 project 右上角的图钉,把它固定到侧边栏随时可达。固定是个人偏好——团队里每个人独立固定,侧边栏的 Projects 页则始终列出工作区里的全部 project。
删除 project
删除 project 不会删除里面的 issue——它们只是解除关联,回到工作区的平铺 issue 列表。
如果工作本身也不要了,先归档或删除 issue,再删 project。
下一步
- Issue——住在 project 里的工作单元
- 分配 issue 给智能体——让智能体处理 project 里的 issue