Plane 团队来源接入
- 文档状态
- draft
- 文档 Owner
- DOC
- 事实源
- canonical-docs
- 更新
- 2026/10/16
Plane 是任务来源之一。团队 Plane Tracker 把原生 Issue、状态、依赖和委托信息交给 Symphony；产品日常操作在Plane 正式手册维护。学习核心或使用 Linear 不以 Plane 为前置。
接入依据与适用范围
Plane 不在本站核对的官方 be10a1b79df723d6d7612b5651c8522704dafb2e 适配器注册表中。本页依据现有团队接入协议、实施说明和固定 Code Map。未直接读取团队当前运行仓库、有效配置或部署实例，不声明所有 Plane 项目已接入。
配置应从项目注册表与目标服务的受审 WORKFLOW 确定。现有资料不足以发布一份通用 Plane provider YAML，因而不猜造 tracker.kind、endpoint、credential 字段或服务管理命令；需要具体实例时由 owning 配置补证据。
原生业务状态与执行事实
| 事实 | 到哪里读取 | 适用边界 |
|---|---|---|
| Issue 身份、负责人、业务进度 | Plane 原生工作项 | 不复制为 Symphony Run 状态 |
| 项目绑定与 Issue 自动化委托 | 项目配置及原生委托开关 | 开关开启不证明服务在线或任务已派发 |
| 当前执行、重试、停止 | 对应 Symphony 服务 | 按核心观测与实际服务版本核对 |
| 交付、回归与人工验收 | 原生类型流程及实际交付证据 | Task、Bug、普通 Issue 的动作不能当作所有来源通用 API |
统一 execution-context 合同包含 work_item、automation、CAS revision、适用的 delivery revision 与执行者允许的动作；详细字段只在接入协议定义。本页不另建 wire schema，也不把 revision 当作业务状态。
业务写入与冲突
Plane 的业务动作按其合同绑定预期版本、Issue 更新时间及适用交付版本，并使用幂等键。相同请求重放沿用相同键与负载；内容改变要形成新请求。遇撤销委托、状态 / 版本冲突、缺依赖或权限拒绝，先重新读取与解释原因，不能以不断重试绕过业务拒绝。
执行者不因接入 Symphony 获得人类验收、强制完成或管理员代执行权限。CAS、人工 actor 与审核桥等属于团队来源合同，不能推广为官方所有适配器共有能力。旧 Run、claim/get/finish 与 callback 只按历史资料追溯，不恢复为备用执行路线。
从日常操作进入
- 按创建工作项准备唯一的原生 Issue，核对项目、目标和范围。
- 按负责人和当前责任明确谁处理缺口；手工工作无需为了试用而委托自动化。
- 确认项目已经接入、范围和权限有效后，才按原生界面委托；保存结果后向服务核对实际执行。
- 跟进使用我的工作与状态和验收，同时核对交付版本与执行记录。
这些链接延续既有正式手册入口；此文档修改没有开启开关、提交业务命令或运行任务。撤销委托、人工接手和返工继续遵循团队用户体验合同，先确认旧执行已停止。
工程资料与未启用能力
本分区保留 Plane 工程合同的旧 URL、Asset ID 和必要锚点；它们是来源产品参考，不是 Symphony 核心教程前置。Plane 物化合同仍为 write_enabled: false，不能从本站批量创建或派发任务。AutoDev 自身开发的 Linear 路径也不保留 Plane fallback 或状态同步。