首次任务
- 文档状态
- 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。已有任务先补充原任务,避免重复派单。
准备最小任务说明
写清下面六项,再提交:
- 目标:要改变什么,当前问题是什么。
- 范围:涉及的功能、页面或仓库,以及明确不做的部分。
- 验收条件:读者或使用者如何判断成功,失败时能观察到什么。
- 来源:相关需求、设计、固定版本文档或缺陷复现依据。
- 依赖:尚未完成的前置工作、待决定事项和实际访问缺口。
- 交付要求:需要源码、测试、部署还是人工体验证据;明确现有授权范围。
例如:“修正文档中某功能的使用入口。首页可到达说明页,旧链接仍可打开,未上线能力须有明确限制。”这是写法示例,不会创建任务或授予发布权限。
提交 AutoDev 开发任务
- 打开你已获访问的 Linear 工作区,进入 AutoDev 工作所属项目,点击项目页的 Issues。先查是否已有同一问题或需求;已有时补充原 Issue,不重复创建。
- 没有现有任务时,在 Backlog 分组右侧点击 +(辅助名称 Create new issue),打开 New issue 弹窗。
- 核对弹窗的项目选择为 AutoDev、状态为 Backlog,并确认团队正确。不要从 Todo、In Progress 等分组创建来绕过就绪判断;项目身份与仓库范围以当前项目配置为准。
- 在 Issue title 填写具体标题,在 Add description… 区域(字段名 Issue description)写入目标、范围、验收、来源、依赖和交付要求。按任务需要设置 Assignee 等属性。
- 核对后点击右下角 Create issue 保存;不继续创建时保持 Create more 关闭。若只是查看或还未准备好,点击右上角关闭按钮退出。
- 保存后打开结果,核对 Issue 编号、项目、描述、状态、负责人及依赖。再按任务跟进查看进度与交付;创建成功不代表 Symphony 已开始执行。
以上英文界面名称已在 AutoDev 项目中只读打开创建弹窗核对;未提交演示任务,未验证保存成功、各角色创建权限或后续执行。界面语言和可用属性可能随账号设置不同;无法创建时交项目 owner 核对权限,不建立替代 tracker。
保存以后会发生什么
当前合同中,AutoDev 的 Linear Backlog 处理默认开启;它先判断目标、验收、仓库范围、依赖与权限,条件具备才推进至 Todo 接续执行。未解决的依赖或业务选择应保留具体阻塞,不能靠反复改状态绕过。实际目标 profile 的启用与运行状态须向配置 owner 和 Symphony 查询。
规则见 Backlog 处理合同。这套 Linear 行为不适用于 Plane;创建 Issue 也不会启用默认关闭的自动审核。
使用 Plane 提交工作
按开始使用(外站)与创建工作项(外站)进入正确项目,选择当前可用类型、填写说明并核对保存结果。负责人、状态与验收见 Plane 状态指南(外站)。
Plane Issue 的自动化开关表示正式委托执行。先确认项目已经接入、权限和范围清楚;手工处理的任务按原生工作流操作,不为了“试一下”而开启自动化。详细边界保留在 Automation 用户体验。
如何判断首次提交成功
成功的最小结果是:在正确项目中能重新打开唯一的原生任务,目标、验收、来源与依赖已保存。执行是否开始、交付是否通过需要另查证据。
- 找不到编号或保存失败:先核对表单提示与项目权限,检查有无已创建结果后再重试。
- 任务停在 Backlog:查看前置依赖、缺少资料或待决定项,补充原任务。
- 找不到当前执行:到 Symphony 核对任务关联和执行服务状态,不能从评论推断正在运行。
下一步:提交与跟进任务 · 任务生命周期 · 开发 AutoDev · 系统边界