走完第一个需求

Studio、Git 连接、运行环境、Agent 和项目都配好之后，用一个小需求把流程从头到尾走一遍。走完这一遍，你会看到 Agent 团队怎样推进一个任务，也能确认每个环节都接通了，再邀请同事加入。

准备

• 项目的“初始化项目”任务已经完成，见 新建项目。
• 至少启用了两个 Agent，调度 Agent 选好了首选，见 启用 Agent。
• 运行环境在线。

1. 提出需求

1. 打开项目，点「新建任务」。右侧打开一段和 Agent 的会话，当前项目会作为上下文一起发过去。

2. 用业务语言写一个小需求，连同验收方式。例如：

   复制

   在应用里新建“供应商”数据表，字段包括名称、联系人、电话、状态（合作中、暂停），并在导航里加一个“供应商”页面，可以新增、编辑和查看供应商。
   验收：登录后能从导航打开“供应商”页面，新增一条供应商并在列表里看到它。

3. 发送。需求说清楚了，Agent 会直接把它整理成任务；有不清楚的地方，会先问你。

4. 任务建好后，在会话里点「开始执行」。也可以打开任务，点「开始」。

不想经过会话，点会话里的「手动填写」，直接填写标题和描述。

完成的标志任务进入「进行中」，执行者是调度 Agent。

2. 看 Agent 团队推进

打开任务。最上方的「现在」一行，随时写着哪个 Agent 在做、做了多久、在哪台运行环境上，下面是接下来做什么。

「动态」里能看到调度 Agent 每一次交接：交给谁、做什么、读什么、做到什么程度算完成，以及为什么选它。这个需求要新增数据表，调度 Agent 会先请擅长设计的 Agent 写一份简短方案，再把开发交给擅长开发的 Agent。开发的 Agent 写代码、写测试、在运行的应用里截图，然后开 PR，分支是 agent/任务编号。最后，调度 Agent 把代码交给另一个模型评审，评审提出的问题交回去修改，改完再评审。

像上面这样的小需求，从开始到可以验收，大约半小时。

「运行记录」里是每一次运行的过程，排查问题时用得上。

3. 回答提问

遇到需求里没有说清的事，例如方案有两种取法，调度 Agent 会把任务移到「阻塞中」，写清要你决定什么。你会在「我的任务」最前面看到它，打开后在“需要你”卡片里点「回复」，写下决定。调度 Agent 收到回复后接着安排。

需求写得清楚，这一步可能不会出现。

还没有连接 CI 时，这一步会出现：PR 没有检查结果，调度 Agent 会问你，是先补上 CI，还是不经过 CI，凭交付报告和截图验收。试运行时可以回复“这次不接 CI，我看交付报告和截图验收，确认后自己合并”，它就会把任务交给你验收。正式使用前，记得 连接 CI。

4. 验收

PR 通过评审和检查后，任务进入「待验收」，「我的任务」的“等你处理”里会出现它。

1. 打开任务。“需要你”卡片写明要你验收什么，下面是交付报告：原来的情况、改了什么、怎么验证的、遗留问题和建议，最后是验收标准和截图。
2. 点「看改动」，查看 PR。
3. 连接了 CI 时，在任务页打开预览，用初始管理员登录，按验收标准试一遍。
4. 结果符合预期，点「合并」。确认框里写着合并方式（例如压缩合并到 main）、提交标题，以及合并后任务会进入「已完成」，确认即可。没有检查结果时，按钮是「仍然合并」，可以填写合并的原因，Studio 会把这次合并记在 PR 和任务动态里。
5. 有地方不对，点「退回修改」，写清哪里要改。调度 Agent 会安排修改，改完再交给你。

完成的标志任务「已完成」，代码仓库的默认分支上有了这次的改动。连接了 CI 时，改动部署到预发布环境，任务上标出它已经部署到的环境。

常见问题

任务一直没有开始。 看任务页的「现在」一行，会写明在等什么：没有在线的运行环境、并发已满，或者这个 Agent 只在别人的个人运行环境上。排队超过 24 小时没有运行环境领取，这次运行会失败，你会收到可以重试的通知。

“初始化项目”还没完成。 项目里新建的任务都要等它完成后才开始。

Agent 说截图没有做成。 运行环境上缺少浏览器，见 接入共享运行环境 的准备。

走通之后，邀请成员。