Skip to content
进入工作台

Studio 快速开始

本页面面向准备推进真实项目的用户。目标是在一个小需求里完成 Studio 的第一次成功:从 idea 生成确认过的需求报告和标准任务包,执行一个低风险任务,看到可复核证据,并明确验收或回修。

准备条件

  • 已经完成 Studio 开通与项目准备,页面中的 Studio Access 和工作区为 ready。
  • 至少有一个清楚的小需求。
  • 知道谁负责确认需求、验收结果和风险。

1. 初始化工作区并选模式

在项目的 Studio 页面查看三种模式 readiness。第一次建议先用 planning_assistant;需要验证执行闭环时,再选择一个已就绪的 local_host_execution 节点。没有节点时先完成规划,按页面的“绑定 Host 和执行节点”步骤处理,不要直接尝试入队。

2. 创建项目空间

先填写最小项目说明:

text
项目目标:
目标用户:
第一版范围:
明确不做:
当前风险:
验收方式:

3. 录入 idea 并完成需求确认

需求可以来自:

  • Project Clinic 的问诊结果。
  • Prompt Hub 的任务输入。
  • Seed 或 Lite 整理出的本地项目说明。
  • 人工写好的需求摘要。

录入后逐项回答问题,再对判断项执行确认、驳回或“需要补充”。只要仍有未确认事项,需求报告和任务包就不会被当成可执行事实。修改上游回答后,旧导出会标记 stale,需要明确重新生成。

4. 生成报告和标准任务包

建议第一个工作项足够小:

text
工作项标题:
目标:
范围:
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 新手路径,用“博客搜索”案例练习完整项目闭环。