把真实项目快速整理成两份可直接用于面试准备的文档（输出到目标项目根目录）：

• 导学-{简称}.md：重点亮点、代码阅读路径、学习顺序与必备知识点
• 面经-{简称}.md：简历可用摘要 + 面试题口播（第一人称 STAR）

效果演示

下面这张合并图展示了触发输入与面经输出示例：

安装方式

推荐使用 npx，不需要 clone 仓库：

npx project-interview-skill install

默认安装到用户级通用 Agent 目录：

~/.agents/skills/project-interview-skill/

如果你明确使用某个编辑器或 Agent，建议显式指定产品：

| 目标 | 用户级安装 | 安装位置 | |------|------------|----------| | 通用 Agent / Codex | npx project-interview-skill install --agents | ~/.agents/skills/project-interview-skill/ | | Trae | npx project-interview-skill install --trae | ~/.trae/skills/project-interview-skill/ | | Cursor | npx project-interview-skill install --cursor | ~/.cursor/rules/project-interview-skill/ | | VS Code | npx project-interview-skill install --vscode | ~/.copilot/instructions/project-interview-skill.instructions.md | | Claude Code | npx project-interview-skill install --claude-code | ~/.claude/skills/project-interview-skill/ | | Codex | npx project-interview-skill install --codex | ~/.agents/skills/project-interview-skill/ |

也可以一次安装到全部支持目标：

npx project-interview-skill install --all

只查看会安装到哪里，不写入文件：

npx project-interview-skill install --trae --dry-run
npx project-interview-skill doctor

项目级安装

如果你只想让某个业务项目使用这个 skill，进入业务项目根目录后执行：

cd /path/to/your-project
npx project-interview-skill install --project --trae

支持的项目级目标：

| 目标 | 项目级安装 | 安装位置 | |------|------------|----------| | 通用 Agent / Codex | npx project-interview-skill install --project --agents | .agents/skills/project-interview-skill/ | | Trae | npx project-interview-skill install --project --trae | .trae/rules/project-interview-skill/ | | Cursor | npx project-interview-skill install --project --cursor | .cursor/rules/project-interview-skill/ | | VS Code | npx project-interview-skill install --project --vscode | .github/instructions/project-interview-skill.instructions.md | | Claude Code | npx project-interview-skill install --project --claude-code | .claude/skills/project-interview-skill/ | | Codex | npx project-interview-skill install --project --codex | .agents/skills/project-interview-skill/ |

安装完成后，重启对应 IDE / Agent，开启新对话。

使用方式

在被分析项目的工作区开启新对话，例如：

/project-interview-skill 简称：电商；项目描述：......（背景/职责/难点/结果）；技术栈：Vue3、Pinia、Vite；求职方向：前端

随后在该业务项目根目录生成：

| 文件 | 用途 | |------|------| | 导学-{简称}.md | 前置知识、必备知识点、推荐阅读（含仓库相对路径）、原理与设计决策；文末可含「量化与验证（含待测）」 | | 面经-{简称}.md | 1～2 句简历摘要、架构向 bullets、按简历支柱展开的面试题（主问/追问口播） |

也可以不写 slash 命令，直接描述“请基于这个项目生成导学和面经”。

源码安装兼容入口

install.sh 仍保留给 clone 仓库的用户使用，但它只是 Node CLI 的兼容包装器：

git clone https://github.com/Jaxon1216/interview-analyzer-skill.git
cd interview-analyzer-skill
./install.sh --trae
./install.sh --project --cursor

npm 包不会打包 install.sh；对普通用户优先推荐 npx project-interview-skill ...。

可直接复制的 Skill Bundle

仓库外层是 npm CLI 和开发工程；真正可独立迁移的 Skill 位于：

skill/project-interview-skill/
├── SKILL.md
├── references/
└── scripts/

复制这个目录即可迁移 Skill，不需要复制 bin/、tests/ 或 package.json。npm CLI 安装时也只从这个目录生成目标 Skill。

仓库结构

interview-analyzer-skill/
|-- skill/
|   `-- project-interview-skill/
|       |-- SKILL.md
|       |-- references/
|       |   |-- rules/
|       |   |-- templates/
|       |   |-- examples/
|       |   `-- excellent-resumes/
|       `-- scripts/
|-- bin/
|   `-- project-interview-skill.js
|-- install.sh
|-- package.json
|-- README.md
|-- README_EN.md
|-- demo.jpg
|-- LICENSE
`-- tests/

维护与发布

本项目作为 npm CLI 包发布，不需要编译。npm 包会按 package.json 的 files 白名单打包：

npm pack --dry-run
npm publish --access public

本地验证：

npm test
npm run pack:check
node bin/project-interview-skill.js install --trae --dry-run

常见问题

.npmrc 是必要的吗？

不是 npm 包必须文件。它只用于本仓库开发时指定 registry。真正发布到公网 npm 的关键配置是 package.json 里的 publishConfig.registry。

为什么默认安装到 .agents/skills？

这是最稳的用户级默认值，不依赖猜测用户正在使用哪个产品。如果你明确使用 Trae、Cursor、VS Code 或 Claude Code，使用对应参数即可。

install 会自动探测产品吗？

不会。当前设计刻意收敛：默认只装到通用 .agents/skills，分产品安装必须显式指定 --trae、--cursor、--vscode、--claude-code 或 --codex。doctor 只展示路径，不安装。

更新后会自动生效吗？

不会。已安装目录是拷贝产物，需要重新执行安装命令：

npx project-interview-skill install --trae

反馈与支持

• 需求 / 建议 / 商用 / 二开：[email protected]
• 欢迎 Star、Fork 按场景定制、Issue / PR 一起改进

License

本项目采用 MIT License，完整条款见 LICENSE（英文正文 + 中文参考译文；若理解有出入，以英文为准）。