phase 6 part 2: per-week related-topics sections (gen_week_topics.py), week14/15/16 adjustments from BOSS research, README/CONTRIBUTING updates

This commit is contained in:
Shikui Wang committed 2026-10-23 17:00:50 +08:00
1 parent 5b1a7a430f
commit 4f12b8b2ba
22 files changed
+588 -18

No files matched your search

+70 -3
View File
@@ -13,7 +13,21 @@ order: 15
> 第四段的第 2 周。上周 `week14-backend-extend-deploy.md`,下周 `week16-interview.md`。
**本周目标**:把前 14 周的成果变成招聘方能快速看懂的材料:3 个公开仓库 + 1 份简历 + 3 条 STAR 工作经历 + 1 份口述稿(含演示视频)。
**本周目标**:把前 14 周的成果变成招聘方能快速看懂的材料:1~2 个重点展示的代表项目(共 3 个公开仓库)+ 1 份简历 + 3 条 STAR 工作经历 + 1 个“从问题到上线”的完整案例 + 1 个“AI 编程 + 验证方法”案例 + 1 份口述稿(含演示视频)。
**应聘材料清单(对照 BOSS直聘 2026-10-23 调研)**
调研中多个岗位在 JD 里直接写了应聘时要提供的材料:1~2 个代表项目(产品链接 / 仓库 / 截图 / 演示视频)、独立负责的范围、从问题定义到上线迭代的完整案例、AI 编程开发案例和质量控制方式,有的还要求提交 AI 会话记录;开源 / 技术博客加分(原始记录见 [research/boss-2026-10-23.md](../research/boss-2026-10-23.md))。本周的产出逐项对应:
| 招聘方要的 | 你交付的文件 | 怎么准备 |
| --- | --- | --- |
| 1~2 个代表项目(链接 / 仓库 / 截图 / 视频) | `career/portfolio.md` | 从 3 个仓库中选 1~2 个重点展示(建议 RAG 客服问答 + Agent 项目),每个给出:仓库地址、在线演示地址(没有就写本地一键启动命令)、3~5 张截图、1~3 分钟演示视频(第 1、6 天) |
| 独立负责的范围 | `career/portfolio.md` 每个项目的“我负责的部分” | 写清哪些是自己从零设计和实现的,哪些用了框架 / 开源组件;学习项目就如实写“独立完成” |
| 从问题定义到上线迭代的完整案例 | `career/cases/problem-to-launch.md` | 按“问题和指标 → 方案和取舍 → 实现 → 上线 / 部署 → 数据 → 下一轮改进”写;素材来自第 5~6 周 RAG 评测(召回率从基线到改进后的变化)或第 12~13 周 Agent 的崩溃恢复和评测;可以参考[跨技术栈场景](../scenarios/index.md)的结构 |
| AI 编程案例 + 质量控制方式 | `career/cases/ai-coding.md` + `career/session-logs/` | 选一个用 AI 编程工具完成的功能:需求和规则(AGENTS.md / rules / Skills)、AI 产出了什么、你发现并修正了什么、怎么验证(测试、故意破坏后测试失败、代码审查、真实环境验证);附**脱敏后**的会话记录。方法见 [AI 编程专题](../topics/ai/ai-coding/index.md) |
| 开源 / 技术博客(加分) | `career/portfolio.md` 的“文章”部分 | 可选:把 1~2 个踩坑经历写成文章(例如“SSE 流式输出经过 Nginx 被缓冲”“LangGraph 检查点续跑”) |
> 会话记录和截图在公开前必须脱敏:去掉公司名、内部地址、密钥、真实客户数据,提交前运行脱敏检查脚本(第 8 周第 2 天)。
**原则**
@@ -29,7 +43,12 @@ career/
├── resume-variants/ # 针对不同岗位微调的版本
├── star.md # 3 条 STAR 工作经历
├── pitch.md # 口述稿:3 分钟架构 + 1 分钟踩坑
├── portfolio.md # 作品清单:仓库地址、演示链接、视频
├── portfolio.md # 作品清单:1~2 个代表项目的仓库、演示链接、截图、视频、我负责的部分
├── cases/
│ ├── problem-to-launch.md # 从问题定义到上线迭代的完整案例
│ └── ai-coding.md # AI 编程案例:规则、产出、修正、验证方法
├── session-logs/ # 脱敏后的 AI 编程会话记录(配合 cases/ai-coding.md)
├── screenshots/ # 代表项目截图
├── jd/ # 收集的岗位描述(纯文本,一个岗位一个文件)
├── keyword_check.py # 简历和岗位描述的关键词对照
└── tests/test_keyword_check.py
@@ -70,6 +89,19 @@ docker compose up -d && open http://localhost:8100
### 要建的文件
- 3 个公开仓库:`task-board`(含 `web/board-vue` 前端)、`rag-qa`(含 `web/rag-react`)、`agent-mini`;`career/portfolio.md` 记录地址和演示链接
- `career/portfolio.md` 中选出 1~2 个代表项目(建议 `rag-qa` 和 `agent-mini`),每个写:一句话介绍、仓库地址、演示地址或一键启动命令、3~5 张截图(放 `career/screenshots/`)、演示视频链接、**我负责的部分**、可以被追问的技术点
- `career/cases/problem-to-launch.md`(模板见下)和 `career/cases/ai-coding.md`(第 6 天前完成)
```markdown
# 从问题到上线:<项目名>
1. 问题和目标:谁遇到了什么问题?用什么指标衡量(例如召回率@5、首 token 延迟、崩溃后能否续跑)?基线是多少?
2. 方案和取舍:考虑过哪几种方案,为什么选这个(引用 scenarios/ 中对应场景的取舍表)
3. 实现:我负责的模块、关键设计(2~3 条)
4. 上线 / 部署:怎么部署、怎么回滚、怎么监控
5. 结果:指标变化(只写自己测出来的数字,注明测试集和方法)
6. 下一轮迭代:发现了什么 Bad Case,怎么改的,改完的数据
```
### 运行方式
@@ -82,6 +114,7 @@ python3 ~/zhuangang/tools/check_sensitive.py && git commit -m "agent-mini 初始
### 完成标准
- 3 个仓库公开;每个 README 顶部有一句话介绍、动图或视频、快速开始;脱敏检查通过。
- `portfolio.md` 中 1~2 个代表项目的截图、视频、负责范围齐全;`problem-to-launch.md` 每一节都有内容。
---
@@ -369,10 +402,24 @@ python keyword_check.py jd/某公司.txt resume.md
### 要建的文件
- `career/pitch.md`(自我介绍 + 项目讲解),演示视频链接写进 `career/portfolio.md`
- `career/cases/ai-coding.md`:从第 1~14 周每周的 AI 编程练习中选 1 个最完整的功能,按下面的结构写,并把对应会话记录脱敏后放进 `career/session-logs/`
```markdown
# AI 编程案例:<功能名>
1. 任务:要实现什么,验收标准是什么
2. 给 AI 的上下文:AGENTS.md / rules / Skills 里写了什么约束(贴片段)
3. AI 的产出:生成了哪些文件;哪些直接可用
4. 我发现并修正的问题:例如边界条件遗漏、竞态、越权、测试是假的(断言为空)
5. 验证方法:单元 / 集成测试、故意破坏关键逻辑后测试变红、类型检查、代码审查、真实环境冒烟;贴命令和输出
6. 结论:AI 节省了哪些时间(如实描述),哪些部分必须自己把关
7. 会话记录:session-logs/<文件名>(已脱敏)
```
### 完成标准
- 自我介绍 ≤ 1 分钟、项目讲解 ≤ 4 分钟,各计时 3 遍;视频已录好。
- `cases/ai-coding.md` 的“验证方法”一节有可复现的命令和输出;会话记录已脱敏并通过检查脚本。
---
@@ -389,6 +436,9 @@ python keyword_check.py jd/某公司.txt resume.md
[ ] 项目经历每一行都是“做了什么 + 怎么做 + 结果”,数字都能找到出处
[ ] 工作经历已脱敏,没有公司内部名称、接口、数据
[ ] 仓库、演示链接都能打开(用手机和别人的电脑试一次)
[ ] 1~2 个代表项目都有截图和演示视频,写清“我负责的部分”
[ ] “从问题到上线”案例有问题、指标、取舍、上线和迭代数据
[ ] “AI 编程”案例写清验证方法,附脱敏后的会话记录
[ ] 简历 PDF 两页以内,没有错别字,联系方式正确
```
@@ -398,8 +448,25 @@ python keyword_check.py jd/某公司.txt resume.md
### 完成标准(阶段 4 上半验收)
- [ ] 3 个公开仓库 + 演示视频
- [ ] 3 个公开仓库 + 演示视频;其中 1~2 个代表项目有截图、视频和负责范围说明(`portfolio.md`)
- [ ] `cases/problem-to-launch.md`、`cases/ai-coding.md` 写完,`session-logs/` 已脱敏
- [ ] 简历(主版本 + 3 个岗位方向版本)
- [ ] 3 条 STAR、口述稿计时达标
- [ ] 至少 1 位他人审阅过并完成修改
- [ ] 在总纲进度表勾掉第 15 周
<!-- week-topics:start -->
## 本周相关专题
> 本节由 `tools/gen_week_topics.py` 根据专题文件的 `week` 字段自动生成,请勿手改;想调整就修改对应专题文件的 frontmatter 后重新生成。
| 技术栈 | 课程 / 场景 / 面试题 |
| --- | --- |
| [AI 编程工具与验证](../topics/ai/ai-coding/index.md) | 课程:[验证 AI 产出](../topics/ai/ai-coding/02-verify-evidence.md);场景:[团队引入 AI 编程](../topics/ai/ai-coding/scenarios/ai-assisted-feature.md);[面试题](../topics/ai/ai-coding/interview.md) |
| [CI/CD](../topics/devops/cicd/index.md) | 场景:[多语言仓库的流水线](../topics/devops/cicd/scenarios/multi-lang-pipeline.md) |
| [Git](../topics/devops/git/index.md) | 课程:[合并、变基和撤销](../topics/devops/git/02-merge-rebase-recovery.md);场景:[线上紧急修复和密钥误提交](../topics/devops/git/scenarios/hotfix-and-leaked-secret.md);[面试题](../topics/devops/git/interview.md) |
**跨技术栈场景**:[客服知识库问答](../scenarios/customer-service-kb.md)
<!-- week-topics:end -->