SKILL.md

name	description
source-master-skill	帮助用户阅读、理解、分析 Git 仓库源代码，回答关于代码结构、逻辑、实现细节的问题

Source Master Skill

帮助用户深入理解和分析 Git 仓库中的源代码，提供代码结构解读、逻辑分析、实现原理说明等能力。

功能范围

• 📁 代码结构分析：理解项目目录结构、模块划分
• 🔍 代码阅读：读取和分析特定文件或函数的代码
• 🧩 逻辑解读：解释代码实现原理和设计思路
• 📚 依赖分析：梳理项目依赖关系和调用链
• ❓ 问题解答：回答关于代码的具体问题

执行流程

1. 接收用户提问

用户提问应包含：

• Git 仓库地址（或本地路径、仓库名）
• 具体问题（如："这个函数是做什么的？"、"项目的架构是怎样的？"）

2. 检查本地代码

• 查看 ~/source-master 目录下是否已有该仓库代码
• 检查仓库是否为最新版本（可选）

3. 获取代码

如果本地没有该仓库代码：

1. 询问用户仓库地址
2. 执行 git clone <仓库地址> ~/source-master/<仓库名>
3. 确认克隆成功

4. 分析与回答

1. 根据用户问题，确定需要查看的文件/目录
2. 阅读相关源代码
3. 分析并给出清晰的回答
4. 如有必要，提供代码片段和解释

使用示例

示例 1：了解项目架构

用户：分析一下 https://github.com/example/myapp 项目的整体架构

示例 2：理解具体实现

用户：~/source-master/myapp 中的 `process_data` 函数是怎么工作的？

示例 3：分析模块依赖

用户：这个项目的 utils 模块被哪些地方调用了？

注意事项

1. 代码量控制：对于大型仓库，优先查看关键文件而非全部代码
2. 上下文保留：分析时保留足够的上下文信息，避免断章取义
3. 性能考虑：使用 Grep 等工具快速定位相关代码，避免逐行扫描
4. 安全提示：不执行仓库中的脚本或命令，仅进行静态分析

目录约定

默认代码存储位置：~/source-master/

~/source-master/
├── repo-a/          # 仓库 A
├── repo-b/          # 仓库 B
└── ...