/project-guide：项目导学 + 项目面经

基于用户提供的项目仓库、项目描述、技术栈和求职方向，把真实项目整理成源码课程，或导学与面经材料。本技能关注“项目如何学、如何讲、如何被追问”，不替用户编造公司、职位、数据、上线结果或个人职责。

路由边界

• 需要从项目仓库或项目材料生成源码课程、配套理解题、学习路径、项目亮点或项目面经成稿：使用 /project-guide。
• 只需要把经历改成简历 bullet、岗位定位或 HR 开场白：使用 /great-resume。
• 已经有简历，需要模拟面试、预测问题或逐轮追问掌握度：使用 /interview。
• 需要生成可编辑 HTML/PDF 简历：使用 /make-resume；未指定模板时默认使用 ASu 模板，也可以在请求中指定其他模板。
• 需要寻找开源贡献候选、准备 diff 或提交 PR：使用 /contributor。

输入契约

优先从当前工作区读取项目事实，再结合用户材料。先按用户请求选择“源码课程”或“导学面经”模式；未指定时使用导学面经模式。缺少关键信息时最多追问 3 个高信号问题；用户要求先出初稿时，允许用 待补 标注缺口。

字段	必须	说明
项目源码	源码课程必需	本地仓库或当前工作区；只有项目描述时不能生成已核验的函数调用路线
项目描述	导学面经必需	背景、目标、职责、难点、结果；越具体越好
操作	源码课程必需	课程大纲、展开指定课程、配套练习，或用户明确要求的组合操作
课程编号	展开或练习时必需	必须能在现有课程文件中定位
简称	导学面经强烈建议	用于文件名 导学-{简称}.md、面经-{简称}.md
技术栈	否	语言、框架、中间件、观测、发布方式
求职方向	否	前端、后端、AI、数据、产品或交叉方向

导学面经材料不足时，优先追问：

1. 你在项目中的个人职责和协作边界是什么？
2. 项目最能展开的技术难点是什么，解决前后的现象如何验证？
3. 是否有指标、日志、PR、截图、上线记录或用户反馈可以作为证据？

可选脚本：

python3 scripts/project_guide.py check --file description.txt --tech "React, TypeScript" --role "前端"
python3 scripts/project_guide.py build-prompt --short-name "智能BI" --description "..." --tech "..." --role "..."

源码课程模式

用户要求把仓库分课学习、展开指定课程或生成课程练习时进入该模式。未指定具体操作时，先生成课程大纲，不自动展开全部课程或创建练习。

本模式维护课程文件（文件名由 tutorial 和 .md 拼接）与练习文件（文件名由 practice 和 .md 拼接）。

课程大纲

1. 读取课程大纲规范；
2. 检查项目入口、主要功能、模块边界和代表性运行流程；
3. 在课程文件中生成课程大纲，每课给出真实文件与符号的阅读顺序；
4. 记录源码版本、实际覆盖范围和尚未覆盖的模块。

展开指定课程

1. 读取现有课程文件与单课讲解规范；
2. 确认课程编号、主题、前后边界和源码范围；
3. 沿真实调用或事件顺序展开该课，并以完整流程串联收尾；
4. 只更新指定课程，保留其他课程和用户笔记。

配套理解题

1. 读取课程文件中的对应课程与配套练习规范；
2. 在练习文件中更新相同编号和标题的课程练习；
3. 默认只生成问题和必要的回答要求，不附标准答案；
4. 只考查课程已经讲过的内容，保留其他课程的练习与用户答案。

用户明确要求组合操作或同步时，按“大纲 → 展开 → 练习”的依赖顺序执行请求包含的操作，并只创建本次需要的文件。

源码事实与局部更新