greenroom
YunyueLi/greenroom
greenroom · 候场 — open-source interview prep workbench: 7 Claude skills (job intel, story bank, verbatim scripts, cross-round claim ledger, mock, debrief) + a local-first console. 面试准备开源工作台,核心是跨轮口径台账。
Instalação
npx convez-ai YunyueLi/greenroom1 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
README
A tradução para o português deste README ainda está na fila.
greenroom · 候场
An open-source interview preparation workbench. Give it your resume, a target company and the JD — eight Claude skills run the full pipeline: company and interviewer research, an experience bank mined from what you actually did, verbatim spoken scripts, industry reference reading, mock interviews and post-round debriefs. A quiet claim ledger keeps every number and statement consistent across rounds. Everything lives in one Markdown folder on your machine, read by a local-first single-file console; nothing is uploaded anywhere.
The greenroom is where performers wait and prepare before going on stage. 候场:上台之前,把每一句话备好、对好。
Why it exists. An interview process is a months-long consistency game: your resume, the recruiter call, HR screening, several interviewer rounds and a background check all get cross-referenced — and employers already run tooling that compares what you said in round 1 against round 3. Greenroom prepares the whole package from real material, and keeps what you say traceable to one canonical version per fact. Not to help you lie — the opposite: so you never need to improvise a number again.
Install
# Claude Code (plugin, versioned updates)
/plugin marketplace add YunyueLi/greenroom
/plugin install greenroom@greenroom
# or any agent that supports skills
npx skills add YunyueLi/greenroom
Manual: copy skills/* into ~/.claude/skills/.
Quick start
- Tell Claude: 「我要面试了,这是我的简历,目标是 X 公司的 Y 岗位,JD 如下」 — the
greenroomskill runs the pipeline end to end: workspace init → research → experience bank → industry brief → verbatim scripts. - Run
python3 serve.py ~/my-greenroom— the console opens in your browser with the workspace auto-connected (no folder picking). Or openapp/greenroom.htmldirectly and drag the folder in; press the demo button to see a complete fictional example. - Before the round:
mock-interview. Within 24h after:debrief— what you said gets recorded and constrains the next round. - During the round (optional): the built-in live copilot view connects to a local backend you run, fed by the same workspace. A floating always-on-top prompt window (Document PiP) can sit right under your camera.
The console UI is bilingual (中文 / English, toggle in the top bar).
中文说明
这是什么
把一套在真实求职周期里磨出来的面试准备方法开源:给出简历、目标公司、岗位 JD 和表达风格偏好,生成全套备战材料;材料全部是你电脑上一个 Markdown 文件夹(工作台),控制台直接读取渲染,实时提词后端按同一契约取数。当前的生成引擎是 Claude skills;工作台契约是开放的,换成 CLI 或托管 agent 实现同样成立。
全流程
一句话触发(greenroom 入口 skill),或按步单独调用:
| 步 | skill | 做什么 | 落到哪 |
|---|---|---|---|
| 0 | greenroom | 入口:初始化工作台、采集敏感事实、串全流程或单步路由 | 工作台骨架 |
| 1 | job-intel | 公司与面试官调研、JD 逐条对照经历、猎头口径核对、考题预测 | jobs/<slug>/intel.md |
| 2 | story-bank | 真实经历整理成经历卡:事实和数字一份、都标出处,讲法按岗位选 | story-bank.md |
| 3 | industry-brief | 行业与岗位通识:格局、岗位画像、高频概念、可引用观点 | library/*.md |
| 4 | interview-script | 口语化、可直接朗读的逐字稿,按用户风格偏好调整表达 | jobs/<slug>/script.md |
| 5 | mock-interview | 按面试官背景模拟,连续追问,评分含口径一致性 | rounds/mock-N.md |
| 6 | debrief | 面后复盘:复原问答、记录已说出的口径、回写工作台 | rounds/rN-debrief.md |
claim-ledger(口径记录)是贯穿全程的底层机制:每个数字写进稿子前先核对、每轮面试后回写。它在界面里权重很低(页脚入口),起作用的方式是默默约束生成——同一个事实,简历、三轮面试、背调听到的是同一个版本。
逐字稿和市面工具的差别
市面产品输出要点大纲,或一眼 AI 腔的完整句。Greenroom 的逐字稿按口语标准写:写出来就是说出来的样子,朗读不顺嘴就重写;用户给风格样本就按样本调。配一整套写作标准(skills/interview-script/references/style-zh.md):姿态(不示弱、不元叙述、不表忠心)、AI 腔句式零容忍、分点加粗序号的临场可读格式。英文面试有对应的 style-en.md。
资料与公共知识库
- 工作台
library/目录放参考阅读(行业通识、范本拆解、长文摘记),控制台「资料」页直接阅读;industry-brief的产出落在这里。 - 仓库
knowledge/维护按行业 × 岗位 × 方向组织的公共面试知识(高频题、通识、追问模式),industry-brief优先引用它做底。这部分与个人数据无关,欢迎贡献——条目越全,新用户的冷启动越快。
控制台
app/greenroom.html,单文件零依赖,中英双语(顶栏切换):
- 总览:岗位卡 + 五步进度 + 准备状态
- 简历:工作台
resume.md的排版视图,可打印 / 存 PDF,可打开 PDF 原件 - 逐字稿:题卡视图(题号 / 谁高频问 / 要点提纲 / 折叠口径),左侧题目录随滚动高亮,速查模式一键只看提纲
- 经历库:左侧卡片索引随滚动高亮,告别从头翻到尾
- 资料:左侧分组目录树 + 右侧阅读窗,文内目录、上一篇/下一篇
- 知识库:随产品内置的行业 × 岗位公共条目,线条小人插图卡片,点开即读
- 实时助手:内置提词客户端——视口内布局(提词卡内部滚动,长答案不再把转写和操作条顶走)、双引擎转写(本地 FunASR 优先 / Chrome Web Speech 回退)、输入设备可选 + 电平实测(BlackHole 系统音频排障)、静音自动触发、流式提词、悬浮提词小窗(置顶,可拖到摄像头下方)、追加指令、打字兜底;连接你自己跑的本地后端
- 搜索:⌘F / Ctrl+F 全局跳转(岗位、题目、资料、知识库、口径)
- 口径记录与方法论在页脚入口,需要时再看
- 数据载入:本地服务直连(
serve.py或自建后端,免选文件夹)→ 记住的目录句柄 → 拖文件夹 / 选目录 / 内置示例。全部解析在本机完成,无任何上传。
改了 examples/demo-workspace/ 跑 python3 tools/embed-demo.py,改了 knowledge/ 跑 python3 tools/embed-knowledge.py 重新嵌入。
实时提词对接
面试中的提词后端从工作台取数:约束(claims 红线 + 锁定口径)+ 岗位调研(面试官信息与考题预测)+ 逐字稿全文,注入 system prompt——给用户定制生成的全部岗位 context,就是实时助手的引用源头,提词器无权使用工作台之外的数字。后端只需实现 GET /config + POST /api/answer 两个接口(见 docs/realtime-bridge.md);不自建后端也可以用每个岗位的「导出实时提词上下文」按钮。
立场与隐私
- 所有 skills 禁止编造经历和数字,缺了就问。口径记录存在的意义是让你不需要编。
- 简历、薪资、离职原因是一个人最敏感的数据。工作台只是一个本地文件夹,建议
git init私有管理;本仓库只含方法、公共知识与虚构示例(examples/demo-workspace/)。
文档
- 工作台数据契约 — 目录结构、各文件格式、解析规则
- 实时提词对接 — 上下文组装与后端协议
- 公共知识库 — 行业 × 岗位条目与贡献规则
- 示例工作台:examples/demo-workspace/
Roadmap
- 控制台内置实时提词客户端(v0.2.0)
- 行业 × 岗位公共知识库底座 + industry-brief(v0.3.0)
- 服务直连免选文件夹(serve.py + /workspace/bundle 契约)、简历视图、双语界面、知识库前端、悬浮提词小窗(v0.4.0)
- 悬浮提词 v2:Electron 常驻小窗——
setContentProtection对屏幕共享隐身、贴摄像头位置吸附、毛玻璃质感(对标 macOS 新 Siri 浮层)、系统音频直采(免 BlackHole) - knowledge/ 条目扩充:互联网增长、后端工程、咨询、金融等方向
- 工作台生成的非 skills 实现(CLI / 托管 agent,同一契约)
- 控制台:逐字稿朗读计时器;稿内数字与口径记录的前端对账
- skill:offer 谈判与背调口径模块
- 实时提词参考后端开源
License
MIT © 2026 Yunyue Li