学习 Cue · 基于任务的教程

使用 Cue 语音与 Claude Code 修复小缺陷

口头叙述能够保留你在使用应用时注意到的细节。下一步则是将这些叙述转化为切实可检查的小改动。

作者：Cue 产品团队 (English) · 更新于 。基于产品源码审查编写。练习与输出仅用于说明，并非录制的 Cue 实际运行记录。请以你安装版本中显示的控件为准。

快速解答

使用 Cue 记录症状，核对转写文本，并明确移交给正确代码仓库中的 Claude Code。就失败用例与允许的修改范围达成一致，随后检查补丁与实际测试输出。发布审批须保持独立。

需求：已配置 Dictation 的 Cue、已完成认证的 Claude Code 环境，以及包含可复现缺陷的废弃或已获授权项目。结果：具备修改前后验证依据且范围限定的补丁，而非口头请求就能自动发布可用软件的承诺。

第一次使用 Cue？ 设置 Dictation 语音输入 用于输入您说的话；若要提出任务请求，请 设置 Agent 模式。开始前，请核对安装版本的权限提示与快捷键。

选择输入方式

当缺陷说明来自其他应用时，可以用 Cue 收集。你可能正在浏览器中复现问题、阅读 Issue，或整理同事的笔记。趁细节还清楚时，把症状口述到临时笔记中，再核对文字，整理成一份可重复使用的简报交给 Claude Code。这种方式适合在编程任务开始前跨应用收集上下文。

如果项目和请求已经准备好，直接在 Claude Code 中继续即可。在现有会话里做简短修正时，可以直接键入或粘贴。Claude Code 也有原生语音输入：官方语音听写指南（英文）说明了 CLI 中的 /voice，需要 Claude.ai 账户和本地麦克风。请核对其环境与账户要求。这里不必使用 Cue；只有在需要收集、编辑或复用简报时，临时笔记才有帮助。

用 Cue Dictation 向外部应用输入

下文练习采用这种方式。Cue 将文字插入已聚焦的临时笔记或受支持的提示词输入框。你负责核对并发送文字，Claude Code 在自己的环境里完成编程。无需配置 Cue 连接器，笔记也不会自动传递其他应用的历史记录、文件或权限。

使用 Cue 内的 Claude 连接器

这是从 Cue 使用外部 Agent 的另一种方式。发送任务前，检查连接、登录状态、所选项目与权限，并确认这条路径使用的账户和计费方式。仅看到 Claude 选项，不代表它已经就绪。请按你安装版本中实际可用的控件操作。

为 Cue Agent 选择托管模型

你可以请 Cue Agent 将提供的症状整理成简报草稿，审核后再交接。为 Cue Agent 选择 Anthropic 模型不会启动 Claude Code，也不会授予它代码仓库访问权限。托管模型的使用资格与计费取决于你的 Cue 账户，与外部 Agent 的连接是两回事。

试做零计数练习：先用 Dictation 输入，再明确交接文字。先说出症状，在笔记中核对 zero、null 和 undefined，然后把 F-01 至 F-03 的来源材料交给 Claude Code。当你在自己的运行中获得原始失败断言、限定范围内的补丁，以及同一测试通过的结果时，练习才算完成。

从一处可验证的改动开始

本指南不仅局限于撰写缺陷报告简报：它还将阐明编码 Agent 获取报告后的应对步骤。请确保初次任务足够精简，以便清晰陈述错误结果、预期结果以及二者出现的条件。切勿将缺陷修复与界面重构、依赖升级或版本发布混在一起。

  1. 打开受影响的界面与一份临时便签。仅使用你有权共享的信息。聚焦便签的输入框，使用 Cue Settings 中显示的 Dictation 快捷键，确认开始录音并描述症状。使用配置的控件停止录音，等待处理完成，随后检查文本是否仅出现一次。
  2. 在发送前更正名称、数字及否定词。Dictation 仅负责捕获你的言语，并不赋予编辑代码仓库的权限。若要求 Cue Agent 梳理报告结构，请要求其生成草稿，并在缺少应用上下文时明确提供相关便签。
  3. 在目标项目中打开 Claude Code。确认工作目录、分支以及现有变更。粘贴已核对的简报，或在聚焦的提示词输入框中口述简短的后续内容。切勿将 Shell 命令直接口述输入终端提示符中。
  4. 在提议修改前，要求 Claude Code 先审查相关实现与测试。若其无法复现失败，请向其提供缺失的输入或环境细节，而非允许其随意猜测补丁。

本教程采用明确的文本移交方式。Cue 的可选外部 Agent 选择器需要独立的连接、身份验证和权限检查；界面上可见的 Claude 选项并不代表连接器处于工作状态。为 Cue 自身 Agent 选择 Anthropic 模型同样不等同于运行 Claude Code。在选定路径前，请核对Agent 与模型差异。其他工具中的现有对话不会自动随便签同步转移。

实践：在结果标签中保留零计数

以下虚构的 JavaScript 练习刻意设计得很简单。其任务是修复一个标签函数，而非修改 Cue 或你工作中所用的应用。请仅在新建的临时废弃文件夹中创建这些文件。运行测试需要 Node.js。代码示例为普通 JavaScript，并非 Cue 命令。

来源 F-01 — 预期行为：本练习的输入仅限非负整数，以及表示缺失值的 null 或 undefined。零是真实计数，必须显示 0 results；正整数计数仍使用原来的“数字加 results”格式。缺失值必须显示 No count。输入验证、单复数用词，以及其他输入类型或值的行为均不在本练习范围内；这里不为它们定义验证规则。

来源 F-02 — 初始实现，result-label.mjs：

export function resultLabel(count) {
  return count ? `${count} results` : 'No count';
}

来源 F-03 — 当前观察：调用 resultLabel(0) 会返回 No count。这是由所提供代码直接产生的，并非录制的 Cue 或 Claude Code 运行结果。本练习并不能判定导致你项目中其他缺陷的原因。

尝试对着你的临时便签说：“零条结果是一个真实数量，不是数量缺失。使用 F-01 至 F-03，只修复这一区别，仍将 null 和 undefined 视为缺失，并给出能捕捉原始缺陷的测试。不要发布任何内容。”检查转写后的便签是否仍正确保留了 零、null 与 undefined。

在此处使用语音的目的，是在问题记忆犹新时捕捉意图。在拼写至关重要时，请直接从代码中复制标识符。你无需念出每一个标点符号，也无需大声朗读整个文件。

要求提供失败的回归测试，再获取最小化补丁

要求 Claude Code 添加包含此类公开行为检查的 result-label.test.mjs。在实际项目中，请使用其现有的测试运行器，而非强行套用本例的配置。

import assert from 'node:assert/strict';
import test from 'node:test';
import { resultLabel } from './result-label.mjs';

test('zero is a count; only null or undefined is missing', () => {
  assert.equal(resultLabel(0), '0 results');
  assert.equal(resultLabel(null), 'No count');
  assert.equal(resultLabel(undefined), 'No count');
  assert.equal(resultLabel(3), '3 results');
});

运行 node --test result-label.test.mjs。针对 F-02，针对零的断言应当失败。缺少 Node 安装、导入错误或从未执行的测试，均不属于预期的回归失败。在修改实现之前，请保存实际输出。

该函数的候选替换方案为：

export function resultLabel(count) {
  return count === null || count === undefined ? 'No count' : `${count} results`;
}

请仅在废弃的练习环境中应用该候选方案。重新运行测试并检查修改后的函数。测试通过仅覆盖这四种输入；这并不证明所有可能的输入都有效，也不证明无关应用可以安全部署。

对于实际修复，应先要求提供失败的检查，批准限定范围的实现，随后要求相同的检查以及周边现有测试一并跑通。Anthropic 的官方最佳实践强调了可验证的工作，以及将探索与实现分离开来。我们的练习将这一理念应用于源自语音的任务；文档并未对 Cue 集成进行验证。

复制一份语音转修复的验收简报

在发送前请替换括号中的字段。请将参考来源置于任务指令下方，以防引用的内容被误判为执行命令的许可。

任务：在此代码仓库中修复下方描述的这单一行为。
工作位置：[确认的项目与分支]
来源：[已核对的症状、输入、预期输出、实际输出]
范围：[单一行为与受影响区域]
保留项：[不可改动的现有工作与行为]
首先审查当前 diff 并定位真实调用路径。
通过公开接口使用测试复现缺陷。
证明其失败是由该缺陷引起，而非环境配置错误。
在我批准范围后，做出最相关的最小修改。
重新运行该测试及相关的周边检查。
证据：实际命令、退出结果、相关输出及限定范围的 diff。
若遇阻，陈述缺失事实；不得通过削弱断言来通过测试。
不得提交、推送、部署、更改凭据或编辑无关文件。
返回剩余风险与简短移交说明。暂停并等待发布审批。

判定修复是否已可移交

  • 复现：最初针对零计数的检查因正当原因失败。若 Agent 报告“无法复现”，则该任务仍处于调查阶段。
  • 范围：该补丁区分了缺失与零，且未添加无关的格式化、验证逻辑或依赖项。审查每一个被修改的文件，包括在该任务之前发生的改动。
  • 证据：索取实际执行的命令及其输出。“测试理应通过”不等于实际运行。若环境限制阻碍了检查，请在移交说明中保留该限制。
  • 产品结果：函数测试并不能证明 UI 使用了该函数。在真实应用中，在单元测试或集成检查通过后，请重新走一遍用户可见的操作场景。
  • 发布状态：分别记录本地修改、提交、推送和部署状态。在人工批准下一步且代码仓库的发布检查通过之前，请保持生产环境不变。

本练习的移交说明示例如下：“提议的修改区分了零与缺失。预期覆盖：zero、null、undefined 和 3。实际测试状态：根据本次运行填写。其他输入与 UI 集成：未覆盖。”切勿用自信的成功陈述来掩盖最后一项不确定性。

在不掩盖失败的情况下进行恢复

测试在执行断言之前就已失败

解决环境或导入问题并重新运行。保留原始函数，直到你拥有一个能够执行到零计数断言并因该原因失败的测试为止。

Agent 改动的范围超出了我的要求

暂停操作，将 diff 与约定的范围进行比对。要求其解释每一处额外的改动。保留其他协作者的工作成果；不要盲目使用全局重置，也不要臆断取消操作会自动撤销编辑。

口述请求输入到了错误的输入框

停止录音，同时检查目标输入框与实际输入的输入框，仅移除误插入的内容。若你当前的 Cue 界面提供复制功能，可使用明确的复制粘贴方式进行移交。重试前请检查是否存在重复内容。

如需对补丁获取第二视角，请继续参考限定范围的 Codex 代码审查。对于来自录音的背景信息，请先构建关联来源的上下文数据包。

在 Cue 中体验

使用配置的快捷键，并在 Cue Settings 中确认当前启用的模式。可用的应用上下文与操作取决于权限、版本和账户。在提供机密材料前请阅读隐私政策 (English)；本指南并不承诺所有处理都在你的设备本地完成。

下载电脑版 Cue · 当前方案 (English)

需要帮助或发现错误？联系 Cue 支持 (English)或发送邮件至 eli@sophoninc.com。请附上你的 Cue 版本、平台、模式以及脱敏示例。切勿发送密码、令牌或私密会议资料。