WwaitW Learner Profile — 仓库分析建档
通过分析用户的实际代码仓库，建立并维护准确的技术水平档案。
何时使用
- 首次初始化：用户想建立学习档案
- 完成项目后：更新档案以反映新掌握的技能
- 当
mentor-overlay报告"未找到档案"时
执行协议
第一步：收集仓库路径
询问用户：
"请提供你的仓库路径（每行一个），我将分析它们来了解你的技术背景。"
等待用户提供路径列表后继续。
第二步：逐一分析仓库
对每个仓库路径，依次检查：
1. 语言分布
- 统计各语言文件数量和代码行数
- 识别主要语言和次要语言
2. 框架/库使用深度
- 扫描 package.json / requirements.txt / go.mod / pom.xml 等依赖文件
- 区分：基础用法（只用简单 API）vs 高级用法（自定义插件、高级配置、性能优化）
- 示例判断：只用
useState+useEffect→ 初级 React；使用useMemo/useCallback/自定义 Hook → 中级
3. 代码质量指标
- 错误处理：是否有 try/catch、错误边界、自定义错误类
- 测试覆盖：测试文件数量；测试内容是否只有 happy path 还是覆盖失败场景
- 代码组织：是否有清晰的职责分层，还是所有逻辑堆在一个文件
- 注释质量：注释解释"为什么"而不只是"做什么"
4. 架构模式
- 是否有分层架构（controller/service/repository）
- 状态管理模式（Redux / Zustand / 无状态管理）
- API 设计风格（REST / GraphQL / RPC）
第三步：推断各技术水平
| 水平 | 判断标准 |
|---|---|
| 未涉及 | 未在任何仓库中出现 |
| 入门 | 仅有教程级别用法；无错误处理；无测试 |
| 初级 | 代码可运行；有基础错误处理；仅覆盖正常流程 |
| 中级 | 处理边界情况；有测试；理解"为什么"不只是"怎么做" |
| 高级 | 使用高级模式；关注性能；测试覆盖失败场景 |
| 专家 | 框架级理解；扩展或贡献过库 |
第四步：写入 global-profile.md
写入路径：~/.claude/learner-profile/global-profile.md
关键约束：更新已有条目，不追加重复行。文件保持 200 行以内。
格式：
# 用户技术档案
最后更新：YYYY-MM-DD
## 技术栈水平
| 技术/领域 | 水平 | 最近项目 | 更新时间 |
|-----------------|--------|------------------|-----------|
| React | 中级 | project-shop | 2026-05 |
| Node.js | 初级 | project-blog | 2026-03 |
| SQL | 入门 | project-blog | 2026-03 |
## 编程习惯观察
- 倾向于：[从仓库观察到的编码风格，如"函数式优先"、"喜欢提前 return"]
- 薄弱点：[反复出现的问题模式，如"错误处理不完整"、"测试覆盖不足"]
- 优势：[值得肯定的模式，如"命名清晰"、"逻辑分层合理"]
第五步：更新 knowledge-map.md
追加到 ~/.claude/learner-profile/knowledge-map.md：
## {project-name} — {YYYY-MM-DD}
- 路径：{repo-path}
- 主要技术：{技术1, 技术2, 技术3}
- 涵盖知识点：{概念1, 概念2, 概念3}
第六步：向用户汇报
汇报分析结果：
"档案已更新。 分析了 N 个仓库，识别到以下技术水平：
- React：中级（较上次提升）
- SQL：入门（新增）
全局档案：
~/.claude/learner-profile/global-profile.md知识索引：~/.claude/learner-profile/knowledge-map.md"