Studio 快速开始
本页面面向准备推进真实项目的用户。目标是在一个小需求里完成 Studio 的第一次成功:从 idea 生成确认过的需求报告和标准任务包,执行一个低风险任务,看到可复核证据,并明确验收或回修。
准备条件
- 已经完成 Studio 开通与项目准备,页面中的 Studio Access 和工作区为 ready。
- 至少有一个清楚的小需求。
- 知道谁负责确认需求、验收结果和风险。
1. 初始化工作区并选模式
在项目的 Studio 页面查看三种模式 readiness。第一次建议先用 planning_assistant;需要验证执行闭环时,再选择一个已就绪的 local_host_execution 节点。没有节点时先完成规划,按页面的“绑定 Host 和执行节点”步骤处理,不要直接尝试入队。
2. 创建项目空间
先填写最小项目说明:
项目目标:
目标用户:
第一版范围:
明确不做:
当前风险:
验收方式:3. 录入 idea 并完成需求确认
需求可以来自:
- Project Clinic 的问诊结果。
- Prompt Hub 的任务输入。
- Seed 或 Lite 整理出的本地项目说明。
- 人工写好的需求摘要。
录入后逐项回答问题,再对判断项执行确认、驳回或“需要补充”。只要仍有未确认事项,需求报告和任务包就不会被当成可执行事实。修改上游回答后,旧导出会标记 stale,需要明确重新生成。
4. 生成报告和标准任务包
建议第一个工作项足够小:
工作项标题:
目标:
范围:
AI 可辅助内容:
必须人工确认内容:
验收标准:
验证方式:
风险:确认报告后生成任务包草案,预览任务、范围、风险、证据计划和验收标准。导出后确认页面显示托管 Artifact、版本和 sha256;重复导出、转 MAWflow PM 或保存私有 Prompt Case 应保持幂等。
5. 受控执行并处理中断
选择本地 Host 或 Controlled Runner,阅读 mode、policy、node、risk 和 blocker,填写确认理由后再入队。执行中可以:
人工接管:保留当前 trace 和历史,把状态转为waiting_human。恢复执行:补齐信息后在同一 execution、ActionRun 和 Dispatch 上重新入队。重试失败步骤:保留旧失败记录和 attempt 信息,不创建第二条执行主账本。取消执行:停止后续处理,但不会自动回滚已经产生的工作树、文件或 Artifact。
页面刷新后以服务端 execution projection 恢复状态,不以浏览器本地状态伪造完成。
6. 检查证据并验收
执行完成后,至少记录:
- 变更摘要。
- 检查结果。
- 验收结论。
- 未验证原因。
- 风险和下一步。
Studio 的验收门要求同时存在 verification_summary 和至少一个状态就绪的 Artifact 引用。缺任一项时“验收通过”不可用,只能补证据或发起回修。门禁满足后,由有权限的人员填写理由执行验收,再归档交付记录。
7. 决定下一步
| 结果 | 下一步 |
|---|---|
| 需求仍不清楚 | 回到 Project Clinic 或 Prompt Hub。 |
| 本地项目边界不清楚 | 回到 Lite / 本地产品工作台整理。 |
| 工作项完成且风险低 | 继续下一个工作项。 |
| 交付证据需要复核 | 进入 Audit Center。 |
| 涉及团队权限或审批 | 评估 Enterprise。 |
自测检查点
- 无 entitlement、无工作区、无 Credits、无 Host/Node 时,页面分别显示准确的 blocker 或 warning。
- Planning Assistant 不执行代码;Local Host 和 Controlled Runner 的门禁不同。
- 接管、恢复、重试和取消后,execution key、trace 和旧历史仍可追溯。
- 缺 Verification 或 Artifact 时不能验收;补齐后可以验收和归档。
- 页面和 API 不显示原始提示词或输出、完整源码、本机绝对路径或敏感凭据。
下一步
继续阅读 Studio 新手路径,用“博客搜索”案例练习完整项目闭环。
