# Project Guide

中文项目导学、源码课程与项目面经技能：基于本地项目仓库、项目描述或技术材料，按需生成源码课程与理解题，或生成 导学-{简称}.md、面经-{简称}.md...

- Repository: https://github.com/Hisn00w/ASu-skills (6142 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Hisn00w/ASu-skills --skill project-guide -g -a claude-code -y`
Codex: `npx skills add Hisn00w/ASu-skills --skill project-guide -g -a codex -y`
Cursor: `npx skills add Hisn00w/ASu-skills --skill project-guide -g -a cursor -y`
Gemini CLI: `npx skills add Hisn00w/ASu-skills --skill project-guide -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Hisn00w/ASu-skills`

## Description

中文项目导学、源码课程与项目面经技能：基于本地项目仓库、项目描述或技术材料，按需生成源码课程与理解题，或生成 导学-{简称}.md、面经-{简称}.md 及交接摘要；当用户输入“/project-guide”、要求项目导学、源码课程、按调用链展开课程、课程练习、项目复盘、项目面经或 STAR 题库时使用。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# /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、截图、上线记录或用户反馈可以作为证据？

可选脚本：

```bash
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. 读取[课程大纲规范](references/course-outline-design.md)；
2. 检查项目入口、主要功能、模块边界和代表性运行流程；
3. 在课程文件中生成课程大纲，每课给出真实文件与符号的阅读顺序；
4. 记录源码版本、实际覆盖范围和尚未覆盖的模块。

### 展开指定课程

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

### 配套理解题

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

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

### 源码事实与局部更新

The rest: https://github.com/Hisn00w/ASu-skills/blob/HEAD/skills/project-guide/SKILL.md