convez.ai
Skill
YunyueLi

greenroom

YunyueLi/greenroom

Ver no GitHub
InicialPluginScore · de 0 a 100

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/greenroom

1 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

Estrelas
12
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

  1. Tell Claude: 「我要面试了,这是我的简历,目标是 X 公司的 Y 岗位,JD 如下」 — the greenroom skill runs the pipeline end to end: workspace init → research → experience bank → industry brief → verbatim scripts.
  2. Run python3 serve.py ~/my-greenroom — the console opens in your browser with the workspace auto-connected (no folder picking). Or open app/greenroom.html directly and drag the folder in; press the demo button to see a complete fictional example.
  3. Before the round: mock-interview. Within 24h after: debrief — what you said gets recorded and constrains the next round.
  4. 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做什么落到哪
0greenroom入口:初始化工作台、采集敏感事实、串全流程或单步路由工作台骨架
1job-intel公司与面试官调研、JD 逐条对照经历、猎头口径核对、考题预测jobs/<slug>/intel.md
2story-bank真实经历整理成经历卡:事实和数字一份、都标出处,讲法按岗位选story-bank.md
3industry-brief行业与岗位通识:格局、岗位画像、高频概念、可引用观点library/*.md
4interview-script口语化、可直接朗读的逐字稿,按用户风格偏好调整表达jobs/<slug>/script.md
5mock-interview按面试官背景模拟,连续追问,评分含口径一致性rounds/mock-N.md
6debrief面后复盘:复原问答、记录已说出的口径、回写工作台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/)。

文档

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

Ver o original no GitHub

Bom para

Relacionados