Skip to main content

首次任务

文档状态
draft
文档 Owner
DOC
事实源
canonical-docs
更新
2026/10/16

先选择已有服务和任务所属系统,再提交一项可检查的任务。本页默认介绍 AutoDev 自身开发的现有 Linear 路径,不要求安装 Plane 或新启 Symphony。要从零准备独立参考实例,先按首次运行 Symphony配置官方实现与 Linear;其活跃状态由示例明确配置,不替代本页自用实例的 Backlog 准入。

如果只在 Plane 中处理日常工作,可直接阅读创建工作项(外站)。

先确认你走哪条路径​

你要做什么提交位置提交前需要什么
为 AutoDev 改功能、修问题或维护文档所属 Linear 项目中的原生 Issue已有项目访问、明确范围、注册仓库和可检查的验收条件
在 Plane 中安排产品或团队工作该工作所属的 Plane 项目有效成员权限、正确项目和业务负责人;按 Plane 当前表单操作
只有想法或规划草稿先补齐需求与来源规划工作台的 Issue 预览不等于已创建任务,也不触发执行

不要把同一项工作同时复制到 Linear 和 Plane。已有任务先补充原任务,避免重复派单。

准备最小任务说明​

写清下面六项,再提交:

  1. 目标:要改变什么,当前问题是什么。
  2. 范围:涉及的功能、页面或仓库,以及明确不做的部分。
  3. 验收条件:读者或使用者如何判断成功,失败时能观察到什么。
  4. 来源:相关需求、设计、固定版本文档或缺陷复现依据。
  5. 依赖:尚未完成的前置工作、待决定事项和实际访问缺口。
  6. 交付要求:需要源码、测试、部署还是人工体验证据;明确现有授权范围。

例如:“修正文档中某功能的使用入口。首页可到达说明页,旧链接仍可打开,未上线能力须有明确限制。”这是写法示例,不会创建任务或授予发布权限。

提交 AutoDev 开发任务​

  1. 打开你已获访问的 Linear 工作区,进入 AutoDev 工作所属项目,点击项目页的 Issues。先查是否已有同一问题或需求;已有时补充原 Issue,不重复创建。
  2. 没有现有任务时,在 Backlog 分组右侧点击 +(辅助名称 Create new issue),打开 New issue 弹窗。
  3. 核对弹窗的项目选择为 AutoDev、状态为 Backlog,并确认团队正确。不要从 Todo、In Progress 等分组创建来绕过就绪判断;项目身份与仓库范围以当前项目配置为准。
  4. 在 Issue title 填写具体标题,在 Add description… 区域(字段名 Issue description)写入目标、范围、验收、来源、依赖和交付要求。按任务需要设置 Assignee 等属性。
  5. 核对后点击右下角 Create issue 保存;不继续创建时保持 Create more 关闭。若只是查看或还未准备好,点击右上角关闭按钮退出。
  6. 保存后打开结果,核对 Issue 编号、项目、描述、状态、负责人及依赖。再按任务跟进查看进度与交付;创建成功不代表 Symphony 已开始执行。
核查范围

以上英文界面名称已在 AutoDev 项目中只读打开创建弹窗核对;未提交演示任务,未验证保存成功、各角色创建权限或后续执行。界面语言和可用属性可能随账号设置不同;无法创建时交项目 owner 核对权限,不建立替代 tracker。

保存以后会发生什么​

当前合同中,AutoDev 的 Linear Backlog 处理默认开启;它先判断目标、验收、仓库范围、依赖与权限,条件具备才推进至 Todo 接续执行。未解决的依赖或业务选择应保留具体阻塞,不能靠反复改状态绕过。实际目标 profile 的启用与运行状态须向配置 owner 和 Symphony 查询。

规则见 Backlog 处理合同。这套 Linear 行为不适用于 Plane;创建 Issue 也不会启用默认关闭的自动审核。

使用 Plane 提交工作​

按开始使用(外站)与创建工作项(外站)进入正确项目,选择当前可用类型、填写说明并核对保存结果。负责人、状态与验收见 Plane 状态指南(外站)。

Plane Issue 的自动化开关表示正式委托执行。先确认项目已经接入、权限和范围清楚;手工处理的任务按原生工作流操作,不为了“试一下”而开启自动化。详细边界保留在 Automation 用户体验。

如何判断首次提交成功​

成功的最小结果是:在正确项目中能重新打开唯一的原生任务,目标、验收、来源与依赖已保存。执行是否开始、交付是否通过需要另查证据。

  • 找不到编号或保存失败:先核对表单提示与项目权限,检查有无已创建结果后再重试。
  • 任务停在 Backlog:查看前置依赖、缺少资料或待决定项,补充原任务。
  • 找不到当前执行:到 Symphony 核对任务关联和执行服务状态,不能从评论推断正在运行。

下一步:提交与跟进任务 · 任务生命周期 · 开发 AutoDev · 系统边界