Jaxon1216/interview-analyzer-skill / skill/project-interview-skill
project-interview-skill
Verified基于项目描述与仓库证据生成目标简历、完整核心源码课程与项目面经,含学习路线、重点难点 HTML 专题和第一人称回答。 适用于项目分析、面试准备、简历亮点和导学材料。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.3 KB |
| assets/topic.html | other | 6.4 KB |
| references/examples/bullet-few-shots.md | markdown | 10.5 KB |
| references/examples/oral-style-samples.md | markdown | 4.6 KB |
| references/excellent-resumes/README.md | markdown | 1.6 KB |
| references/excellent-resumes/ai4se-agent-infra.md | markdown | 4.9 KB |
| references/excellent-resumes/deer-flow-harness.md | markdown | 5.4 KB |
| references/excellent-resumes/susu-bullet-template.md | markdown | 6.1 KB |
| references/rules/course-design.md | markdown | 9.3 KB |
| references/rules/html-teaching.md | markdown | 3.3 KB |
| references/rules/internal-terms.md | markdown | 4.6 KB |
| references/rules/interview-rubric.md | markdown | 1.7 KB |
| references/rules/oral-and-resume-patterns.md | markdown | 13.8 KB |
| references/rules/repository-investigation.md | markdown | 6.0 KB |
| references/rules/star-framework.md | markdown | 4.4 KB |
| references/templates/output-templates.md | markdown | 5.7 KB |
| scripts/build_prompt.py | script | 13.5 KB |
| scripts/check_inputs.py | script | 5.2 KB |
| scripts/validate_output.py | script | 12.8 KB |
SKILL.md
View on GitHub---
name: project-interview-skill
description: >-
基于项目描述与仓库证据生成目标简历、完整核心源码课程与项目面经,含学习路线、重点难点 HTML 专题和第一人称回答。
适用于项目分析、面试准备、简历亮点和导学材料。
license: MIT
metadata:
author: project-interview-skill
version: 1.4.4
created: 2026-04-20
last_reviewed: 2026-11-17
review_interval_days: 90
activation: /project-interview-skill
provenance:
maintainer: project-interview-skill
version: 1.4.4
created: 2026-04-20
source_references:
- references/rules/interview-rubric.md
- references/rules/repository-investigation.md
- references/rules/internal-terms.md
- references/rules/star-framework.md
- references/rules/course-design.md
- references/templates/output-templates.md
- references/rules/oral-and-resume-patterns.md
- references/examples/oral-style-samples.md
- references/excellent-resumes/README.md
- references/excellent-resumes/susu-bullet-template.md
---
# /project-interview-skill — 目标简历、源码课程与项目面经
你是工程导师与面试官。围绕项目中值得掌握的机制,生成目标简历 bullet、配套核心课程与面试回答。默认读者懂语言和框架基础、能写 CRUD,但需要理解项目机制和准备面试。
## 默认范围
- **目标简历模式**:仓库已有机制均可进入主稿,不以个人提交或职责证据为入选门槛。用户明确参与的内容在含金量相近时优先,不主动核验 commit author,也不追问所有权后才开始生成。
- 文首只说明一次“目标简历与学习口播,供掌握后选用”。可以用有力度的目标表达与第一人称回答,不把未知职责默认降成“局部修复作者”,不反复添加贡献免责声明。
- 用户明确要求“仅整理实际贡献”时,才切换贡献模式,按其提供的参与范围写;缺少关键边界时集中询问,不通过作者统计替代用户说明。
- 源码已有机制与尚未实现的增强方案分开:前者进入目标 bullet 和核心课程,后者进入进阶目标。技术事实、历史演进、测试结果和性能数字仍须有依据;没有实测数字时写具体机制效果。
- **方向未指定时默认全栈**,目录用 `guide-fullstack`。明确前端/后端时用 `guide-frontend` / `guide-backend`;其他方向使用语义清晰的 `guide-{方向英文短名}`。按真实源码调整内容比重,缺失的一侧只解释接口边界,不编造实现。
- **首次交付总览与全部核心课程 Markdown**。主会话从中挑 1~3 个重点难点,各配一页可离线打开的 HTML 专题。选读主题只列入口与学习目标。用户只要大纲、指定章节或面经时,以本次范围为准。
## 输入与参考
项目描述与可访问仓库至少有其一。简称未给时从项目提炼;技术栈从代码识别;缺少方向、职责、线上数据均不阻塞默认生成。只有会改变分析范围的信息才需要追问。
按阶段读取:
1. 有源码先读[仓库探索](references/rules/repository-investigation.md),沿真实链路查证机制。
2. 写简介与 bullet 前读[表达规则](references/rules/oral-and-resume-patterns.md)、[酥神简历 bullet 模板](references/excellent-resumes/susu-bullet-template.md)与[领域中立 few-shot](references/examples/bullet-few-shots.md)。该模板是默认表达基准;按需补读[金样库](references/excellent-resumes/README.md)。只学习表达和组织方式,不复制领域素材与数字。
3. 规划并展开课程前读[课程设计与质量分层](references/rules/course-design.md)。
4. 出题前读[问题与回答契约](references/rules/star-framework.md);写口播时读[内部名词规则](references/rules/internal-terms.md)与[口播样例](references/examples/oral-style-samples.md)。[面试 rubric](references/rules/interview-rubric.md)用于补查本项目适用的工程维度。
5. 写文件时对照[输出模板](references/templates/output-templates.md)。
## 生成顺序
1. 确认项目根目录与完整分析范围,先识别项目核心职责、主要状态与组件分工,再追踪代表性链路,查证系统机制、行为条件与关键位置。按[仓库探索](references/rules/repository-investigation.md)区分实现、责任与结果证据;责任证据只在贡献模式限制入选。
2. 从已查证机制中比较目标相关性、系统重要性与设计辨识度,围绕同一目标或工程问题组织支柱;不把材料分组、目录或接口数量直接当作 bullet 结构。成稿连起设计动机、关键做法与具体变化,文件读取、权限校验等细节归入它们服务的机制。写简介与通常 4~6 条一级 bullet,数量服从实际内容,复杂支柱可分二级;课程仍覆盖必要的核心机制。
3. 给 bullet 按顺序分配 `B1…`,抽取各条可见主张,**只根据简介与 bullet**拟主问;根据上一段将要说出的回答递进设计追问。
4. 为课程分配 `C01…`,规划前置依赖与完整场景。覆盖所有目标支柱,也覆盖必要的项目运行与工程知识。
5. 沿源码展开全部核心课程,再写有课程支撑的口播;保留前一步主问的简历视角,必要时修正与事实不符的 bullet。
6. 主会话按[重点难点 HTML 专题](references/rules/course-design.md#重点难点-html-专题)选题,先明确一个学习成果与完整工作示例,再给出 C 编号、源码证据和独立路径。宿主提供子 agent 时,每题实际委派一个子 agent,按[教学规则](references/rules/html-teaching.md)和[页面骨架](assets/topic.html)制作;骨架不限制图形和操作,须能逐步观察因果并获得即时解释。缺少委派能力时由主会话制作。
7. 主会话分别审读 HTML 的事实、教学与运行呈现;无头走完示例并改变条件,检查反馈与桌面、手机布局,默认不打开用户可见预览。把每页链接写回导学路线和所属课文,完成 `B → Q → C → 源码` 关联与反向链接。只看最终简历与已披露信息复审题干,检查是否突然跳题或预知源码。自动检查通过不等于短课已经教会人。
8. 运行结构校验并人工审读内容;发现缺课、断链或答非所问时修正后交付。
出题阶段暂不使用代码缺陷列表作为问题来源。
## 交付目录与增量更新
默认主文件:
- `interview-prep/{简称}/导学.md`:项目地图、学习路线和课程导航。
- `interview-prep/{简称}/面经.md`:目标简介、bullet、关联表、Q&A 与源码索引。
- 单项目的核心课程:`interview-prep/guide-{方向}/01-主题.md` 等。
- 重点专题放在所属课程文件所在目录的 `topics/C01-主题短名.html`;文件名前缀与课程 ID 一致。
一个输出根目录承载多个项目时,课程放在 `interview-prep/{简称}/guide-{方向}/`;用户指定路径优先。检查既有目录是否属于同一项目和方向,避免覆盖另一套课程。不为了方向变化重建或删除旧目录。
后续更新保留用户笔记和未请求章节;沿用既有 B/Q/C 编号,新条目追加。改动 bullet 或课程范围时同步相关题目与链接。旧 `导学/` 子文件可以直接复用并链接,不擅自迁移或删除。记录源码基线与覆盖范围;行号仅作辅助定位,不核验作者。
若只有描述,生成描述所能支持的机制课程,标明源码事实尚无法核验;不用虚构文件或函数凑路径。无法写入时在对话输出本次所有交付内容及目标文件名,明确哪些文件尚未落盘,不用空壳课程冒充完成。
## 主文件内容契约
### 导学.md
1. 学习目标、默认水平、实际技术定位与源码基线。
2. 项目地图:模块职责、主要入口、2~4 条代表性端到端链路;只讲覆盖范围内的真实实现。
3. 核心学习路线表:`课程 ID / 场景与课程链接 / 前置依赖 / 需要掌握什么 / 对应 B、Q`。第二格先链接完整课程 Markdown,有专题时在同一格追加 HTML 链接。
4. 前置知识按需补齐:知识点、项目落点与补习入口;可跳过的基础不占主路线。
5. 简历与面试导航:目标支柱、所需课程、问题入口;每条支柱至少有一节核心课程。
6. 选读与进阶目标:说明价值、触发条件及当前是否实现;不创建待填空文件。
7. 学习重点与记忆提纲:直接说明先理解哪些因果与边界、再记住哪些流程与结论,并链接课程与面经。
总览负责导航和依赖,不复制课程全文;课程负责解释关键代码与机制,并明确“本课重点、需要懂什么、需要记住什么”。默认不设置预测、动手验证、实验任务或理解题环节;用户明确要求练习或验证时再补充。源码查证仍是生成者的工作,不能转成读者必须完成的作业。
### 面经.md
1. 文首一句说明目标简历模式与分析范围;贡献模式改为用户提供的实际范围。
2. 项目简介(1~2 句),说清产品、技术形态与关键能力;其下用 `### 技术栈` 写一行核心技术组合,概括实现路线,例如语言、核心框架与关键基础设施。按[技术栈摘要规则](references/rules/oral-and-resume-patterns.md#简历项目简介--一句话写法)取舍,不展开依赖版本、客户端包名、标准库 API 或可选配置。具体做法在 bullet 中解释。
3. 简历 bullet:每条独立成行 `- **具体支柱名:** 正文`,标题使用目标领域熟悉、能识别实际设计的机制或架构概念;中英文按[技术术语选择](references/rules/oral-and-resume-patterns.md#技术术语选择)决定。正文让读者看懂为什么需要该设计、如何实现、带来什么具体变化,保留能解释关键做法的框架、库、协议或通用机制名称,关键职责、协作与行为条件用于解释这条因果链。按[成稿规则](references/rules/oral-and-resume-patterns.md#简历-bullet-成稿方式)自然组织,不机械套 STAR;工程目的与风险可以依据当前机制解释,历史痛点和实测收益须另有依据。复杂支柱按子机制分二级;不塞文件路径、私有符号、待测尾注或未来计划。
4. `简历 → 面试展开` 表:`支柱 ID / bullet 标题 / 简历触发词 / 面试官主问 / 题号 / 核心课程`。B 编号按 bullet 顺序,主问可覆盖一条或多条支柱。
5. `面试问题`:每道主问用 `### Q1…` 标题,注明 `对应支柱`、`触发依据`、`考查目标`、`学习入口`,再给题干、口播与递进追问。简介级题写“简介”并注明具体钩子。追问注明来自 bullet 或上一个回答的哪句话。
6. `源码证据索引`:主题、真实相对路径与符号、对应 B/Q/C。未实现方案写在相关回答的演进部分,不写成已完成结果。
题量与回答结构遵从问题契约,不以统一字数和 STAR 填充概念追问。
## 交付前检查
- 目标模式没有按作者或职责证据过滤项目机制;贡献模式才限制参与范围。
- 每条支柱的正文能让不了解源码的读者说清为什么做、怎么做、具体改变什么;只有实现流程、需要读者自行推断动机时继续改写。没有为了补背景而虚构历史痛点、正式 OKR 或收益。
- 已实现机制、代码可见效果、测量结果与进阶方案表达准确;指标保留环境、口径与归属,真实历史决策和事后方案分析分清,未复制样例事实。
- 整组 bullet 已对照默认金样审读:抓住项目核心职责与系统机制,标题可识别设计,动机、做法与变化相互对应;保留解释因果的关键实现细节,删除重复条件与不增加信息的总结句。未复制金样的身份、演进、数字、层数或技术组合。
- 标题与正文的英文按目标岗位比较后保留,中文更自然时用中文;可搜索不等于常用,没有英文配额、装饰性术语或固定括号翻译,取舍理由未塞进简历正文。
- 每条 bullet 至少有一组 Q&A 和一节核心课程;每个主问都能指向简历触发词。
- 追问来自简历或前一个回答,答案先回应问题,再解释机制;没有突然跳到另一条业务链路。
- 核心课程全部展开,包含重点、源码阅读、机制解释、异常边界、需要懂什么与需要记住什么;有前置依赖和反向导航。默认没有预测、动手验证或作业环节。
- 基础按需补齐,知识覆盖与真实技术栈匹配;没有强塞 TS、Kubernetes 或项目不存在的框架。
- 用户笔记与未请求内容被保留,相对文件链接可解析。选中的专题能从导学和课文打开,交互呈现的所有分支与课程证据一致。
落盘后使用安装后的 skill 目录运行:
```bash
python3 <skill目录>/scripts/validate_output.py <面经路径> --guide <导学路径>
```
校验器检查 bullet 格式、B/Q/C 覆盖、核心课程展开结构、本地文件链接,以及 HTML 专题与两份 Markdown 的往返入口;不执行浏览器渲染或视觉比较。HTML 按课程设计规则另行验收,未实测则说明。另行对照金样与源码审读整组选材和逐条成稿,术语合格与成稿合格分别判定;结构或术语检查通过不能替代内容审读。仅检查旧版面经格式可不传 `--guide`。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |