项目来源平台选型

2026-11-19 · 官方文档调研与接入建议

建议与顺序

建议先实现 GitHub Projects,再实现 Linear,随后用 Plane 验证自托管接入。飞书项目按国内试点需求提前;Jira 放在企业团队阶段。这个顺序是基于当前 GitHub 交付链路、研发团队的项目模型和自托管目标作出的产品判断,尚未完成这些项目来源适配器的联调。

项目来源的职责是提供项目目录、需求、负责人、状态与上下文。Progressive Agent 负责把这些项目绑定到仓库、Agent 与执行策略。外部平台仍是项目与业务状态的权威来源,运行日志、测试结果和执行状态由 Progressive Agent 管理。

推荐平台

平台可作为来源的对象官方接入能力推荐用途与边界
GitHub ProjectsProjectV2、Issue、草稿项、自定义字段Projects API,组织项目与项目项事件首个适配器。与现有仓库、PR 链路衔接;一个看板可能跨多个仓库。Projects webhook 当前针对组织项目且有预览限制,个人项目优先用轮询。
LinearProject、Issue、项目更新与文档GraphQL、OAuth、Project/Issue webhook、Agent 接入机制首个独立项目平台适配器。适合产品研发团队;读取团队与权限范围,仓库绑定另行确认。
PlaneWorkspace 下的 Project、Work item、Cycle、ModuleREST API、webhook、可配置自托管 API 地址开源与自托管方向的优先候选。适配器按实例与 API 版本声明能力,不能默认云版和所有自托管版本一致。
飞书项目空间、工作项、流程、字段与评论开放平台数据接口、自动化连接器及工作项事件国内飞书用户优先候选。先确认哪种工作项代表产品项目;飞书 Docs 中的 Project 目录与飞书项目是不同系统。
Jira CloudProject、Issue、Issue type、字段、状态流转REST API v3、OAuth、动态 webhook企业研发团队候选。自定义字段和状态需要逐项目映射;REST 动态 webhook 有有效期,需要续订。Data Center 单独适配。

其他值得保留的候选

平台适合场景接入判断
GitLab使用 GitLab.com 或 Self-Managed 的研发团队有 Projects API 与项目 webhook。Project 在代码托管侧通常对应仓库,需要额外建业务项目映射;MR 交付也应由 RepositoryProvider 配套实现。
OpenProject需要自托管和层级项目管理的团队API v3 覆盖项目与工作包,支持项目、工作包等事件。需确认部署版本、workspace 类型与 API 覆盖范围。
Asana产品、设计、运营共同参与的跨职能团队有项目列表与 webhook。项目中可能包含非代码任务,需筛出可开发需求并绑定仓库;事件同步应保留轮询补偿。
Notion已有 Projects/Tasks 数据库的小团队Data source 查询与 webhook 可用。需要先映射名称、状态、负责人和任务关系等字段;适合可配置模板来源。
TAPD已使用腾讯研发协作工具的国内团队官方有用户参与项目列表 API。API 属于商业化模块,授权与费用需由试点企业确认;放在有明确客户需求时接入。

暂不同时实现所有平台。首版用两个适配器验证统一契约,再扩展自托管与企业复杂流程。

产品中的接入体验

1. 连接平台并授权只读项目范围;自托管实例额外填写服务地址。

2. 列出可读项目,用户选择需要同步的项目。导入名称、描述、别名、成员、状态、来源链接与修订信息。

3. 从已有代码关联建议仓库,用户确认仓库、基线分支、Agent、校验命令与执行策略。未配置完整的项目可同步、不可自动派发。

4. 绑定会议系列、群聊或项目别名。会议中提取的每条待办独立匹配项目,存在多个候选时进入待确认。

5. 若会议明确引用已有需求,优先更新或关联原需求;新需求在开启写入授权后创建外部任务,并保存外部 ID。

6. Agent 执行完成,回写 PR、校验摘要和运行链接。创建草稿 PR 对应“待审阅”,不直接等同于业务任务“已完成”;合并或人工确认后再按映射流转。

统一契约与模型

新增 ProjectSource,与 MeetingSource、AgentExecutor、RepositoryProvider、DeliverySink 并列。

ProjectSourceBinding 保存 connectionId、externalProjectId、externalUrl、localProjectId、fieldMapping、lastRevision、lastSyncedAt。唯一键包含 workspaceId、connectionId、externalProjectId,自托管实例由独立 Connection 标识。

ExternalWorkItemBinding 保存 taskId、externalWorkItemId、externalUrl、externalProjectId 和写回标记。同一个内部 Project 可以关联多个外部来源,但只选择一个默认需求写入目标,避免同时复制出多套任务。

外部名称、描述与业务状态随来源更新;本地仓库、Agent、测试命令和执行权限独立维护。外部字段不能直接覆盖可执行命令或扩大权限。撤权或归档后停止新派发,保留已授权范围内的运行审计。

webhook 接收后重新读取可见资源,结合分页对账防止遗漏。写回记录 origin、任务 ID 和修订,过滤自身更新造成的循环。远端创建响应丢失时按稳定标记查找原任务;无法确认时进入对账状态,避免盲目重建。

首版验收

官方资料