Skip to content

任务执行、暂停与归档 ​

文档导航 · 路由与授权

任务实施应持续到必要验证完成,或遇到明确阻塞、用户暂停。检查与归档分开:智能体可以完成验证后汇报并保持任务开放,收到归档要求后再结束任务。

常用操作 ​

以下是模型工具,通常由智能体根据用户指令调用。

工具作用
wenext_continue({taskId?})恢复任务和会话上下文
wenext_enter_node({node: "implement"})校验当前路由、产物与实施授权
wenext_check({checks?})进入检查、执行适用命令并验证证据,不归档
wenext_handoff({action: "save", notes, evidence?, stop?})保存恢复点;只有明确阻塞或用户暂停才提供 stop
wenext_commit({action: "status"})查看当前任务待提交文件
wenext_commit({action: "commit", message, files})展示精确提交内容,经人工确认后提交
wenext_finish(...)用户要求归档后校验完成条件,完成并归档

stop 的格式为 {reason: "blocked" | "user_requested", detail: string},说明具体阻塞或暂停依据。普通 handoff 只是恢复点,不代表任务结束。已记录的 stop 在诊断 Shell 调用、状态读取和普通交接更新后仍有效,重启也可恢复。新用户回合重新判断执行意图;wenext_continue 不证明外部条件已经恢复,条件变化后可主动重新检查。显式继续会解除用户主动暂停。

实施与验证 ​

进入实施、显式继续、原生写入或检查会形成当前宿主的执行意图。已授权范围内修复检查失败,无需重新批准同一方案;源码未变但环境修好也可再次调用 wenext_check。

检查使用完成互斥锁、子任务收束和 beforeFinish 验证链,但不执行最终状态转换、知识沉淀或 afterFinish。通过后返回的成功只覆盖自动化检查,智能体仍需对照 PRD 与正式方案核对验收。零检查保持未验证,详见质量检查。

后续源码、正式方案、范围或质量证据变化,会使旧检查不能作为完成依据;普通会话游标、交接或更新时间改变本身不使结果过期。

验收范围 ​

在现有方案的验收段落写清目标、必需/建议/待确认、适用范围或平台、验证方式及依据。简单任务可直接用几句话,复杂任务可用表格,无需新增配置或逐项审批。

仓库规则及技能定义领域要求,方案明确本任务的适用条件,插件提供执行事实。必需项缺证据不能通过;建议项缺失不自动阻断;待确认项先确定适用范围。不能仅因修改 UI 就要求真实登录、所有集成场景或全部平台,也不能因环境缺失降低已有必需检查。自动化结果与人工确认分别记录,人工确认只覆盖用户明确说明的任务和范围,不能推定所有平台都通过。

提前结束与暂停 ​

正常模型结束时,若当前实施尚未形成有效验证且没有明确阻塞,宿主通过 SDK agent_before_settle 请求继续,不伪造用户消息。成功 write/edit 重置连续纠正计数;连续两次纠正仍无有效进展,第三次显示执行停滞,避免无限循环。

以下情况不自动续跑:用户取消、SDK 错误、待处理输入、明确暂停或其他更优先的 continuation。空闲时的新状态问答不会因为旧任务强行开启实施;执行中的状态追问保留原工作意图。切换任务或会话不会继承旧意图,启动也不自动重放历史命令。

本次请求完成和任务归档分别处理。受控提交成功、提交被取消或失败、归档失败后,可以汇报具体结果并结束当前回复,不因任务仍为 in_progress 再次泛化要求实施/检查。后续必要修复仍可继续;提交失败不会自动重试,更不会伪造归档成功。

任务目录中的 continuity/execution.json 保存一份最新执行断点,绑定任务、方案、当前源码、范围和质量配置指纹。恢复检查完成状态时还会重新验证原始质量证据;旧任务没有此断点时,也可从有效的原始质量证据恢复。该断点只用于避免无效续跑,不授予写入、提交、跳过检查或归档权限。无法恢复、输入变化或证据失效时,不把旧断点当作已完成依据。

这是执行调度机制,不是对模型语义理解或业务完成质量的证明。真实外部阻塞需如实记录,而不是反复发起相同操作。缺少环境或权限时先完成独立工作,再记录具体恢复条件。全仓基线失败保留证据,不自动授权修复无关模块。

完成与归档 ​

Git 仓库的任务改动必须先提交;无关未提交文件可保留。用户选择自行提交时任务保持开放,非 Git 目录或没有待提交改动无需创建空提交。详见任务提交。

用户要求归档后,wenext_finish 先处理显式要求保存的 Markdown 知识,再复核检查。证据完整有效时复用并记录 task_check_reused;缺失或过期时提示显式调用 wenext_check,归档不执行检查命令。知识更新影响受检输入时,先验证更新后的输入再归档;新增规范仍须提交。

正常完整任务需要 outcome、check 节点、有效授权和适用检查的真实收据。checkEvidence、specDecision、workspaceNote 是可选补充,不再强制重复记录。无检查声明时如实记为未验证。失败或阻塞归档需要满足失败关闭的条件,不能改写为成功。

完成状态和待归档标记先落盘,最终工具结果及回复写入原始会话后再释放写者并移动目录。恢复点、摘要或模型说“完成”均不能直接设置任务完成。中断的待归档操作由后续启动恢复。

常见结果 ​

情况行为
实施中保存普通交接后提前结束尝试继续执行
用户取消、错误或明确暂停保留任务和断点
检查失败保留失败事实,可在原范围修复重跑
检查通过后汇报任务保持开放
检查后源码或正式方案变化重新核验,不能使用过期成功结果
用户要求归档且证据有效、任务改动已提交复用检查并归档
任务还有未提交改动拒绝完成,保留任务和文件
连续纠正无进展显示停滞,不伪装已完成

外部完成、放弃或移交 ​

用户明确要求收纳任务时,wenext_finish 支持以下参数:

json
{
  "outcome": "改动已在原环境提交并上线,本机未验证",
  "disposition": "external",
  "archiveReason": "原环境不可用,用户确认无需继续本地开发"
}

disposition 支持 external、abandoned、transferred,须真实交互确认。此路径不执行提交、测试、知识更新或领域完成门禁;保留任务身份和历史检查,收据为 unverified 并附归档原因,上报 task_finished 携带 archivalDisposition。旧收据保存至 quality/history,失败不会被改写为通过。正常完成路径仍检查当前任务提交和验证状态。

新验证记录比较源码内容、输入路径和影响面;仅 Git 提交导致的元数据变化不要求重跑,实际内容、质量策略或适用范围变化仍使证据失效。旧记录继续按原规则校验。