mcpField

voice-skill

github.com/founderjourney开发36 次安装
代码仓库

关于 voice-skill

这款 Skill 支持通过语音与 Claude 讨论已注册项目中的代码问题、评审和架构决策。它通过 Vapi 拨打或接听电话，为 Claude 提供项目上下文，并将通话记录保存为 Markdown。

主要功能

  1. 01发起或接听语音通话
  2. 02提供已注册项目上下文
  3. 03读取和搜索项目文件
  4. 04语音讨论代码与架构
  5. 05将通话记录保存为 Markdown

适用场景

  1. 01免手操作进行代码评审
  2. 02讨论和排查调试问题
  3. 03离开键盘时构思架构
  4. 04通过电话询问项目文件内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/founderjourney/claude-skills --skill voice-skill

安装后在 Claude Code 中输入/voice-skill确认已加载。

详细介绍

语音技能 - 与 Claude 讨论你的代码

启用与 Claude Opus 4.5 就你的项目进行语音对话。让 Claude 给你打电话，或直接致电 Claude，讨论问题、集思广益并获得实时代码审查。

何时使用此技能

  • 免提讨论复杂的代码问题
  • 集思广益，讨论架构决策
  • 获取语音代码审查
  • 在散步或通勤时讲解代码
  • 通过语音结对编程
  • 无需打字即可快速提问

工作原理

  1. Claude 给你打电话：由 Claude 发起外呼
  2. 你致电 Claude：拨打你的 Vapi 号码联系 Claude
  3. 实时上下文：通话期间，Claude 可以访问你的项目
  4. 转录文本：所有通话都会自动保存为 Markdown

设置

前提条件
  • Vapi 账户和 API 密钥
  • 电话号码（约 $2/月）
  • Node.js（用于 localtunnel）
  • Python 3.8+
1. 安装
pip install claude-code-voice-skill
2. 设置凭据
voice-skill setup

将提示输入：

  • Vapi API 密钥
  • 你的电话号码
  • 你的姓名（用于个性化问候）
3. 注册项目
cd /path/to/your/project
voice-skill register

为上下文采集项目快照。

4. 启动服务
voice-skill start

启动服务端和隧道。

命令

让 Claude 给你打电话
voice-skill call

Claude 会拨打你注册的号码，并用你的名字向你问候。

检查状态
voice-skill status

显示服务状态和活跃会话。

更新姓名
voice-skill config name "Your Name"
查看转录文本
ls ~/.voice-skill/transcripts/

通话期间 Claude 可以做什么

读取文件

“Claude，main.py 文件里有什么？” → Claude 会读取并讲解该文件

搜索代码

“你能找到处理身份验证的地方吗？” → Claude 会搜索并报告结果

检查 Git 状态

“我今天更改了哪些文件？” → Claude 会报告 git diff 摘要

审查代码

“审查我对 API 模块所做的更改” → Claude 会提供语音代码审查

集思广益

“我需要添加缓存——有哪些方案值得考虑？” → Claude 会讨论各种方案及其优缺点

对话示例

[Phone rings]

Claude: "Hey Alex! I see you're working on the user-service
project. What would you like to discuss?"

You: "I'm having trouble with the authentication middleware.
Can you take a look at auth.py?"

Claude: "Sure, let me read that... I see you're using JWT
tokens. The issue might be on line 45 where you're checking
the expiry. You're comparing timestamps in different formats..."

You: "Oh, that makes sense. What's the fix?"

Claude: "You should convert both to Unix timestamps before
comparing. I'd suggest using datetime.timestamp() on line 45..."

转录文本

通话会自动转录并保存：

# Call Transcript - 2025-01-12 10:30 AM

**Project:** user-service
**Duration:** 8 minutes

## Summary
Discussed JWT authentication bug in auth.py.
Identified timestamp comparison issue on line 45.

## Full Transcript

**Claude:** Hey Alex! I see you're working on...
**You:** I'm having trouble with...
...

配置

配置文件位置
~/.voice-skill/config.yaml
选项
user:
  name: "Your Name"
  phone: "+1234567890"

vapi:
  api_key: "your-key"
  phone_number: "+1987654321"

preferences:
  greeting_style: casual  # casual, professional
  auto_transcript: true
  transcript_dir: ~/.voice-skill/transcripts

语音提供商选项

此技能支持不同的语音提供商：

  • Vapi 默认语音
  • ElevenLabs 集成
  • 自定义语音配置

安全性

  • API 密钥存储在本地
  • 通话通过 Vapi 加密
  • 转录文本仅存储在本地
  • 不会向第三方发送数据（Vapi 除外）

故障排除

“连接失败”
  • 检查互联网连接
  • 确认 Vapi API 密钥
  • 使用 voice-skill start 重启
“找不到项目”
  • 在项目目录中运行 voice-skill register
“无法接通”
  • 确认电话号码格式（+国家代码）
  • 检查 Vapi 账户余额

使用场景

  • 代码审查：查看代码时获取语音反馈
  • 调试：通过交谈梳理问题
  • 架构：讨论设计决策
  • 学习：讲解代码概念
  • 无障碍：免提编码辅助

致谢

由 abracadabra50 创建。采用 MIT 许可证。

评论

支持 Markdown