成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

语音免提调试代码

语音驱动编码 Agent 查错改代码,适合走路带娃时排障;只本地预览,不擅自远程推送。

飞书DeepSeekClaudeChatGPT🛠️ 开发者工具

场景说明

开发者有时双手被占——走路、带娃或做饭——却仍想继续排查报错、试小补丁。通过语音转写把「打开某文件、解释栈、试某改法」交给编码 Agent,在本地仓库查日志、提出修复建议并生成可审 diff;也可用飞书语音消息作入口,回复文字 diff 摘要。区别于同会话测本地 Web 与 Sentry 开修复 PR:本条强调「语音免提交互调试」,不是监控告警闭环或浏览器测站。硬约束:默认只在本地或特性分支改动,禁止擅自 push/force 远程或覆盖主分支;生产密钥不得读入语音会话;涉及删库、迁移与权限变更必须二次口头确认口令后再执行;语音原文默认本地可删,不上传公开频道。

案例叙事

01他们做了什么

yberreby.com(@yberreby)文《Hands-Free Claude Code with the Agent SDK》记述个人项目 Yad:本地 VAD/STT/TTS 守护进程经 UDS/Tailscale 与自定义 Agent SDK 环路对接 Claude Code 能力(工具、沙箱、会话恢复等),用耳机静音键在「对助手说话 / 待机」间切换;转写文本驱动查代码、读仓库与子代理,并以短句语音回述进度。作者强调非产品、自用迭代,并自述用量与「半日跑通原型」等个人体验。公开文未给出相对键盘调试的缺陷修复率或事故下降等可外推量化。

国内落地收成「飞书语音消息或本地 STT 入口 → 口述路径+报错首行+期望 → 编码 Agent 本地/特性分支出可审 diff 摘要 → 人确认后再提交;危险操作需二次口令」。硬约束:默认不擅自 push/force 或覆盖主分支;语音会话禁止读入或朗读生产密钥、Token、证书与 .env;删库/迁移/权限变更须二次口头确认;语音原文默认本地可删,不上传公开频道。

02实际效果

  • 源未披露相对键盘调试的缺陷修复率、误听导致事故率或省时量化;公开文侧重「本地语音栈+Agent SDK 免提交互」叙事。
  • 作者自述:重度 Claude Code 用量与自建 Yad 半日原型等个人体验(文中数字为作者统计,非我方实测,不可外推为你的账单或效率承诺)。
  • 开发者可把「双手被占仍想排障」收成飞书/本地可审的 diff 摘要;是否提交、是否推远程仍须人确认。

03值得知道

  • 公开源为个人自用实验,勿把「语音已回复」写成已合并主分支或已部署生产。
  • 硬约束:语音勿泄露密钥/生产凭据;禁止擅自 push/force;危险操作二次口令;语音原文勿上传公开频道。
  • 嘈杂环境与误听易触发危险工具调用;默认只写本地/特性分支,并关闭生产密钥读取权限。

04可复制提示词

语音调试 diff 摘要

你是语音免提调试助手。根据口述转写(文件路径、报错首行、期望行为)与只读代码/日志摘要,用中文给出排查假设、建议补丁要点与可审 diff 说明。禁止要求用户在对话中粘贴或朗读 API 密钥、生产 Token、证书或完整 .env;禁止建议未确认的 push/force、覆盖主分支、删库或迁移;涉及危险操作须提示「需二次口令确认」。文首加「【本地/特性分支草稿·勿泄露密钥·勿擅自推远程】」。

输出:
## 问题复述(基于转写)
## 排查假设
## 建议改动要点(非直接执行)
## 待人口令确认的危险项
## 非目标(不读密钥、不擅自 push)

输入:
{{voice_debug_brief}}

飞书语音调试核对卡

把拟执行调试步骤压成飞书核对卡(≤180 字):是否仅本地/特性分支、是否含密钥朗读、是否将 push/force 或迁移。必须出现「勿泄露密钥|本地可审|勿擅自推远程」。不要回显任何密钥片段。

步骤摘要:
{{voice_debug_digest}}

怎么做

  1. 选定仓库与语音入口,约定仅本地/特性分支可写
  2. 口述报错与意图;Agent 查代码、给修复建议与 diff
  3. 人确认后再提交;系统不擅自 push/force、不碰生产密钥

实用提示

  • 口述先报「文件路径+报错首行」,再讲期望行为,歧义更少
  • 危险操作设唤醒口令(如「确认迁移」),避免误听执行
#语音调试#免提编程#本地diff#编码Agent#不擅自推送