project-guide

1# /project-guide：项目导学 + 项目面经
2 
3基于用户提供的项目仓库、项目描述、技术栈和求职方向，把真实项目整理成源码课程，或导学与面经材料。本技能关注“项目如何学、如何讲、如何被追问”，不替用户编造公司、职位、数据、上线结果或个人职责。
4 
5## 路由边界
6 
7- 需要从项目仓库或项目材料生成源码课程、配套理解题、学习路径、项目亮点或项目面经成稿：使用 `/project-guide`。
8- 只需要把经历改成简历 bullet、岗位定位或 HR 开场白：使用 `/great-resume`。
9- 已经有简历，需要模拟面试、预测问题或逐轮追问掌握度：使用 `/interview`。
10- 需要生成可编辑 HTML/PDF 简历：使用 `/make-resume`；未指定模板时默认使用 ASu 模板，也可以在请求中指定其他模板。
11- 需要寻找开源贡献候选、准备 diff 或提交 PR：使用 `/contributor`。
12 
13## 输入契约
14 
15优先从当前工作区读取项目事实，再结合用户材料。先按用户请求选择“源码课程”或“导学面经”模式；未指定时使用导学面经模式。缺少关键信息时最多追问 3 个高信号问题；用户要求先出初稿时，允许用 `待补` 标注缺口。
16 
17| 字段 | 必须 | 说明 |
18| --- | --- | --- |
19| 项目源码 | 源码课程必需 | 本地仓库或当前工作区；只有项目描述时不能生成已核验的函数调用路线 |
20| 项目描述 | 导学面经必需 | 背景、目标、职责、难点、结果；越具体越好 |
21| 操作 | 源码课程必需 | 课程大纲、展开指定课程、配套练习，或用户明确要求的组合操作 |
22| 课程编号 | 展开或练习时必需 | 必须能在现有课程文件中定位 |
23| 简称 | 导学面经强烈建议 | 用于文件名 `导学-{简称}.md`、`面经-{简称}.md` |
24| 技术栈 | 否 | 语言、框架、中间件、观测、发布方式 |
25| 求职方向 | 否 | 前端、后端、AI、数据、产品或交叉方向 |
26 
27导学面经材料不足时，优先追问：
28 
291. 你在项目中的个人职责和协作边界是什么？
302. 项目最能展开的技术难点是什么，解决前后的现象如何验证？
313. 是否有指标、日志、PR、截图、上线记录或用户反馈可以作为证据？
32 
33可选脚本：
34 
35```bash
36python3 scripts/project_guide.py check --file description.txt --tech "React, TypeScript" --role "前端"
37python3 scripts/project_guide.py build-prompt --short-name "智能BI" --description "..." --tech "..." --role "..."
38```
39 
40## 源码课程模式
41 
42用户要求把仓库分课学习、展开指定课程或生成课程练习时进入该模式。未指定具体操作时，先生成课程大纲，不自动展开全部课程或创建练习。
43 
44本模式维护课程文件（文件名由 `tutorial` 和 `.md` 拼接）与练习文件（文件名由 `practice` 和 `.md` 拼接）。
45 
46### 课程大纲
47 
481. 读取[课程大纲规范](references/course-outline-design.md)；
492. 检查项目入口、主要功能、模块边界和代表性运行流程；
503. 在课程文件中生成课程大纲，每课给出真实文件与符号的阅读顺序；
51…