【Skill 创作】我做了一个一键拆解开源 AI 项目大模型用法的分析 Skill:github-project-analyzer

1、Skill 简介

深度分析 GitHub 开源项目的大模型应用实现。当用户提供 GitHub 项目地址并要求拆解、分析、存档时使用此技能。此技能会克隆项目到本地,识别和提取所有提示词(Prompts)与工具(Tools),生成中文翻译文档和完整的项目 AI 应用分析报告。

适合所有需要快速理解一个陌生 AI 开源项目的开发者、研究员和技术管理者。

2、使用场景

我为什么想做它?

最近在研究一些 AI 开源项目的架构,比如 last30days-skill。这个项目有 400+ 个文件,提示词散布在 SKILL.md(1709 行)、Python 代码、YAML 配置里。为了搞清楚它到底怎么用的大模型,我手工做了一遍:

  1. grep 搜索关键词 → 找到几十个匹配
  2. 逐个文件阅读 → 理解上下文
  3. 手动翻译英文提示词 → 记录笔记
  4. 画流程图 → 梳理数据流
  5. 整理成文档 → 写分析报告

一个项目花了 2 个多小时。 如果有 5 个项目要研究呢?不敢想。

做出来之后能省掉的动作

传统手工流程 这个 Skill 自动完成
手动 grep 搜索关键词 4 类方法系统扫描,0 遗漏
逐文件阅读理解上下文 自动追踪导入链和调用链
手动翻译英文提示词 自动翻译 + 保留 JSON/Markdown 格式
手动画流程图 自动生成 Mermaid 彩色时序图
零散笔记整理 一份 7 节结构的完整中文报告

一条命令触发,2~5 分钟拿到报告。效率提升 20 倍以上


3、创作过程

灵感来源

这个 Skill 的创作始于 @comeonzhj 分享的 howPrompt——一个定义如何拆解开源项目、提取提示词的工作流程文档。howPrompt 里面有清晰的方法论(4 类搜索方法、4 阶段工作流),但它是一个「给人看的指南」,每次执行还需要手动操作。

我的想法是:把它变成一个 Skill,让 AI 自动执行这套工作流。

用 SOLO 把想法变成 Skill

核心创作过程分三步:

Step 1 — 用 SOLO 把 howPrompt 转化为 Skill 骨架

我把 howPrompt.md 的工作流提炼为 5 个顺序阶段,在 SOLO 里逐步敲定:

仔细阅读`howPrompt.md`工作流程,开发成一个 Skill。当用户提供一个 GitHub 项目地址,要求拆解并存档时使用这个技能。此技能将帮助 Agent 对项目进行分析拆解, 
第一步:下载项目
第二阶段:项目结构探索
第三阶段:提示词识别
第四阶段:文档化
第五阶段:分析报告
确保技能是自包含的。

SOLO 输出了第一版 SKILL.md,包含完整的阶段划分和工具指令。

Step 2 — 用真实项目验证和迭代

我直接用 last30days-skill 作为测试目标,在 SOLO 中让 Skill 跑了一趟完整流程。发现初始版本只有 4 个阶段(少了一个「探索结构」阶段),立即修复。同时发现翻译文档缺少「相关代码上下文」字段,也一并补上。


4、使用步骤

安装

将 Skill 安装到本地 Agent Skills 目录即可:

npx skills add Guan-Yep/open-source-llm-analyzer -g

或直接从 GitHub 克隆:

git clone https://github.com/Guan-Yep/open-source-llm-analyzer.git
# 然后移动到你的 skills 目录

触发方式

在 AI 对话框中输入以下任一方式即可触发:

  • 帮我分析一下 https://github.com/xxx/xxx
  • 拆解 https://github.com/xxx/xxx 项目的大模型用法
  • 提取 https://github.com/xxx/xxx 的所有提示词
  • 分析这个项目的 LLM 架构

输出

Skill 会在项目根目录下生成 ai_analysis/ 文件夹:

ai_analysis/
├── translated_prompts/          ← 所有提示词的中文翻译
│   ├── INDEX.md                ← 索引表
│   └── xxx_prompt_zh.md        ← 每个提示词的翻译文档
└── AI_MODEL_USAGE_ANALYSIS.md  ← 综合大模型应用分析报告

5、效果展示

测试案例:分析 last30days-skill

输入帮我分析一下 https://github.com/mvanhorn/last30days-skill

执行过程:Skill 在后台自动完成 →

  1. :white_check_mark: git clone 到本地
  2. :white_check_mark: 扫描 400+ 文件,识别 Python 为主语言
  3. :white_check_mark: 4 类方法全量扫描,发现 10 个提示词
  4. :white_check_mark: 生成 9 个中文翻译文档 + 索引
  5. :white_check_mark: 产出完整分析报告

完整输出目录可在 GitHub 查看ai_analysis/ 目录

报告核心亮点

报告 Mermaid 数据流图


提示词分类统计表

大模型应用场景分析

6、Skill 链接

资源 链接
:link: GitHub 仓库 https://github.com/Guan-Yep/open-source-llm-analyzer
:package: 直接安装 npx skills add Guan-Yep/open-source-llm-analyzer -g
:clipboard: 说明文档 README.md
:scroll: 许可证 MIT License

7、总结与思考

效率提升

以前分析一个开源 AI 项目的 LLM 用法,手工做需要 2~3 小时。有了这个 Skill,2~5 分钟拿到完整报告。效率不是提升了 50%,是提升了 20 倍以上。而且以前容易遗漏的提示词(尤其是嵌入在代码字符串里的),现在 4 类方法全量覆盖。

对 AI 工作方式的新感悟

做这个 Skill 的过程,让我对 AI 工具的理解有了一些变化:

Skill != 代码片段集合。 一个好的 Skill 不止是指令集合,更像一个「SOP文档」——它定义了该做什么(工作流)、怎么判断(规则)、怎么输出(模板)、边界情况怎么处理(降级策略)。

渐进式披露真的很重要。 刚开始我把所有细节都塞进 SKILL.md。拆成 SKILL.md(核心流程)+ references(详细参考)后,AI 的表现稳定了很多。这让我想到阅读也是类似的——先看概要,再按需深入。

目前最满意的地方

  • 4 类搜索方法覆盖全面,从文件名、变量名、API 特征到配置文件,几乎不可能遗漏提示词
  • Mermaid 时序图用彩色分区和自动编号,让人一眼看懂 LLM 在项目架构中的位置
  • 输出模板化——翻译文档、索引、分析报告都有统一模板,不同项目之间可对比

后续优化方向

  1. 增加增量分析模式:现在每次都是全量扫描,对于频繁更新的项目,支持只分析 diff 部分
  2. 支持更多报告语言:目前只用中文输出,后续支持英文报告

希望得到的反馈

  • 报告的结构和内容密度是否合适?太详细还是不够?
  • 有没有你觉得「如果能支持这个就更好了」的功能?

:folded_hands: 本项目基于 @comeonzhj 的 howPrompt 改造而来,感谢他提供的初始工作流灵感。

2 个赞