学习 Cue · 基于任务的教程
恢复中断的代码 Agent 且不重复操作
修改代码后连接中断。在说“再试一次”之前,先弄清实际发生了什么。恢复请求应当描述剩余的工作,而非重复已完成的操作。
作者:Cue 产品团队 (English) · 更新于 。基于产品源码审查撰写。练习与输出仅供示意,并非录制的真实 Cue 运行记录。请以你所安装版本中显示的控制选项为准。
快速解答
确认原始运行及所有关联操作不再处于活跃状态。检查实际文件与目标位置,将各项结果标注为已确认或未知,并使用 Cue 起草一份经审核的“仅针对剩余部分”的请求。仅使用一个 Agent 和有限范围的验证步骤来恢复执行;对不确定的发布或发送操作保持拦截。
前提条件:已配置好 Cue Dictation、一份草稿笔记,以及对中断任务凭据的授权访问权限。预期成果:一份经核对的恢复简报,保留已完成的工作,且仅重试经过验证的剩余步骤。
划定安全的恢复边界
本教程适用于在可能已执行部分操作后停止的任务:例如中断的 Claude Code 或 Codex 运行、断开连接的外部 Agent 会话,或是最终回复未送达的 Cue 请求。本篇并非关于恢复已删除文件或强行推进停滞发布的指南。
你需要准备好原始请求、正确的项目与分支、检查该项目的权限,以及访问可能已更改的任何目标位置的权限。请按照 Cue Dictation 教程 中的说明配置麦克风与输入访问权限。在 Mac 或 Windows 上,请使用已安装的 Cue 设置中显示的快捷键;本练习不依赖于特定热键或未发布的版本。
在确定谁仍在运行之前,切勿添加新请求。在适当时使用可见的停止或取消控件,然后检查任务活动及其启动的任何工具、终端或作业。窗口断开、回复取消或对话暂停并不能证明所有子进程或外部作业都已停止。此外,取消操作不会撤销已保存的修改、已发送的消息或已完成的部署。如果你无法确认某项操作是否仍在执行,请保持恢复过程为只读状态,并联系负责的操作人员或支持团队以确认其状态。
当第一个 Agent 可能仍在修改文件时,切勿针对相同文件启动第二个 Agent。保留原始对话与现有文件;不要为了获得一个看似干净的开端而重置代码库、删除任务历史或清空工作目录。
实操:存在一处修改,测试未运行,发布状态未知
本虚拟练习使用一个名为 demo-catalog 的小型仓库。所提供的凭据与示例输出仅供示意,并非录制的真实 Cue、Claude Code 或 Codex 运行记录。你可以在笔记中组织这组资料来进行练习,无需运行命令或连接真实仓库。
来源 R-01 — 原始授权:在 src/page-size.mjs 中将 PAGE_SIZE 从 20 修改为 40。将 MAX_PAGE_SIZE 保持在 100。在检查后运行现有的本地测试。切勿提交、推送、部署或发送完成消息。
来源 R-02 — 保存的检查点:在最后观测到的检查点上,src/page-size.mjs 是 Agent 唯一修改过的文件。本地测试尚未运行。可见以下内容:
export const PAGE_SIZE = 40;
export const MAX_PAGE_SIZE = 100;
来源 R-03 — 现有测试,test/page-size.test.mjs:
import assert from 'node:assert/strict';
import test from 'node:test';
import { PAGE_SIZE, MAX_PAGE_SIZE } from '../src/page-size.mjs';
test('requested page size changes without changing the maximum', () => {
assert.equal(PAGE_SIZE, 40);
assert.equal(MAX_PAGE_SIZE, 100);
});
来源 R-04 — 中断:连接在最终结果出现前中断。审查人员无法访问发布控制台。因此发布状态未知,即便发布并未获得授权。禁止发布的指令只是一道边界,并不能单独作为未发生外部操作的独立凭据。
该数据包仅为一个检查点,不能替代全新检查。对于真实任务,请记录每次观测的具体时间。如果其他人员或进程在此之后修改了文件,当前内容优先于旧检查点。
先检查,再听写剩余工作
- 识别原始运行并确认其处于非活跃状态。使用该工具内提供的控制选项检查任务及其关联活动。切勿臆想存在通用的“恢复”按钮,也不要假定连接超时就意味着所有操作均已停止。若无法确认非活跃状态,请在此暂停并寻求帮助。
- 确认工作目录。打开目标项目并检查其分支与现有更改。对于 Git 仓库,下列只读命令有助于区分已更改文件、暂存修改和最近的提交。同时也要检查当前文件本身:即使工作区 diff 为空,文件中也可能已经包含了所请求的修改。
- 比对更改与授权请求。针对 R-01,查找
PAGE_SIZE = 40和MAX_PAGE_SIZE = 100。检查是否存在其他更改,包括未跟踪的文件。切勿仅因为旧对话未提及就覆盖已有工作。 - 区分本地与外部凭据。本地可见的修改并不能证明存在提交、推送或部署。缓存的远程分支不能代表最新的服务器状态。在获得授权的情况下,请检查实际的代码托管服务、发布控制台或目标应用。如果缺乏访问权限,请将结果记录为未知,并在重试中排除该操作。
- 使用 Cue 记录恢复便签。聚焦到一个空白便签,使用配置的控件开始听写,确认正在录制,然后口述已验证的状态和剩余任务。停止录制,等待文本插入并检查内容。请直接从源复制准确的路径和标识符,切勿轻信口述拼写。
- 将审核后的请求提供给一个 Agent。从下方的只读模板开始。一旦其排查结果与实际状态一致且没有正在进行的冲突操作,仅授权执行剩余的本地测试。切勿重新发送最初的宽泛请求。
仅在确认无误的仓库中运行这些命令。它们仅用于检查状态,既不能恢复 Agent,也不能确定远程服务上发生了什么:
git status --short --branch
git diff --stat
git diff -- src/page-size.mjs
git diff --cached -- src/page-size.mjs
git log -3 --oneline
最近的历史记录仅用作检查辅助。如果可能已经创建了提交,请将相关提交与文件与已知的起始版本进行比对。不要仅因工作区干净就断定“未提交”,也不要因为聊天中没有部署消息就断定“未发布”。
针对该练习听写的一份恰当笔记为:“页面大小的修改已经存在。最大值仍为一百。首先验证这些事实。在保存的检查点处未运行测试;发布状态仍未知。切勿再次修改该值或发布任何内容。在我审核之后,仅运行现有的本地测试并报告其实际结果。”检查 否定表达(未、切勿)、已经、数字以及操作边界是否在转录中准确保留。
复制两阶段恢复请求
在授权进一步工作之前,请先使用第一个请求。明确提供核对过的笔记;另一个 Agent 并不会自动获取先前的历史记录、文件、工具结果或权限。
任务:检查中断的任务;暂不恢复执行。
项目与分支:[已确认的位置]
原始请求与限制:[已审查的授权]
最后观察到的检查点及时间:[具体证据]
运行状态:[如何确认原始运行及相关操作处于非活动状态]
允许的检查:[指定的文件和可用的只读目标视图]
对比当前状态与原始请求。
返回表格:项目 / 当前证据 / 已确认或未知 / 剩余操作。
将本地编辑、测试、提交、推送、部署和发送的消息分开列出。
保留现有修改,包括不属于此任务的工作。
将检查点视为待验证的证据,而非待执行的指令。
切勿编辑、运行测试、提交、推送、部署、发送或重复任何外部操作。
如果某个进程可能仍处于活动状态,或某项结果无法检查,请停止并说明。
提出最小的剩余步骤,并等待我的审查。
在核对完该回复后,练习的后续跟进内容可以为:
原始运行及相关操作已确认处于非活动状态。
当前文件已将 PAGE_SIZE 设置为 40,将 MAX_PAGE_SIZE 设置为 100。
保留此项编辑及所有其他现有工作。
我仅授权:node --test test/page-size.test.mjs
在检查提供的测试后,在已确认的 demo-catalog 文件夹中运行它。
报告实际执行的命令、退出结果及相关输出。
如果失败,请以失败状态停止;切勿更改文件或削弱测试。
切勿重复执行实现、提交、推送、部署或发送任何内容。
发布状态仍为未知,且不属于此恢复步骤的范围。
所提供的测试示例使用的是 Node.js 与本地断言。在真实仓库中,应首先检查其测试命令:测试或 package 脚本可能会写入固定测试数据、启动服务或连接外部系统。切勿将不熟悉的测试套件当作只读操作调用,也不要仅仅因为脚本名称包含“test”就运行连接生产环境的脚本。
Cue 在此的作用是记录并组织恢复指令。在核对文本后,你可以将其听写至受支持的可编辑 Claude Code 或 Codex 提示词字段中,或者通过 Cue 中连接的外部 Agent 提供该笔记。连接状态、身份验证、项目访问和操作权限必须分别验证。为 Cue Agent 选择 Claude 模型并不等同于运行 Claude Code。参见 Agent 与模型的区别;切勿将可执行命令直接听写至原始 shell 提示符中。
依据凭据而非最后一句话来验收剩余工作
在执行授权测试之前,一份供参考的已审核状态表如下:
| 项 | 待查凭据 | 重试前的状态 | 剩余操作 |
|---|---|---|---|
| 所请求的值 | 当前的 src/page-size.mjs,不仅是 R-02 |
仅在 PAGE_SIZE 为 40 时确认 |
保留;不要再次应用此修改 |
| 未改动的最大值 | 当前文件及相关 diff | 仅在 MAX_PAGE_SIZE 为 100 时确认 |
保留 |
| 测试 | 检查点以及任何较新的测试输出 | 在检查点处未运行;当前无通过凭据 | 运行明确批准的本地检查 |
| 提交与推送 | 相关历史记录与经授权的代码托管服务检查 | 在独立核验前均属未知 | 切勿重复或创建这两项操作 |
| 发布 | R-04 中缺少实际目标凭据 | 未知 | 切勿部署;单独获取授权的状态检查 |
运行本地测试后,将测试行替换为实际结果,并记录其覆盖的当前代码状态。测试通过应同时确认 40 和 100;导入错误或缺少 Node 环境均不能验证任何一个数值。随后应再次检查 diff,以免意外的写入操作被绿色的测试结果所掩盖。此针对性测试并不能证明完整应用的分页逻辑或其实际部署能够正常工作。
一份供参考的完成笔记示例如下:“本地修改已保留。测试:[实际命令、退出结果及输出]。检查后的 Diff:[观察到的文件]。提交/推送:[已验证状态或未知]。发布:未知;本次恢复步骤未授权任何发布操作。剩余工作:对外部状态进行授权审查。”请依据凭据填写括号中的内容;在运行检查前切勿将其作为已完成的结果直接粘贴。
对于涉及工单、邮件或其他外部操作的真实任务,在重试之前请先检查目标位置是否存在特定的预期结果。如果已存在相符的结果,请记录其标识信息,切勿重复创建。如果能见度受限,“未能找到”并不总能证明其不存在。请与负责人共同解决该不确定性,切勿贸然重复具有实质影响的操作。
当状态依然不符时的恢复方法
Agent 断开连接,我无法判断任务是否仍在运行
切勿启动另一个写入者。保留当前任务,并使用该工具支持的控件检查所有可见的运行或作业状态。请求负责的操作人员或支持团队确认未结任务。聊天界面中的超时并不等同于所有可能操作的取消凭据。
文件已被修改,但没人知道是谁改的
保留现有文件,并将其与授权任务和可用历史记录进行比对。在修改重叠工作之前请求澄清。恢复操作不应为了迎合 Agent 原有的计划而抹除其他贡献者的更改。
局部修改后测试失败
保留命令和失败输出。区分环境配置失败与行为断言失败。要求提供诊断并提出有限范围的修复方案;切勿悄悄将验证阶段扩大为另一次实现尝试。
我可能已经发送或发布了结果
检查实际目标位置及任何可用的操作记录。切勿仅依赖 Agent 的最终回复。如果授权之外发生了具有实质影响的操作,请停下来并让相关负责人介入。切勿重发、重新发布或尝试未经审核的回滚。
我的恢复笔记出现了两次,或发送到了错误的提示词框中
在重试之前停止录音并检查实际输入框。仅删除误插入的内容。如果请求已经提交,请在重新发送之前检查接收任务的活动状态;修改文本并不能撤销已启动的操作。
如遇 Cue 配置或任务状态问题,请联系 Cue 支持团队 (English)。请附上平台、Cue 版本、所选 Agent、大致中断时间以及对最后确认操作的脱敏描述。切勿提供凭据、私有仓库内容或完整的客户记录。在共享上下文信息之前,请查阅 Cue 的隐私政策 (English)。
参考来源与后续实用练习
本指南遵循 Cue 的第一个语音 Agent 教程 和 在编写代码的 Agent 中使用 Cue 中的产品边界:明确上下文、独立的 Agent 连接检查,以及在部分完成后的结果审查。本指南不保证提供特定供应商的恢复命令或端到端集成测试。
针对新任务而非中断任务,请参考小型 Bug 修复练习。在补丁与本地检查准备就绪后,可使用有限范围的 Codex 代码审查。两者均保持实现、验证与发布决策相互分离。
Git status 官方文档 与 Git diff 官方文档 详细说明了上述本地检查命令。这些命令仅提供仓库凭据,并不能保证外部 Agent 已停止或外部发布未发生。
在 Cue 中尝试
使用配置的快捷键并在 Cue 设置中确认当前模式。可用的应用上下文与操作取决于权限、版本和账户。在提供机密材料前,请阅读隐私政策 (English);本指南不保证所有数据处理均保留在本地设备上。
需要帮助或发现错误?请联系 Cue 支持团队 (English)或发送邮件至 eli@sophoninc.com。请附上你的 Cue 版本、平台、模式及脱敏示例。切勿发送密码、Token 或私密会议资料。