career-ops 一键安装器Scaffolder深入解析npx init 从零搭建 AI 求职工作区【免费下载链接】career-opsOpen-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)项目地址: https://gitcode.com/GitHub_Trending/ca/career-opscareer-ops 是一个跑在 AI 编程 CLI 里的开源 AI 求职系统扫描职位门户、把职位评估成结构化的 A–H 报告并给出 1–5 综合评分、按职位定制简历并跟踪每一次申请。本仓库的scaffolder/子项目把「安装整个工作区」压缩成一条npx santifer/career-ops init命令。读完本文你将理解该安装器的行为与默认值、它对多种 AI CLI 的适配机制skill entrypoint 引导以及安装完成后如何通过对话式 onboarding 完成首次配置、如何验证安装。1. scaffolder 在仓库中的定位在仓库根目录 scaffolder/README.md 中scaffolder 被定义为一句话总结career-ops 的一键安装器即装即用ready-to-use。它并不是主程序本身而是一个独立发布的 npm 脚手架包职责是「克隆最新稳定版 安装依赖 引导 CLI skill 入口」把用户引向完整的工作区。从 scaffolder/package.json 可以看到它的发布形态{ name: santifer/career-ops, version: 1.32.0, description: One-command installer for career-ops — the AI-powered job search pipeline built on Claude Code., bin: { career-ops: bin/cli.mjs }, type: module, files: [ bin/cli.mjs, bin/skill-entrypoints.mjs, README.md ], engines: { node: 18 }, keywords: [career-ops, claude-code, job-search, scaffold, create, cli], dependencies: {} }值得注意的实现事实bin字段声明了career-ops命令入口为bin/cli.mjsnpm 包发布时只带上bin/cli.mjs、bin/skill-entrypoints.mjs和 README 三个文件。dependencies为空安装器自身零运行时依赖把重量级安装Playwright、Chromium 等留给克隆下来的主项目在其postinstall脚本里完成见根目录 package.json 中的postinstall: npx playwright install chromium ...。版本与主仓库同步scaffolder 的1.32.0与仓库根目录 VERSION 标注的1.32.0 # x-release-please-version一致二者通过 release-please 协同发布。包的关键字覆盖了它要服务的 CLI 生态claude-code、opencode、codex、antigravity、qwen、kimi、copilot、grok等同时见根目录 package.json。2. 一条命令安装行为与默认值官方推荐且文档主推的安装方式只有一条命令npx santifer/career-ops init它等价于完整的带参形式npx santifer/career-ops init [folder] # 默认目录./career-ops2.1 这条命令做了什么按 scaffolder/README.md 的描述init会建立一个开箱即用的工作区共两步把 career-ops 克隆到最新稳定发布版clones career-ops at the latest stable release安装依赖installs dependencies。安装目录默认是当前目录下的./career-ops如果你想装到别处把第二个参数[folder]换成目标目录名即可。2.2 npx 的语义一次运行不全局安装npx随 Node.js 一起分发。npx santifer/career-ops init只临时拉取并运行一次安装器不会全局安装任何东西——这与根目录 README 中文版 README.cn.md「快速开始」小节里的说明一致。运行时它从 npm 拉取的是santifer/career-ops这个已发布包因此即使本仓库后续有未发布的提交npx拿到的也始终是已发布的最新稳定版脚手架逻辑。2.3 安装之后装完后进入目录并打开你习惯的 AI 编码 CLIcd career-ops claude # 或 codex / qwen / opencode / agy / grok 等更完整的流程说明含 Git 忽略规则、Codexcodex exec的批处理写法见仓库的 docs/SETUP.md那里是该文档中“更偏好手动 git clone 请查看 setup 指南”指向的详细安装手册。3. 首次启动对话式 onboarding无需手动改配置scaffolder 只负责「把代码拉到本地」真正让工作区可用的第二步由主项目承担。根据 scaffolder/README.md 的核心说明在首次启动时Agent 会通过聊天带你完成设置——你的简历、个人档案、目标职位——一切都可以用对话完成无需手工配置任何东西。这意味着npm install完成后第一次在你的 AI CLI 中打开目录Agent基于仓库根目录的AGENTS.md系列指令文件会引导完成提供你的 CV填写个人信息姓名、目标职位、薪资预期等用预置的公司清单配置职位扫描器。用户只需要回答提问即可而不必手动编辑配置。这一点的实战含义是第一轮对话质量决定后续评估质量——系统在还没有你的任何上下文时第一次评估往往不会太好喂给它越多信息CV、职业故事、证明点、偏好、避开的公司类型后续的 A–H 报告和简历定制才越准确根目录 README.md「What Is This」一节对这一点有明确提示。4. AI 无关性设计为什么它能跑在多款 CLI 上scaffolder README 明确强调career-ops 是 AI-agnostic与 AI 厂商无关的Claude Code、Gemini、Codex、Qwen、OpenCode、GitHub Copilot CLI、Antigravity CLI、Grok Build CLI 都可以使用同一套工作区。4.1 多 CLI 是如何被统一起来的这套兼容性不是魔法而是「每个 CLI 读各自入口文件入口文件统一指向规范 AGENTS.md」的架构。仓库根目录 ARCHITECTURE.md 记录每个 CLI 读取自己的入口文件CLAUDE.md完整版以及指向AGENTS.md的薄封装OPENCODE.md、CODEX.md、GEMINI.md外加.agents/skills/下的 skill entrypoint遵循 open agent skill standard。支持矩阵与各 CLI 的调用方式见 docs/SUPPORTED_CLIS.mdCLI入口文件交互式无头 / 批处理Claude CodeCLAUDE.mdclaude/career-opsclaude -p promptCursorAGENTS.md在 Cursor 中打开项目提问.cursor/skills/career-ops/SKILL.mdCodexCODEX.mdcodex纯文本提问codex exec promptOpenCodeOPENCODE.mdopencode/career-opsopencode run promptAntigravity CLIAGENTS.mdagyagy -p promptGrok Build CLIAGENTS.mdgrokgrok -p promptQwen / Kimi / GitHub Copilot CLI / Gemini各自入口各 CLI 原生交互各 CLI 的-p无头参数4.2 安装器为什么要在克隆后「补引导 skill 入口」scaffolder README 里有一句容易被忽略却非常关键的设计说明The installer bootstraps CLI skill entrypoints after clone, so new CLIs (e.g. Grok) work even whennpxpulled an older release tag.翻译成实现语言npm 发布包里的bin/skill-entrypoints.mjsscaffolder 的files清单中明确包含该文件在克隆完成后会为各 CLI 补建 skill 入口文件。这样做的动机是npx拉取的脚手架版本可能晚于某个 CLI 生态的演进比如仓库代码已经支持了较新的 Grok Build CLI而npx缓存或发布的旧 tag 里还没带对应的入口——安装器在本地补上这些入口就能让新 CLI 立刻可用而不必等待脚手架重新发版。仓库改动历史也印证了这条逻辑CHANGELOG 中记录了 scaffolder 在无符号链接文件系统上「materialize」实体化Kimi skill 入口、测试需接受实体化 skill 入口而非仅符号链接、updater 在无 symlink 环境下实体化 skill 入口等修复见 CHANGELOG.md。也就是说AGENTS.md体系下的入口文件既有符号链接方案也有直接实体文件的降级方案scaffolder 必须同时处理这两种情况。4.3 Codex 用户的特殊提醒docs/SETUP.md 对 Codex 给出了补充Codex 的交互会话中斜杠命令不保证可用因此应把模式名直接写进 prompt。例如Evaluate this JD with career-ops auto-pipeline: https://company.com/jobs/123 Run the career-ops scan mode. Run the career-ops pipeline mode. Run the career-ops pdf mode. Run the career-ops email mode for the latest evaluated role. Draft only; never sends, submits, or clicks. Run the career-ops tracker mode.一次性 / 批处理任务则用codex execcodex exec Evaluate this JD with career-ops auto-pipeline: https://company.com/jobs/123 codex exec Run career-ops scan mode in this repo. codex exec Run career-ops pipeline mode for data/pipeline.md. codex exec Run career-ops pdf mode for the latest evaluated role. codex exec Run career-ops email mode for the latest evaluated role. Draft only; do not send, submit, or click anything. codex exec Run career-ops tracker mode and summarize the current statuses.5. 手动安装的备选路线如果你不想依赖npxscaffolder README 说明手动路线仍然完全有效git clone主仓库后进入目录执行npm install接着打开你的 AI CLI 走同样的首次启动引导详细步骤见 docs/SETUP.md。docs/SETUP.md 还提示了这条路线适合的人群想跟踪特定分支、想贡献代码、或想在安装依赖前先审计代码的人。与一键命令相比手动路线多出的一次性步骤是PDF 渲染依赖career-ops 用无头 Chromium 渲染 PDF需按机器安装一次npx playwright install chromium自动化场景下主项目根目录 package.json 的postinstall已经尝试执行npx playwright install chromium --with-deps。另外docs/SETUP.md 还提到无本地检出、纯云端运行的场景——Claude Code on the web把仓库放进私有GitHub 仓库公开 fork 会暴露个人职业数据在 web 会话中提交「Set up career-ops in this checkout. Run npm install, then start the first-run onboarding. Keep cv.md, data/, and reports/ out of Git.」这类任务即可。需要注意的是云端工作区同样使用普通文件cv.md、data/、reports/且这些路径因含个人数据被刻意 git-ignoredweb 会话结束即丢失长线使用仍应走本地安装路线。6. 环境要求Node.js 18 与 gitscaffolder/README.md 给出的依赖只有两条Node.js 18git这两条与 scaffolder/package.json 中engines.node 18互为印证。额外说明来自 docs/SETUP.mdnpx随 Node.js 附带因此安装器拒绝在缺少二者时运行也就是说有 Node 就有npx无需单独安装脚手架若使用 Gemini CLI 集成需要 Node.js 20可选Go 1.21用于 dashboard TUI对应根目录 package.json 的npm run serve:dashboard脚本它实际执行cd dashboard go run .。7. 安装完成后如何验证工作区就绪后可以运行主项目自带的两个一致性检查来确认配置与管道完整node cv-sync-check.mjs # 检查配置 node verify-pipeline.mjs # 检查管道完整性上述命令同样来自 docs/SETUP.md 的 Verify Setup 小节对应根目录脚本见 package.json 的sync-check、verify。若想大范围跑验证仓库还提供node test-all.mjs --quick见 docs/SETUP.md 的贡献流程说明。8. 核心操作速查表进入工作区并完成首次 onboarding 后日常操作通过/career-ops斜杠命令或直接向 Agent 下达自然语言指令即可下表摘录自 docs/SETUP.md动作方式评估一份职位粘贴 URL 或 JD 文本搜索职位/career-ops scan或让 Agent 执行scan处理积压 URL/career-ops pipeline或让 Agent 执行pipeline生成 PDF/career-ops pdf或让 Agent 执行pdf起草申请邮件/career-ops email——仅起草绝不发送、提交或点击批量评估/career-ops batch或codex exec Run career-ops batch mode ...查看跟踪状态/career-ops tracker或让 Agent 执行tracker填写申请表单/career-ops apply或让 Agent 执行apply9. 总结把 scaffolder/README.md 与 scaffolder/package.json、docs/SETUP.md、docs/SUPPORTED_CLIS.md、ARCHITECTURE.md 合在一起看scaffolder 的完整设计意图非常清晰降低门槛npx santifer/career-ops init [folder]默认./career-ops一条命令完成「克隆最新稳定版 装依赖」这是新手最快的上手路径对话式配置真正个性化设置不依赖手工编辑文件首次启动时由 AI CLI 里的 Agent 通过与用户聊天完成 CV、个人档案与目标职位的录入CLI 无关克隆后由bin/skill-entrypoints.mjs补建各 CLI 的 skill 入口使 Grok 等新 CLI 在npx拉到旧 tag 时依然可用底层是「各入口文件统一指向AGENTS.md」的 open agent skill standard 架构手动路线作为兜底需要审计代码、跟踪特定分支或参与贡献时git clone npm install依然完全可用。如果你只想快速体验 career-ops直接执行npx santifer/career-ops init然后cd career-ops claude或你惯用的 CLI剩下的让首次对话引导你完成即可。【免费下载链接】career-opsOpen-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)项目地址: https://gitcode.com/GitHub_Trending/ca/career-ops创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考