MockInterview Agent
sereeein/MockInterview-Agent
Simulador de entrevista com IA que gera questões personalizadas e oferece feedback estruturado.
Ver no GitHubAgent de IA para simulação de entrevistas profissionais verticalizadas (PM, Dados, IA). Gera 12 questões personalizadas a partir do currículo, oferece avaliação com rubric, múltiplos questionamentos e mudanças de cenário para refinar respostas. Suporta 10 provedores (Claude, OpenAI, DeepSeek, Qwen, GLM, Moonshot, etc.) com arquitetura BYOK (Bring Your Own Key).
Instalação
npx convez-ai sereeein/MockInterview-Agent1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Preparação para entrevistas técnicas e comportamentais em posições específicas
- Avaliação de desempenho em respostas com múltiplos questionamentos e cenários
- Relatórios detalhados com análise de fraquezas e exemplos de respostas ideais
Veredito

Ferramenta polida com UX bem pensada (BYOK, testes de conexão, suporte a voz). Avaliação LLM-as-judge rigorosa (2.94/3 em relevância, 100% em taxa de acerto de follow-ups) e arquitetura pronta para produção. Excelente para candidatos que buscam preparação estruturada e iterativa.
README
A tradução para o português deste README ainda está na fila.
MockInterview Agent
垂直岗位 AI 面试演练 · 简历反向挖题 · 多轮追问 · 场景切换 UX。
Live: https://mockinterview-agent.vercel.app
Backend API: https://mockinterview-backend-production.up.railway.app(Swagger 在 /docs)
Repo: https://github.com/sereeein/MockInterview-Agent · Releases: v1.0 · v1.1
Status: v1.1 shipped (88 unit tests · 出题相关性 2.94/3 · 追问命中率 100% · 多组配置 · 连接测试 · 语音输入)
v1.1(2026-04-29)— BYOK UX 进化
v1.1 在 v1.0 的「服务器零持有 key」硬约束下,让 BYOK 体验从「能用」升级到「称手」:
- 多组配置保存与切换:每个用户可保存多组命名 provider config(含 ⭐ 默认标记),顶部 dropdown 一键切换;导出/导入 JSON 防 localStorage 丢失
- 连接测试:最小 token 验证 provider+model+key 可用 + JSON 输出能力;5 类错误精确分类(network / auth / rate_limit / json_format / unknown),带 HTTP status + provider 原始 message + 中性建议文案
- 语音输入:单题演练 + 模拟面试 textarea 右下角 🎙 按钮,浏览器原生 Web Speech API(zh-CN/zh-TW/en-US 可切),不支持的浏览器(Firefox / 非 HTTPS)按钮自动不渲染(优雅降级)
详见 v1.1 设计文档。
What it does
- 上传简历 PDF + 选岗位(PM / 数据 / AI / 其他)+ 可选 JD
- agent 反向挖出 12 道个性化面试题(5 类:项目深挖 / outcomes 追问 / JD 对齐 / 通用题 / 行为题)
- 单题 U-loop 演练:rubric 评分 + 多轮追问 + 场景切换让路("这个例子不够典型,要不你说说项目里类似的事?")
- 单题报告(雷达图 + 改进建议 + 范例答案)/ 整套面试报告(5 题串联 + 短板维度)
Architecture
- Backend: Python 3.12 + FastAPI + Anthropic SDK (Claude 4.7 Opus) + SQLModel + SQLite + pdfplumber
- Frontend: Next.js 16 (App Router) + TypeScript + shadcn/ui + Tailwind v4 + Recharts
- Agent: 手写状态机 + 单次 LLM structured output(每轮一次调用:评分 + 找最弱维度 + 生成追问 + 场景切换 / 提示模式)
- Eval: LLM-as-judge pipeline(relevance / drilling / baseline compare)
BYOK (Bring Your Own Key)
MockInterview Agent never uses a server-side API key. Each user supplies their own key via the in-app /setup page; key is stored in browser localStorage and forwarded as headers on every request.
Supported providers (10 total):
| Provider | Default model | 备注 |
|---|---|---|
| Anthropic Claude | claude-opus-4-7 | 推荐 —— prompt 在 Claude 上调优;prompt caching 节省 70%+ 成本 |
| OpenAI | gpt-4-turbo | OpenAI 官方 |
| DeepSeek | deepseek-chat | OpenAI-compat |
| 通义千问 (Qwen) | qwen-max | DashScope OpenAI-compat 模式 |
| 智谱 GLM | glm-4-plus | OpenAI-compat |
| Kimi (Moonshot) | moonshot-v1-32k | OpenAI-compat |
| 文心一言 | ernie-4.0-turbo-8k | 千帆 OpenAI-compat |
| 豆包 | doubao-pro-32k | 火山方舟 OpenAI-compat |
| Google Gemini | gemini-2.0-flash-exp | Gemini 原生 SDK |
| Custom | — | 任何 OpenAI-compat 端点 |
注:prompt 是按 Claude 调优的,跨家可能效果有差异。Anthropic 是默认推荐;其他 provider 用于"我已经有 X 家的 key"场景。
Eval results
评估报告位于 eval/reports/。运行步骤见 docs/deployment.md。
3 个核心指标 + 阈值:
- 出题相关性:≥ 2.2 / 3
- 追问命中率:≥ 70%
- vs 裸 Claude 盲评胜率:≥ 70%
注:eval 的 LLM-as-judge"裁判"固定用 Anthropic Claude(保证不同 provider 跑出的结果可对比);agent 本身可换任意支持的 provider 跑(通过 MOCK_PROVIDER env var)。简历金句汇总:docs/resume-bullets.md;BYOK 架构说明:docs/byok.md。
Local dev
# Backend
cd backend
env -u VIRTUAL_ENV uv sync
env -u VIRTUAL_ENV uv run uvicorn mockinterview.main:app --reload
# Frontend (in another terminal)
cd frontend
pnpm install
pnpm dev
打开 http://localhost:3000 → 第一次访问会跳到 /setup 引导你配置 API key(任意支持的 provider)→ 然后回到上传页。
Project journey
- 立项策略:
PROJECT.md - v1.0 设计文档:
docs/superpowers/specs/2026-04-27-mock-interview-agent-v1-design.md - v1.1 设计文档:
docs/superpowers/specs/2026-04-29-mock-interview-agent-v1.1-design.md - v1.0 实施 plan(~50 task):
plans/2026-04-27-mock-interview-agent-v1.md - 完整开发日志:
memory.md - 6 层学习指南(面试 defense 用):
docs/learning-guide.md - BYOK 架构说明 + v1.1 self-check:
docs/byok.md - 简历金句:
docs/resume-bullets.md - 部署 + 评估手册:
docs/deployment.md - 小红书 4 周冷启动模板:
docs/xiaohongshu/