interview-mirror

Interview Mirror

面向求职者的开源面试复盘 Skill / Plugin，支持 Codex、Claude Code 和 OpenCode。

English README

Interview Mirror 会把简历、岗位描述、公司信息、面试录音或面试文字记录，整理成一份可追溯、有证据、能直接用于下一轮准备的面试复盘报告。它适合在真实面试后快速回答三个问题：我哪里表现好，哪里暴露了风险，下一步应该怎么练。

适合谁使用

• 刚结束面试，想系统复盘表达、项目讲解、技术深度和岗位匹配度的候选人。
• 正在准备下一轮面试，想把上一轮反馈转成具体练习计划的求职者。
• 使用 Codex、Claude Code、OpenCode 等 agent 工具管理个人面试材料的用户。
• 希望在本地优先处理简历、录音和转写稿，不希望默认上传隐私材料的用户。

它能做什么

• 读取简历、JD、公司信息、面试录音或面试记录。
• 本地优先解析 .pdf、.docx、.txt、.md 文档。
• 本地优先转写 .mp3、.m4a、.wav、.mp4 音视频文件。
• 规范化 面试官：... / 候选人：... 或 Interviewer: ... / Candidate: ... 格式的对话记录。
• 输出总体判断、亮点、短板、证据引用、JD 匹配度、回答改写建议和 7/14/30 天提升计划。
• 在缺少简历、JD、录音或转写稿时继续分析，但会标注缺失材料和置信度。

安装

Interview Mirror 目前通过 GitHub 仓库分发。插件和 skill 的安装名统一为 interview-mirror。

Codex

添加 marketplace：

codex plugin marketplace add 2Wren/Interview-Mirror

然后在 Codex 的 /plugins 中安装 interview-mirror。安装完成后，新开一个 thread 即可调用：

Use $interview-mirror to review my interview.

Claude Code

/plugin marketplace add 2Wren/Interview-Mirror
/plugin install interview-mirror@interview-mirror

也可以使用 Git URL：

/plugin marketplace add https://github.com/2Wren/Interview-Mirror.git
/plugin install interview-mirror@interview-mirror

OpenCode / 通用 Agent Skills

git clone https://github.com/2Wren/Interview-Mirror.git
cd Interview-Mirror
python3 scripts/install-skill.py --target agents

这会把 skill 安装到：

~/.agents/skills/interview-mirror

如果你的工具支持直接读取 Agent Skills，也可以复制 canonical skill 目录：

plugins/interview-mirror/skills/interview-mirror

快速开始

准备以下材料中的任意组合即可开始。材料越完整，报告的证据链和建议会越准确。

• 简历：.pdf、.docx、.txt、.md
• JD：岗位描述文本或文档
• 公司信息：公司名、团队、业务线、面试轮次、候选岗位
• 面试录音或视频：.mp3、.m4a、.wav、.mp4
• 面试文字记录：面试官：... / 候选人：... 或 Interviewer: ... / Candidate: ...

示例：

Use $interview-mirror to analyze this interview.

Resume: ./private/resume.pdf
Job detail: ./private/jd.md
Company: ExampleCorp, backend platform team
Interview round: technical screen
Transcript: ./private/interview-notes.md

如果只有面试记录，也可以直接粘贴：

Use $interview-mirror to review this interview.

JD: Senior Backend Engineer, payments platform

面试官：请介绍一个你主导过的高并发项目。
候选人：我之前负责过订单服务的性能优化，主要做了缓存和异步化...

报告内容

默认报告会跟随用户使用的语言。中英混合素材中，如果用户用中文提问，报告会以中文为主，并保留关键英文原文。

报告通常包含：

• 总体判断和置信度
• 表现亮点与对应证据
• 主要短板、风险信号与对应证据
• 简历、JD、公司背景和面试表现之间的匹配分析
• 可以直接复用的回答改写建议
• 下一轮面试的追问预测
• 7 天、14 天、30 天提升计划
• 缺失材料、不确定性和不应过度解读的部分

Interview Mirror 不会编造面试中没有出现的内容。所有关键判断都应尽量绑定简历、JD、录音转写或面试记录中的证据。

本地处理与隐私

Interview Mirror 的默认策略是本地优先：

• 默认不上传简历、录音、转写稿或复盘报告。
• 默认不联网查询公司信息。
• 默认不使用云端语音识别或云端文档解析。
• 只有在用户明确要求补充最新公司背景、或明确同意使用云端语音识别/API 时，agent 才应该联网或调用外部服务。
• 仓库的 .gitignore 已默认忽略常见简历、录音、转写稿和输出报告路径，降低误提交隐私材料的风险。

建议把真实材料放在 private/、inputs/ 或类似目录下，并在提交前运行 git status 检查。

可选本地依赖

基础文本文件不需要额外依赖。解析 PDF、DOCX 或转写音频时，可以按需安装：

python3 -m pip install pypdf pdfplumber python-docx
brew install ffmpeg
python3 -m pip install faster-whisper

也可以使用 OpenAI Whisper 的本地实现：

python3 -m pip install openai-whisper

如果缺少依赖，辅助脚本会给出安装提示并停止，不会自动上传文件或生成假的转写内容。

本地辅助脚本

这些脚本位于 skill 内部，可由 agent 调用，也可以手动运行。

python3 plugins/interview-mirror/skills/interview-mirror/scripts/extract_document_text.py ./private/resume.pdf -o ./private/resume.txt
python3 plugins/interview-mirror/skills/interview-mirror/scripts/normalize_interview_record.py ./private/interview-notes.md -o ./private/transcript.md
python3 plugins/interview-mirror/skills/interview-mirror/scripts/transcribe_audio.py ./private/interview.m4a -o ./private/transcript.md

脚本用途：

• extract_document_text.py：从 PDF、DOCX、TXT、Markdown 中提取文本。
• normalize_interview_record.py：把面试记录整理成统一 speaker 格式。
• transcribe_audio.py：检测本地 ffmpeg、whisper 或 faster-whisper，并进行本地转写。

开发与校验

PYTHONPYCACHEPREFIX=/tmp/interview-mirror-pycache python3 -m py_compile scripts/install-skill.py plugins/interview-mirror/skills/interview-mirror/scripts/*.py

如果本机安装了 Codex 的系统 skill：

python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/interview-mirror/skills/interview-mirror
python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/interview-mirror

如果本机安装了 Claude Code：

claude plugin validate .
claude plugin validate plugins/interview-mirror

许可证

MIT