阅读约 6 分钟

第一个任务

从提交需求到拿到变更请求的完整走查：预检做了什么、沙箱里发生了什么、产物如何交接、如何确认交付成功。

这一页走完一次真实任务。每一步都说明你应该看到什么，以及出现异常时从哪里查。

准备

开始之前确认三件事：模型网关已配置且可用，你的账号在当前工作范围有成员权限，你保存了目标 Git 服务的个人访问令牌。

任务创建页不会让你手输仓库地址。平台先列出你已配置个人令牌的 Git 服务，再由服务端使用你解密的令牌实时查询你有权访问的仓库。选中仓库后查询分支，并优先建议提供方返回的默认分支。

这意味着：如果令牌无效或没有仓库权限，任务会在预检阶段失败，而不是在执行到一半时失败。

创建任务采用资料先行的顺序，这是刻意的设计。

需求来源支持多行，可以共同组成同一份需求：Markdown 文档、Git 议题、企业文档链接、企业即时消息链接。每一行独立，切换来源类型只影响本行，调整其他行不会串改本行内容。

在线来源需要填写链接。平台在服务端使用当前用户凭据读取议题标题，并校验链接与已配置的连接器一致。浏览器不会直连提供方接口。

任务名称会自动填充以减少重复输入。名称按来源行顺序选择第一个可用标题：Markdown 提取首个不在代码围栏内的一级标题，缺失时使用文件名；议题通过提供方读取真实标题，失败时保留占位并继续创建流程。自动值只在你尚未手工编辑名称时随来源更新；一旦你输入了非空名称，后续来源变化不再覆盖它。

流程模式默认为智能编排。提交后由预检检索、评估并优先复用已有流程，无法适配时生成任务专属的临时流程。

高级用户可切换到使用已有流程，以紧凑选择器选择当前工作范围可见的已发布版本。选择后只展开该版本输入契约中不可推导的动态字段。

创建流程进入独立创作页面，不把长期资产编辑塞进任务表单。

提交后任务先被持久化并返回标识，随后进入用户可见的预检阶段。此时还没有创建任何沙箱资源。

预检按顺序完成这些工作：

预检期间你能看到流程检索、生成、风险与冻结进度。失败时任务保留结构化检查结果与修复入口，不会创建运行资源，也不会静默回退到更宽权限。

预检失败最常见的原因是：仓库或分支不可访问、个人令牌缺失或过期、所选流程声明的能力在你当前工作范围不可用。

预检通过后进入供给阶段，依次完成仓库克隆、需求物化、运行时准备与 Agent 启动。

任务详情保持左侧 Agent 会话与右侧证据栏的稳定两栏关系。右侧栏是单层状态机：默认完整展示依赖图，点击节点后整栏替换为该节点的概览，再在代码、产物、链路与 Agent 之间切换。详情顶部提供明确的返回流程入口。

节点详情按结论 → 契约 → 证据 → 原文的顺序渐进披露：

文件阅读器显示原始路径、字节大小、媒体类型与内容标识。文本按页读取并保持编码边界，二进制只提供原文件下载。

一个节点成功的条件是确定的，不依赖自然语言声明：

质量门禁是你在节点中声明的 Shell 命令，例如构建、测试或静态检查。运行器只在本次执行的独立工作树中执行，并按退出码判断结果。失败时会先把命令、退出码与受控输出送回当前 Agent 会话，在同一执行内做有限次数的修复重跑。

每个成功执行都会冻结自己的代码修订到独立引用。工作树释放后，仍能按该修订列出并分页读取代码。

交付节点的产物契约与全部上游门禁通过后，进入运行器的受控完成步骤：推送最终检查点分支，并按任务标识幂等地创建或解析变更请求。

真实提供方、编号、分支与地址写入该节点结果后，它才标记完成。该步骤使用的 Git 凭据对 Agent 会话、提示词、工具环境与产物始终不可见。

如果变更请求创建响应丢失，重试必须查询原变更请求，不能重复创建。同名分支缺少相同任务标记时会拒绝覆盖。

交付摘要聚合最终结果、测试与变更请求。它表达的是产物验证结果，不重复生命周期状态。

失败有很多种，处理方式不同。

执行层失败（网关超时、进程崩溃、命令超时、协议缺失）计入重试。优先恢复原会话，无法可靠恢复时创建新会话。

语义层返工处理下游确认的上游产物缺陷。返工始终创建新会话、新执行与新产物版本，并且返工目标必须是相关产物的合法生产节点，不能按执行顺序机械选择上一个节点。

终态失败的任务允许只重新执行一个失败节点。重跑不改写失败记录，而是把当前执行追加到历史后创建新的执行。已完成上游的产物与代码修订按冻结证据复用，不重跑。

模型返回空响应时，运行器按其类型分类并启动有限次数的恢复会话。耗尽后保留明确的节点失败，供你在更新模型或连接器后单独重跑，不会把空响应伪装成完成。

所有上限——每节点最大执行数、每目标最大返工数、总返工数、每次执行最大门禁修复数——由流程显式冻结，节点不能覆盖。任一上限触发后任务失败。