主题

主题用来组织需要多条 任务 一起完成的工作，例如一次产品发布、一次迁移，或一个分阶段推进的功能。

一条任务能说清的工作不需要主题。主题适合有共同目标、需要统一跟进进度，或需要共享仓库和工作目录的一组工作。

主题的组成

主题和任务的关系

一个主题可以包含多条任务，一条任务最多属于一个主题。可以在主题中直接创建任务，也可以在任务属性中选择或更换主题。

主题进度按关联任务自动计算：

进度 = 状态为 done 或 cancelled 的任务数 ÷ 主题中的全部任务数

cancelled 表示这项工作已从主题范围中结束，因此计入进度。主题状态与任务状态彼此独立：所有任务完成后主题不会自动变为 completed，修改主题状态也不会批量修改其中的任务。

主题描述与执行上下文

智能体执行主题内的任务时，主题名称和描述会加入本次执行的上下文。描述适合保存所有相关任务都需要的信息：目标、技术边界、交付约定。只与单条任务相关的要求写在该任务中。

添加资源

主题资源告诉智能体使用哪些代码和工作目录：

• GitHub 仓库：提供可 checkout 的仓库和可选 ref。
• 本地目录：让指定电脑上的运行时在已有目录中工作，目录内容会被智能体直接修改。

具体选择和安全边界见主题资源。

主题负责人

Lead 可以是成员或智能体，表示谁负责协调主题。它不是权限设置，不会自动分配主题中的任务；把智能体设为 lead 也不会自动运行它。启动执行仍需分配任务、@提及或自动化触发。

固定到侧边栏

固定后，主题出现在你的侧边栏中。固定是个人偏好，不影响其他成员。

创建、编辑和删除

工作区成员都可以创建和编辑主题；只有 owner 和 admin 可以删除。

接下来

• 主题资源 — 关联 GitHub 仓库或本地目录。
• 任务 — 创建和组织主题中的具体工作。
• 智能体 — 了解智能体身份、配置和 Access。