Skip to content

Jaxon1216/interview-analyzer-skill / skill/project-interview-skill

project-interview-skill

Verified

基于项目描述与仓库证据生成目标简历、完整核心源码课程与项目面经,含学习路线、重点难点 HTML 专题和第一人称回答。 适用于项目分析、面试准备、简历亮点和导学材料。

references/rules/course-design.md

View on GitHub
# 源码课程设计与质量分层

## 默认学习者与选题

默认读者懂基础语法、用过框架、能写 CRUD,当前目标是看懂完整项目、修改关键机制并讲清取舍。用户明确初学或资深时调整解释深度。

先确定方向与真实覆盖范围,再按场景编排课程。前端/后端通常 6~8 课,全栈通常 8~12 课;这些是规模参考,不是凑数要求。每课围绕一个可从触发走到结果的场景;机制过于独立、前置依赖不同或一课跨度过大时拆分。一个源文件可支撑多课,一课也可以跨多个文件,不按源码文件数拆课。

默认总览与所有核心课程本次完成;可选课只列主题、价值、前置条件和展开入口,不创建占位文件。用户只要大纲或指定课时才缩小交付。大型仓库选代表性主链,明确覆盖范围,不假称讲完所有模块。

## 内容重心:维度用于查漏,场景用于成课

| 维度 | 默认投入参考 | 前端示例 | 后端示例 |
| --- | --- | --- | --- |
| 项目地图与运行入口 | 10% | 页面、路由、开发服务和代理 | 启动、配置、依赖绑定和请求入口 |
| 核心链路与数据流 | 30% | 事件→请求→状态→渲染 | 参数→业务→存储→响应 |
| 特色机制与运行原理 | 30% | 响应式、异步竞态、生命周期、资源清理 | 并发、事务、缓存、异步消费 |
| 工程质量与排障 | 20% | 调试、测试、性能、安全、可访问性 | 测试、观测、性能、安全、部署 |
| 设计取舍与演进 | 10% | 状态归属、组件边界、替代设计 | 一致性、容量、恢复、替代架构 |

比例用于判断是否偏题,不要求统计字数。基础讲解总体约不超过一成,按实际阻塞点穿插,不为八类知识各写一章通识教材。

按项目查漏:

- 前端:框架/类型建模、数据所有权、路由与会话、请求取消和竞态、加载/空/错状态、表单、浏览器与网络、构建、测试调试、性能、安全、可访问性与资源清理。
- 后端:语言与标准库惯用法、请求生命周期、超时取消、并发协作、连接池、数据建模/索引/事务、缓存、消息/幂等/重试/背压、观测、测试、安全、部署回滚。
- 全栈:重点讲边界契约与两端协作,不重复复制两套课程;按实际仓库比重安排,不强求 50:50。
- 非当前技术栈只作有价值的进阶:JS 项目不强制 TypeScript 主课,无 K8s 配置不编造编排链路。运行时只深入到解释当前问题所需的程度,调度器或 GC 源码可放选读。

## 学习分层

每课标明“核心”或“选读”,再说明预期掌握层次;课程性质和掌握层次是两个不同维度。

1. **看懂链路**:能复述输入、输出、状态变化和模块职责。
2. **理解机制**:能定位关键代码,解释为什么这样做、约束如何影响行为、异常时会发生什么。
3. **设计与表达**:能比较替代方案、分析失败边界,并回答对应面试题。

核心课至少讲清前两层;简历重点支柱讲到第三层。层次加深必须增加因果、边界或取舍,不能只增加术语。理解深度不以是否布置实验衡量。

## 单课内容

使用 C01…稳定编号,文件名与课程标题带编号。每课包含以下内容,可合并相邻段落,但不能用清单替代讲解:

1. **课程导航**:返回主导学、前置课程、建议下一课、相关 B/Q 链接与目标。标明 `课程性质:核心` 或 `课程性质:选读`。
2. **本课重点**:用具体输入或用户操作交代场景,直接给出 2~4 个关键结论;不让读者先猜状态或回答预测题。
3. **主链与职责**:一张简洁流程图或文本链,讲清同步调用、事件/队列、状态所有者与跨层契约。
4. **源码阅读**:按执行顺序给出路径、符号、阅读目的与下一步。随后解释关键代码为何产生对应行为,而非只列文件名。
5. **机制与边界**:结合具体输入输出解释核心原理、异常路径、并发或生命周期问题;区分当前实现与分析推断。
6. **需要懂什么**:直接解释本课必须掌握的因果、概念区别和方案取舍;不能只写“理解缓存一致性”等目标标签,也不把答案藏在问题或提示里。
7. **需要记住什么**:提炼可复述的主链、关键参数/不变量及限制。结论须区分当前实现与演进方案;链接相关面试题,避免重复口播全文。

默认不生成“预测”“动手验证”、实验命令、故障注入任务或课后理解题。用户明确要求配套练习、验证或排障时才提供相应内容,说明操作前提与预期;未实际执行不能写已通过。讲解测试、部署、观测原理时仍可引用必要代码和配置,但不能把该主题自动变成实验作业。

## 重点难点 HTML 专题

**选题由主会话完成。** 完整编课时,从本次核心课中挑 1~3 个已有证据支撑的重点难点。优先选影响主链或面试表达、且读者需要对照状态、分支或时序才能说清的机制。先用一句话写下“换了哪个条件,读者会看到什么差别”。例如,在有请求竞态保护的项目里,可以比较“两次搜索按顺序返回”和“旧请求最后返回”时哪个结果更新页面。一页只讲透一个机制,课文仍完整解释所属场景。材料不足或没有适合演示的机制时,在交付说明中交代理由;只要面经、大纲或 Markdown 时按用户范围交付。

**先教学设计,再一题一份委派。** 按[HTML 教学规则](html-teaching.md)确定读者已知、唯一主要未知、一个可获得的能力和完整工作示例。主会话再提供 C 编号、课文与导学实际路径、源码证据、已知边界、[页面骨架](../../assets/topic.html)的绝对路径以及唯一目标路径 `<课程目录>/topics/C编号-主题短名.html`。子 agent 核对资料后,按机制设计图形与真实状态操作,只写分给它的页面。不同专题可并行;只有主会话修改导学与课文。无子 agent 能力时由主会话执行相同步骤;子任务失败时修复或接手,按实际生成的结果交付。

**页面怎么教。** 用一个实例逐步走到核心结局,每次操作改变一个主要条件,主图与就近反馈解释变化原因。首屏给具体场景和操作入口;参考区承接长代码、术语与例外。页面骨架只统一阅读层次、样式与导航,不限定图形、控件或分支数量;预置状态切换不足以替代完整示例。默认不要求答题或实验,直接操作仍须有因果反馈。示意与反事实标清,替换所有槽位、转义文本与属性,链接按成品位置计算。所需样式和行为随单文件离线交付,键盘、手机和打印可读。

**验收后回填。** 事实、运行与呈现、教学三项分别验收,按 HTML 教学规则逐项审读。默认无头浏览器走完一条完整示例,并改变条件复查反馈、重置、键盘、手机、打印与截图;仅用户要求查看时才打开可见预览。缺少浏览器时说明未实测项。稳定夹具可比较同环境中经审阅的截图基线;新页截图检查不冒称视觉回归,任何自动检查都不能替代教学审读。验收后将页面相对链接追加到导学对应 C 行第二格及课文机制位置,HTML 链接回两份 Markdown。沿用已有路径,保留笔记,不重复链接;没有成品不写待生成入口。

## 代码引用与可移植性

生成文档使用相对 Markdown 文件链接,符号名作主要定位,行号作辅助文字;按课程文件所在目录计算路径,不能照抄仓库根相对路径当可点击链接。主导学和面经使用相同规则。

输出目录或源码目录经过符号链接时,先将两端目录解析为真实路径,再计算相对链接;例如 macOS 的 `/var` 与 `/private/var` 是同一目录的不同入口,混用会算错上溯层数。移动测试产物后重新计算并校验链接。

关键片段按解释需要引用,一般每课少量短片段足够;保留必要上下文,不粘贴整文件。伪代码明确标为简化模型,不能冒充仓库实现。框架、库版本从项目依赖读取,API 不确定时查对应官方文档。

编辑器专属跳转只是增强,不是交付依赖。课程靠路径、符号、片段与阅读顺序即可使用;Markdown 锚点可辅助导航,源文件行锚点不保证所有客户端支持。

## 更新与质量检查

- 主导学链接每节核心课;课程反向链接主导学与相关面经。B/Q/C 编号在更新时尽量稳定,新增用新编号,不重排用户学习记录。
- 用户笔记、完成状态和已写答案保留;只更新受代码或目标变化影响的章节及关联。
- 每课至少能检查:重点是否明确?因果讲清了吗?代码落点可定位吗?必懂原理和必记结论是否直接写出?正常与异常可区分吗?能支撑相关 bullet 与 Q&A 吗?
- 找到机制 bug 要解释它对链路的影响、正确做法及当前边界;默认不布置修复/验证练习,不让缺陷清单取代正常机制教学。
- 避免重复背景、泛泛概念、全课文件清单及“请继续问 AI”代替正文;不靠课程数、字数或标题齐全宣称内容优质。
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall