learn-from-repo

npx skills add majiayu000/claude-skill-registry --skill learn-from-repo --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Learn From Repo & Paper 用于深度阅读研究型 repo 的完整方法论，核心是**代码-论文双向对应**，目标是理解到"可以修改"的程度。 --- ## 默认学习偏好（可按需调整） - **对话式推进**：不要一次输出所有内容，每个组件讲完后停下来，等用户确认或提问 - **零基础假设**：不跳过前置知识，包括引用论文中涉及的前序工作 - **Paper-Code 对应**：每个模块标注对应的论文章节/公式 - **穿插方法论**：在讲具体代码时，穿插"如何读 repo"的通用技巧 - **格式偏好**：表格、ASCII 图、代码块，结构清晰 - **代码定位**：讲解每个概念时，明确标注对应的文件路径和行号（如 `model.py:48-80`），让用户能直接跳转查看 - **每节结尾**：提示"下一步可以看什么"，引导对话继续 > 如有不同偏好，在激活 skill 时告知即可（如"不用对话式，直接给完整讲解"）。 --- ## Phase 0：激活前准备 在开始讲解前，先完成以下两项： ### 0a. 用 claude-paper:study 处理论文 如果用户提供了论文 PDF 或 arXiv 链接，先调用： /claude-paper:study <paper_url_or_path> 这会生成结构化学习材料，后续讲解可引用。 ### 0b. 快速扫描 repo 骨架 ```bash # 查看文件树（2层） find . -maxdepth 2 -not -path '*/.git/*' | sort | head -60 # 统计核心文件大小（找"重心"文件） wc -l **/*.py 2>/dev/null | sort -rn | head -20 # 看 git log，了解开发脉络 git log --oneline -20 ``` 目的：30秒内找到核心文件，不要盲目遍历。 --- ## Phase 1：四步阅读法（每个 Repo 通用） ``` Step 1: 看骨架（文件树） 问：核心文件是哪个？依赖什么外部库？ ↓ Step 2: 找入口（forward / main / __call__） 问：数据从哪里进来，从哪里出去？ ↓ Step 3: 识别核心数据结构 问：数据长什么样？有哪些字段？如何在模块间传递？ ↓ Step 4: 逐组件拆解 问：每个模块的输入、处理、输出是什么？对应论文哪里？ ``` 核心原则：先看"数据流"，再看"算法"。搞清楚数据格式，代码自然就懂了。 --- ## Phase 2：逐组件讲解模板 对每个核心组件，按以下结构讲解： 1. 动机（为什么需要这个组件？解决什么问题？） → 对应论文：Sec X.X / Figure X 2. 接口（输入输出是什么？） → 输入：shape

find . -maxdepth 2 -not -path '*/.git/*' | sort | head -60
wc -l **/*.py 2>/dev/null | sort -rn | head -20
git log --oneline -20