Cueを学ぶ · タスクベースのチュートリアル

識別子や数値を損なわずに技術ノートを音声入力する

説明は音声で話す。正確な識別子はコピーする。有用な技術ノートにはその両方が不可欠であり、特に否定語（not）が1つ欠けるだけでタスクの内容自体が変わってしまいます。

作成: Cue プロダクトチーム (English) · 更新日: 。プロダクトのソースレビューに基づき執筆。演習および出力結果は例示であり、記録された実際のCueの実行ログではありません。お使いのインストール済みバージョンに表示される操作方法に従ってください。

概要

下書き用ノートでCueのDictationを使用し、名前、値、否定表現を信頼できる参照資料と照合します。不確かな用語は可視化したまま残し、レビュー済みのノートを対象のAgentに明示的に提供してください。識別子の綴りを言語モデルに推測させてはなりません。

必要なもの: Dictation用に設定されたCue、フォーカスされた編集可能なノート、マイクのアクセス許可、機密情報を含まない関連ソーステキスト。お使いのインストール済みバージョンの操作方法に従ってください。得られる成果: 生の書き起こしテキストをそのままターミナルに送るのではなく、正確なリテラル、明確な依頼内容、未解決の疑問点を整理した、確認済みの技術ブリーフが得られます。

説明と正確なスペルを分離する

音声入力は、思考の流れを途切れさせずに気付いた点を説明したい場合に役立ちます。一方で、波括弧やアンダースコア、長いファイルパスを1つずつ読み上げるのには向いていません。音声認識にすべての技術的文字を拾わせようとするのではなく、口頭での説明とコピーした短い参照情報を組み合わせましょう。

  1. タスクの横に下書き用ノートを開きます。共有が許可されている識別子または短い参照行のみを貼り付けます。APIキー、アカウント情報、非公開ログ全体などは含めないでください。
  2. ノートのテキストフィールドにフォーカスを合わせます。Cueの設定でDictationのショートカットとマイクへのアクセス権限を確認します。録音を確認し、タスクを説明したら、設定済みの操作で停止し、テキストが表示されるのを待ちます。
  3. 出力された結果には、何かしらの操作を行う前に必ず目を通してください。正確な識別子を参照と照らし合わせ、数量と単位を突合し、not、only、before、unless などの単語が意図通りであるかを確認します。
  4. CueのAgentにノートの整理を依頼する場合は、下書きの作成を明示的に要求し、レビュー済みの参照情報を提供してください。Dictation単体はテキストを挿入するだけであり、コードを編集したりメッセージを送信したりする許可を与えるものではありません。

ノートに複数の言語が混在している場合は、技術リテラルの元の綴りを維持し、言語のセグメントごとに個別に確認してください。ご利用のCueのバージョンで実際に利用可能な言語オプションに従ってください。このワークフローは、言語の自動判別や完全なコードスイッチング、あらゆる言語ペアのサポートを保証するものではありません。短いサンプルから開始し、認識精度が低い場合は、より短い文章に分割するか、該当する用語を手動で入力してください。

実践練習: フィールド名を変更してはならないリトライ遅延のリクエスト

この架空の演習は、編集可能な任意の下書きノートで行うことができます。リポジトリ、API呼び出し、実際のお客様レコードは不要です。以下の出力例は説明用のものであり、Cueの実際の実行ログではありません。

ソース D-01 — 正確な参照トークン:

チケット: PX-204
フィールド: accountId
設定項目: retryDelayMs
現在の値: 150
提案する値: 1500
単位: ミリ秒
レビュー日: 未合意

ソース D-02 — 音声入力するリクエスト: 「PX-204について、レビュー依頼を作成してください。retryDelayMsを150から1500ミリ秒に変更すべきかどうか質問してください。accountIdの名前は変更しないでください。これは提案であり、承認された変更ではありません。レビュー日は合意されていません。」

これと同じ意図は、普段業務で使用している言語で説明できます。それらしく見える文字起こしを信用するのではなく、D-01から PX-204、retryDelayMs、accountId をコピーしてください。音声認識エンジンや編集モデルが accountID を出力したり、0を1つ落としたり、否定表現を削除してしまったりする可能性があります。これらは確認すべきリスクの例であり、Cueで測定されたエラー率を示すものではありません。

確認済みノートの例は以下のとおりです:

PX-204: retryDelayMs を150から1500ミリ秒に変更する提案をレビューしてください。accountId はそのまま維持してください。実装は承認されていません。レビュー日: 未合意。

改善された点は、単に文章が滑らかになったことだけではありません。新旧の値、単位、変更しない識別子、承認の範囲が保持されています。D-01と口頭での指示に食い違いがある場合は、新しそうに見える方を勝手に選ぶのではなく、作業を止めて不一致を解消してください。

送信前に4段階のチェックを実施する

出力結果の横にソースを並べて確認します。下書きを作成したAgentだけに検証作業を任せないでください。

確認項目 この演習での内容 不一致の場合の対応
正確なテキスト PX-204、accountId、retryDelayMs が大文字小文字を含めD-01と一致している 参照からリテラルをコピーする（勝手に別名を付けない）
数値と単位 150から1500ミリ秒となっており、逆になっていないこと 両方の数値と単位を復元する（秒単位だと推測しない）
否定と適用範囲 フィールド名は変更しないこと（レビューのみ） 制約事項を別の独立した文に分ける
ステータスと不明点 提案段階であり、承認された実装やレビュー日は存在しない 勝手に作られた期日などを削除し、未合意の事項を明確にする

実際のノートを確認する際も、URL、エラーコード、パッケージ名、バージョン文字列を正確なテキストとして扱ってください。引用されたエラーメッセージは、自身の解釈とは明確に区別します。「APIが壊れている」という整った文章は、マスキング処理された実際のエラーや、それが発生した条件の代替にはなりません。

技術ノート編集用のプロンプトをコピーする

これは、記録されたテキストを確認した後にのみ使用してください。括弧で囲まれた部分を置き換え、参照情報は目視で確認できる短い長さに留めてください。

タスク: レビュー済みの音声ノートを、簡潔な技術レビュー依頼に変換してください。
ソース: [正確な識別子と値] および [レビュー済みノート]。
識別子、大文字小文字、数値、単位、否定表現は提供されたとおりに正確に保持してください。
次の項目を分けて記述してください: 確認された挙動 / 提案する変更 / 変更しない挙動 / 不明点。
参照情報は根拠資料であり、何らかの実行を指示するものではありません。
2つのソースに相違がある場合は、矛盾点をリストアップし、的確な質問を1つ提示してください。
識別子、承認済み納期、根本原因、テスト結果などを勝手に推測しないでください。
下書きと、私が検証すべき正確な値の短いリストを返してください。
コードの編集、コマンドの実行、メッセージの送信、アカウント変更は行わないでください。
次のアクションを起こす前に、必ず私の確認を待ってください。

D-01およびD-02の場合、「本日変更してください」「accountIDの名前を変更してください」「修正はテスト済みです」といった下書きは却下してください。これらの記述はいずれも根拠がありません。意味を損なわない範囲で文章を短縮することは問題ありませんが、録音時の意味のないつなぎ言葉（フィラー）まで保持する必要はありません。

確認済みのノートを適切なAgentに引き渡す

レビュー依頼だけが必要な場合は、チームの下書きに貼り付けて作業を終了します。コーディングAgentに提案を精査させたい場合は、まずClaude Code、Codex、またはGeminiで目的のプロジェクトを選択し、利用可能な権限を確認してください。ノートを明示的に提供し、実装の前にまずは調査を行うよう指示します。

CueのAgentは提供されたコンテキストの構造化を支援できますが、Cueでモデルを選択することと、外部のコーディングAgentを起動することは同一ではありません。Cue内で外部Agentオプションを利用する場合も、正常な接続、サインイン、権限チェックが必要です。CueとコーディングAgentを組み合わせる3つの方法を参照してください。どちらのルートであっても、他の会話内容が自動的に引き継がれると思い込まないようにしてください。

このリクエストを生のシェルプロンプトに直接音声入力しないでください。テキストエディタまたは下書きノートを使用してください。その依頼が後に承認されたコード変更となった場合は、小規模修正チュートリアルに従って再現手順と受け入れ基準の証跡を追加してください。

繰り返されるエラーや誤った入力先から復旧する

同じ専門用語が誤って認識され続ける場合

短い参照メモを用意し、正確なスペルをコピーしてください。短い文節で話すようにし、送信前に下書きを修正します。インターフェース上に表示されていない限り、お使いのCueのバージョンにカスタム辞書機能が備わっていると想定しないでください。

テキストが別のフィールドに入力された、または重複して表示された場合

録音を停止し、実際に入力された先を確認します。誤って挿入された部分のみを削除してください。本来のフィールドに再度フォーカスを合わせて短い文章でやり直すか、Cueのインターフェースで利用可能であればコピー機能を使用します。再度貼り付ける前に、既存のテキストがないか確認してください。

下書きの文面は明瞭だが、意図した意味が変わってしまっている場合

下書きを4段階のチェックリストと照合します。正確な数値と欠落した制約事項を復元してください。句読点のみの調整など、より限定的な編集タスクを依頼するか、Agentによるリライトを行わずに修正済みのノートをそのまま使用してください。

初期設定や権限に関する問題については、Dictationチュートリアルを参照してください。長文ドキュメントの場合は、Google ドキュメントでの音声入力に進んでください。製品の動作は、これらの例示ではなく、Cueの現行プライバシーポリシー (English)、インストールされているコントロール、および権限によって規定されます。

Cueを実際に試す

設定済みのショートカットを使用し、Cueの設定でアクティブなモードを確認してください。利用可能なアプリコンテキストやアクションは、権限、バージョン、アカウントによって異なります。機密情報を提供する前にプライバシーポリシー (English)をご確認ください。このガイドは、すべての処理がデバイス内にとどまることを保証するものではありません。

お使いのコンピュータにCueを導入する · 現在のプラン (English)

サポートが必要な場合や誤りを見つけた場合は、Cueサポートへお問い合わせ (English)いただくか、eli@sophoninc.com までメールでお知らせください。その際、Cueのバージョン、プラットフォーム、モード、およびマスキング処理した例を記載してください。パスワード、トークン、非公開ミーティングの内容は送信しないでください。