提交与跟进任务
- 文档状态
- draft
- 文档 Owner
- DOC
- 事实源
- canonical-docs
- 更新
- 2026/10/16
提交前先看首次任务。提交后沿同一原生 Issue 跟进需求、反馈和验收，用 Git、外部 CI 与目标环境核实交付；不要把评论中的“完成”当成全部结果。
开始前与操作顺序
先取得已有原生任务、项目范围和对应服务的观察入口；不确定实例时先问 owning 服务，不另起执行者。按下面的顺序推进，每一步都保存可核对的结果：
| 步骤 | 操作 | 预期结果 | 异常下一步 |
|---|---|---|---|
| 准备与提交 | 按首次任务查重并写清范围、验收、来源和依赖 | 正确项目中只有一个可重开的任务 | 保存失败先查已有结果和权限；未就绪则补原任务 |
| 观察执行 | 对应实例中核对任务标识、状态时间及会话 / 重试 / 阻塞 | 明确是否实际派发、等待或停止 | 按任务故障处理定位，不从来源文字猜测 |
| 检查交付 | 比对精确产物、提交、外部 CI，以及任务要求的部署 / 验收 | 每个完成条件有对应证据 | 指明缺项或版本差异，不把一个阶段成功推广到全链路 |
| 反馈与决定 | 在原任务或授权审核入口补充结果，再按项目合同处理 | 反馈、返工或完成决定可追溯 | 未知副作用先对账；业务返工与环境恢复分开 |
独立官方参考实例的活跃状态由其 WORKFLOW 定义；下文自用 Linear 状态表和 Plane 动作不是所有来源的通用流程。公共状态关系见任务生命周期，本文不重复定义调度规则。
去哪里看什么
| 你要确认什么 | AutoDev 自身开发 | Plane 产品使用者 |
|---|---|---|
| 需求、依赖和业务进度 | 所属 Linear Issue | 所属 Plane Issue |
| 谁负责、需要谁补充信息 | 原任务的负责人、反馈和依赖 | 负责人和当前责任（外站） |
| 是否正在执行、重试或已停止 | Symphony 当前执行服务 | 项目已接入且委托有效时，同样向 Symphony 查询 |
| 实际改了什么、是否验证 | 对应仓库的提交、PR/MR、外部 CI 与适用运行证据 | 相同证据原则，不从业务状态推断测试成功 |
| 如何完成日常操作 | 下文解释自用合同 | 我的工作（外站）与状态和验收（外站） |
本站不实时展示任务状态，也不在 Plane 与 Linear 之间同步状态。
读取执行观察
先确认服务版本及项目范围；已启用官方参考 HTTP 观测的实例可以读 summary 和具体 issue，再核对快照时间、标识、会话、重试与阻塞。HTTP 200 仍可能包含 snapshot 错误；issue 404 也不证明原生任务不存在。只读命令、字段边界与异常路径见任务故障处理。接口未启用时使用该服务已有日志或 owner 观察入口，不从文档自行开放端口。
理解 AutoDev 的 Linear 状态
下表是当前自用合同的阅读方式；目标项目实际配置与运行仍需核对。Automation 实施说明和产品合同是规范来源。
| 状态 | 怎么理解 | 你可以做什么 |
|---|---|---|
| Backlog | 尚待就绪判断，或依赖、选择、权限、交付证据尚不齐全 | 查看具体 blocker，补充来源或等待实际依赖解除 |
| Todo | 已具备执行条件并进入可执行队列 | 核对范围与验收；是否已领取向 Symphony 查询 |
| In Progress | 工作正在推进，仍可能等待必要验证或发布证据 | 追踪原任务反馈、源码与 CI，说明需求变更 |
| In Review | 交付进入审核；不是已经通过 | 检查当前交付版本、缺失门禁与审核结果 |
| Done | 任务按适用完成条件结束 | 阅读完成证据；是否包含发布或业务验收须按任务范围判断 |
| Canceled / Duplicate | 取消或重复 | 查看原生原因与关联；不因执行重试而复活 |
Backlog 处理默认开启的合同不会自动关闭任务；自动审核是独立开关，合同默认关闭。不要把 Linear 的状态名、身份或 Backlog 行为套到 Plane。
检查产物与反馈
- 在原 Issue 中确认本次交付范围和版本，查看对应提交与 PR/MR。
- 核对外部 CI 是否绑定同一提交。源码合并、检查通过和目标环境可用分别记录。
- 若任务要求发布或体验验证，继续检查发布身份、目标环境观察和业务验收；文档修改则需对应站点构建与路径证据。
- 发现问题时，在原 Issue 或当前授权审核入口补充可执行反馈：实际结果、期望结果、复现步骤、影响范围和对应版本。私人资料和运行日志留在原有受控位置，只附适当证据引用。
缺证据时应明确缺什么，不能凭完成评论、旧截图或另一版本的 CI 判定通过。
审核、验收与返工
默认人工审核与明确启用后的独立自动审核遵循各自合同，委托执行不代表启用自动审核。按项目当前授权使用原生审核界面或已配置的人工审核入口；通知送达、已读和回复都不等于验收。
反馈应回到同一任务。Linear 返工按当前合同回到 Todo；Plane 使用当前类型的原生打回动作。已合并的交付仍保留历史，新修改从当前注册基线继续，不能假装旧合并被撤销。打回也不等于部署回滚，恢复需走对应系统的维护路径。
验收、合并与发布分别按任务范围、当前授权和真实证据判断；一次验收不隐含其他动作。详细规则见 Automation 用户体验与自动审核合同。
常见问题
创建后没有自动执行
先确认所属 tracker、项目接入、依赖、仓库权限与当前配置，再查看 Symphony。Plane 自动化未委托与 Linear Backlog 判断是两种机制；不能靠搬任务或反复开关解决。用故障定位表区分未入选、等待容量、重试和输入阻塞；无法定位时把具体缺口交给项目或服务 owner。
页面显示完成，但站点或功能没有变化
先核对任务是否要求发布，再比对源码提交、构建、部署版本及目标环境。源代码成功不等于发布成功；需要维护时进入部署与排障。
想人工接手
Plane 的关闭自动化表示撤销委托；按现行合同确认执行服务停止后再接手。Linear 按项目当前接管方式由 owner 处理。保留已有分支、反馈和交付证据，不与仍在运行的执行者同时写同一工作区。具体前提、成功信号与异常下一步见人工接手；没有跨来源通用的接管 API。
想从文档直接批量创建 Plane 任务
Plane 物化合同为 write_enabled: false，没有可执行的通用 materializer。使用已授权的原生任务入口；规划草稿或发布预览不代表已经创建。
相关资料：首次任务 · 系统边界 · Plane 指南范围（外站）