任务执行、暂停与归档
任务实施应持续到必要验证完成,或遇到明确阻塞、用户暂停。检查与归档分开:智能体可以完成验证后汇报并保持任务开放,收到归档要求后再结束任务。
常用操作
以下是模型工具,通常由智能体根据用户指令调用。
| 工具 | 作用 |
|---|---|
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 支持以下参数:
{
"outcome": "改动已在原环境提交并上线,本机未验证",
"disposition": "external",
"archiveReason": "原环境不可用,用户确认无需继续本地开发"
}disposition 支持 external、abandoned、transferred,须真实交互确认。此路径不执行提交、测试、知识更新或领域完成门禁;保留任务身份和历史检查,收据为 unverified 并附归档原因,上报 task_finished 携带 archivalDisposition。旧收据保存至 quality/history,失败不会被改写为通过。正常完成路径仍检查当前任务提交和验证状态。
新验证记录比较源码内容、输入路径和影响面;仅 Git 提交导致的元数据变化不要求重跑,实际内容、质量策略或适用范围变化仍使证据失效。旧记录继续按原规则校验。